gatsby-source-pocketapi

GatsbyJS plugin fetching data from Pocket API (a Mozilla project).

Compatibility

• v4.x - for Gatsby 4 and Gatsby 5

How to Use

1. npm install --save gatsby-source-pocketapi

2. Go to https://getpocket.com/developer/ and create a new app to get your consumer key.

3. Run node node_modules/node-getpocket/authorise --consumerkey 'YOUR-CONSUMER-KEY' and point your browser to http://127.0.0.1:8080 to get your POCKET_ACCESS_TOKEN string.

   For more info on this process see https://github.com/vicchi/node-getpocket, which this plugin uses to talk to the Pocket API.

4. In your gatsby-config.js

1module.exports = {
2  plugins: [
3    {
4      resolve: `gatsby-source-pocketapi`,
5      options: {
6        consumerKey: INSERT_HERE_YOUR_POCKET_CONSUMER_KEY,
7        accessToken: INSERT_HERE_YOUR_POCKET_ACCESS_TOKEN,
8        weeksOfHistory: 52,
9        apiMaxRecordsToReturn: 10000,
10        getCurrentWeekOnly: `n`,
11        stateFilterString: 'archive',
12        tagFilter: false,
13        tagFilterString: '_untagged_',
14        favouriteFilter: false,
15        favouriteFilterValue: 0,
16        searchFilter: false,
17        searchFilterString: 'These 21 things',
18        domainFilter: false,
19        domainFilterString: 'buzzfeed.com',
20      },
21    },
22  ],
23};

Plugin Options

• weeksOfHistory: Number of weeks worth of articles to fetch
• apiMaxRecordsToReturn: Number of records to return. If higher than 5000, the items will be fetched in several calls.
• getCurrentWeekOnly:
  • n will fetch data based on the settings above.
  • y returns the current week and the last week (it'll make sense when you try it).
• stateFilterString:
  • unread = only return unread items.
  • archive = only return archived items.
  • all = return both unread and archived items.
• tagFilter:
  • true will use the tagFilterString value to get articles with that tag.
  • false will ignore the tagFilterString value
• tagFilterString: If tagFilter is true then get articles tagged with this value. '\_untagged\_' will only return articles with no tags.
• favouriteFilter (note UK English spelling!):
  • true will use the favouriteFilterValue to get articles that have/have not been favourited in Pocket
  • false will ignore the favouriteFilterValue
• favouriteFilterValue:
  • 0 = only return un-favorited items
  • 1 = only return favorited items
• searchFilter:
  • true will use the searchFilterString value to get articles with that value in the URL or title.
  • false will ignore the searchFilterString value
• searchFilterString: If searchFilter is true then get articles with this value in the URL or title.
• domainFilter:
  • true will use the domainFilterString value to get articles for that domain.
  • false will ignore the domainFilterString value
• domainFilterString: If domainFilter is true then get articles from this domain.

How to query your Pocket articles data using GraphQL

Below is a sample query for fetching all Article nodes.

1query PageQuery {
2  allPocketArticle(sort: { fields: readWeek }) {
3    edges {
4      node {
5        id
6        url
7        title
8        favourite
9        excerpt
10        is_article
11        is_index
12        has_video
13        has_image
14        word_count
15        tags
16        time_read
17        readDay
18        readWeek
19        articleDomain
20        domainFavicon
21        image {
22          item_id
23          src
24          width
25          height
26        }
27      }
28    }
29  }
30}

Author

This plugin contains code or other contributions of the open source community. The original code was written by Conrad Jackson who maintained it since March 13, 2018 at https://github.com/conradj/gatsby-source-pocket. On February 5, 2023 the project has moved, with approval of Conrad, to https://github.com/Vacilando/gatsby-source-pocketapi where it continues to this day. Thank you again, @conradj, for your trust and a chance to steer the development of this plugin into the future.

Examples

An example site for this plugin is available:

• Demo
• Example site source code