Watchmode

Watchmode provides streaming availability data, TV and movie metadata, and search capabilities across global platforms. The API returns real-time information on where content is available to watch, along with details on sources, regions, networks, genres, and individual titles.

Power end-to-end data operations for your Watchmode API with Nexla. Our bi-directional Watchmode connector is purpose-built for Watchmode, 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 Watchmode or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your Watchmode 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 Watchmode credential, you need a Watchmode API key. Watchmode uses API key authentication, with the key passed as the apiKey query parameter on every request.

To obtain your Watchmode API key, follow these steps:

1. Go to the Watchmode Request API Key page.

2. Complete the Request Free API Key form by entering an email address, creating a password, and selecting the countries whose streaming availability you need.

3. Agree to the Terms of Service and Privacy Policy, then submit the form to create your free account. The free plan includes a monthly request allowance.

4. After your account is created, sign in to your Watchmode account dashboard to locate your API key.

5. Copy your API key and store it securely. You will need it to configure your Nexla credential.

For detailed information about authentication, endpoints, request quotas, and available data, see the Watchmode API documentation.

Authenticate

Credentials required

Authenticate using your Watchmode API key. Obtain your key from the Watchmode dashboard.

Field	Required	Secret	Description
API Key	Yes	Yes	Your Watchmode API key for authentication
Base URL	Yes	No	The base URL for the Watchmode 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 Watchmode API key in the API Key field. This key is passed as the apiKey query parameter on every request to the Watchmode API and must be kept confidential.

4. Enter the Watchmode API base URL in the Base URL field. The default value is https://api.watchmode.com.

   If your API key is compromised, request a new key from your Watchmode account and update your Nexla credential. Your API key is tied to your monthly request allowance, so keep it confidential.

   For detailed information about authentication, endpoints, and available data, see the Watchmode API documentation.

5. 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 Watchmode connector tile, then select the credential that will be used to connect to the Watchmode API, and click Next; or, create a new Watchmode 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 Watchmode 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.

List Sources

Returns a list of all available content sources or streaming platforms.

Use this endpoint to retrieve the reference list of streaming platforms and content sources tracked by Watchmode. For detailed information about the response fields, see the Watchmode API documentation.

List Regions

Returns a list of all available regions for filtering content availability.

Use this endpoint to retrieve the reference list of regions that can be used to filter content availability. For detailed information about the response fields, see the Watchmode API documentation.

List Networks

Returns a list of all available television networks and streaming services.

Use this endpoint to retrieve the reference list of television networks and streaming services tracked by Watchmode. For detailed information about the response fields, see the Watchmode API documentation.

List Genres

Returns a list of all available content genres for filtering and categorization.

Use this endpoint to retrieve the reference list of content genres used for filtering and categorization. For detailed information about the response fields, see the Watchmode API documentation.

Search Titles

Searches for movies and TV shows by title, with optional filtering by genre, network, and region.

Use this endpoint to search the Watchmode catalog for movies and TV shows by title. Optional filters for genre, network, and region can be applied to narrow the results. For detailed information about the query parameters and response fields, see the Watchmode API documentation.

Autocomplete Search

Returns autocomplete suggestions for movie and TV show titles as the user types.

Use this endpoint to retrieve autocomplete suggestions for movie and TV show titles based on a partial search term. For detailed information about the query parameters and response fields, see the Watchmode API documentation.

List Titles

Returns a paginated list of all available movies and TV shows with filtering options.

Use this endpoint to retrieve a paginated list of all movies and TV shows in the Watchmode catalog, with optional filtering. For detailed information about the query parameters, pagination, and response fields, see the Watchmode API documentation.

List Releases

Returns a list of recent movie and TV show releases with availability information.

Use this endpoint to retrieve recent movie and TV show releases along with their availability information. For detailed information about the query parameters and response fields, see the Watchmode API documentation.

Get Title Details

Returns detailed metadata for a specific title (movie or TV show) by its Watchmode ID.

Use this endpoint to retrieve detailed metadata for a single movie or TV show identified by its Watchmode ID. For detailed information about the request parameters and response fields, see the Watchmode API documentation.

Get Title Sources

Returns streaming availability sources for a specific title, showing which platforms carry the content.

Use this endpoint to retrieve the streaming availability sources for a single title, showing which platforms carry the content. For detailed information about the request parameters and response fields, see the Watchmode API 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

Watchmode data sources can also be manually configured to ingest data from any valid Watchmode API endpoint, including endpoints not covered by the pre-built templates, 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 Watchmode 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.