Pocket

Pocket (formerly Read It Later) is a save-for-later reading service that lets users save, tag, and retrieve articles and web pages across devices. The Pocket API v3 exposes a user's saved list so that items can be programmatically retrieved for downstream analysis and archiving.

Power end-to-end data operations for your Pocket API with Nexla. Our bi-directional Pocket connector is purpose-built for Pocket, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to Pocket or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your Pocket workflows fast, secure, and fully governed.

Features

Type: API

SourceDestination

• Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
• Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
• API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
• Request optimization with intelligent batching, retry, and caching to minimize API calls and costs

Prerequisites

Before creating a Pocket credential, you need an API key that Nexla will send in the Authorization header as a bearer token when calling the Pocket API. Pocket authenticates requests using a consumer key registered to your application together with a user-specific access token obtained through Pocket's OAuth flow.

To obtain the credentials needed for Pocket API access, follow these general steps:

1. Register your application on the Pocket Developer Program to obtain a consumer key. The consumer key is displayed on the My Applications page after registration.

2. Complete the Pocket OAuth flow to obtain a user access token for the Pocket account whose saved items you want to retrieve. This involves requesting a temporary request token, having the user authorize your application, and exchanging the request token for an access token, as described in the Pocket Authentication documentation.

3. Provide the resulting token value to Nexla as the API Key. Nexla sends this value in the Authorization: Bearer header when making requests to the Pocket API.

Keep your token confidential. If it is compromised, revoke access for the application from your Pocket account and generate a new token. For detailed information about authentication and the retrieve endpoint, refer to the Pocket Developer Documentation.

Authenticate

Credentials required

Field	Required	Secret	Description
API Key	Yes	Yes	API key used to authenticate requests to the Pocket API.

Create a credential in Nexla

1. After selecting the data source type, click the Add Credential tile to open the Add New Credential overlay.

2. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

3. Enter your token value in the API Key field. This value is sent in the Authorization header as a bearer token for all requests to the Pocket API and must be kept confidential.

   If your API key is compromised, revoke access for the application from your Pocket account and generate a new token. The API key grants access to your saved Pocket items and should be treated as sensitive information.

   For detailed information about Pocket authentication and available data, see the Pocket Developer Documentation.

4. Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source creation.

Use as a data source

To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the Pocket connector tile, then select the credential that will be used to connect to Pocket, and click Next; or, create a new Pocket credential for use in this flow.

Endpoint templates

Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common Pocket endpoints. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below.

[Rest API] List Retrieve

This endpoint template retrieves the list of saved items from the Pocket retrieve API (/v3/get). Use this template when you need to ingest a user's saved articles and web pages for analysis, reporting, or archiving purposes.

• This endpoint reads from the authenticated user's saved list and returns items as JSON. The endpoint is paginated, and Nexla automatically requests subsequent pages until no further data is returned.

This endpoint returns saved item information from the user's Pocket account, including item identifiers, URLs, titles, and associated metadata. Nexla reads the response items from the $.data[*] path and follows pagination to fetch subsequent pages of data.

For detailed information about the retrieve endpoint, request parameters, and available item data, see the Pocket Developer Documentation.

Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.

Manual configuration

Pocket data sources can also be manually configured to ingest data from any valid Pocket API endpoint, including endpoints not covered by the pre-built template, chained API calls, or custom request parameters. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers.

Once all of the relevant settings have been configured, click the Create button in the upper right corner of the screen to save and create the new Pocket data source. Nexla will now begin ingesting data from the configured endpoint and will organize any data that it finds into one or more Nexsets.