Watchmode API
The Watchmode API is a movie and TV show API with streaming availability for 436 services in 54 countries, plus live sports, TV listings, and awards data.…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
The Watchmode API is a movie and TV show API with streaming availability for 436 services in 54 countries, plus live sports, TV listings, and awards data.
What you can build with the Watchmode API
Common products built on the Watchmode API:
- Where-to-watch and universal search apps: Search by title name, IMDb ID, or TMDB ID (Search, Autocomplete), then show every subscription, rental, purchase, free, and TV-provider option per country with web links and iOS/Android deep links (Title sources).
- Discovery and recommendation features: Build lists like "horror movies on Netflix in the US" or "most popular shows on Disney+ this week" by filtering on service, country, genre, network, language, release date, ratings, people, or awards, sorted by popularity or relevance (List titles).
- Title pages and catalog metadata: Plot, runtime, release date, genres, user and critic ratings, content ratings, poster and backdrop art, trailers, similar titles, networks, cast and crew, and awards in one request (Title details, Cast and crew, People).
- TV apps with episode-level availability: Seasons, episodes, and the services and links for each specific episode (Episodes).
- Connected-TV and mobile apps: Deep links for iOS, Android, Apple TV/tvOS, Android TV, and Roku so viewers land in the streaming app rather than a website. TV links are included on all paid plans.
- Release calendars and "leaving soon" features: Upcoming and recent streaming premieres with release times where known, and the dates titles leave each service (Release dates, Leaving dates).
- Live sports, events, and TV guides: Find games and award ceremonies by date, league, or team with where-to-watch links and app deep links in the US, UK, Canada, and Australia, plus US channel listings for TV guide apps (Live events, TV listings).
- Awards databases: Oscars, Primetime Emmys, Golden Globes, BAFTA, SAG, DGA, WGA, and PGA wins and nominations by title, person, edition, and category (Awards).
- Catalog sync, analytics, and research: Daily feeds of new titles, new people, and changed sources, details, and episodes keep your database current (Changes). CSV ID maps link Watchmode IDs to IMDb and TMDB IDs (ID mapping).
Watchmode does not host or stream video. It returns availability, metadata, and links for services including Netflix, Prime Video, Disney+, Hulu, HBO Max, Apple TV+, Peacock, and Paramount+.
Getting started
Get an API key, search for a title, and retrieve its details and streaming availability. Review credits and request limits before integrating.
Access badges appear beside endpoint names in the reference and navigation:
- Paid plan: Startup, Business, or Enterprise.
- Business+: Business or Enterprise.
- Free sample: Free accounts receive limited sample data; eligible paid plans receive broader access.
Credit costs are listed separately and still apply to sample requests.
Already have IMDb or TMDB IDs? Use the ID mapping files to match your existing catalog to Watchmode IDs.
API key
All API requests require an API key. We recommend sending it in a request header so the key is not exposed in URLs, browser history, analytics, referrer headers, or web server logs.
Recommended:
curl -H 'X-API-Key: YOUR_API_KEY' 'https://api.watchmode.com/v1/status/'Also supported:
curl -H 'Authorization: Bearer YOUR_API_KEY' 'https://api.watchmode.com/v1/status/'For backwards compatibility, the apiKey query parameter is still accepted, but new integrations should prefer headers:
curl 'https://api.watchmode.com/v1/status/?apiKey=YOUR_API_KEY'Get your free API key at https://api.watchmode.com/requestApiKey/
Official TypeScript SDK
The SDK examples below support version 3 and later (Node.js 22+). Install the latest published version:
npm install @watchmode/api-clientQuick Start:
import { WatchmodeClient } from '@watchmode/api-client';
const client = new WatchmodeClient({ apiKey: 'YOUR_API_KEY' });
// Search for titles
const { data: results } = await client.search.byName('Breaking Bad');
// Get title details
const { data: title } = await client.title.getDetails(3173903);
// Get streaming sources
const { data: sources } = await client.title.getSources(3173903);Examples use top-level await in ES modules. Catch rejected requests in your application;unwrap() also throws for HTTP…
Endpoints 40
Search
- GETSearch for titles and people
/search?search_field=name&search_value=Breaking BadCosts 1 credit. Search for titles or people using an external ID (IMDB, TMDB) or by name. Returns matching titles and people with their Watchmode IDs. Useful… - GETAutocomplete search
/autocomplete-search?search_value=Breaking badCosts 1 credit. Search for titles and/or people by name or partial name. Optimized for building autocomplete/typeahead search interfaces. Results include…
Title
- GETGet title details
/title/:title_id/detailsCredits: 1 with a Watchmode ID or 2 with an IMDb/TMDB ID, plus 1 per distinct appended dataset. Get a movie or TV show's metadata, ratings, artwork, and… - GETGet title streaming sources
/title/:title_id/sourcesGet all streaming sources where a title is currently available. Returns subscription services, rental options, purchase options, and free streaming. For TV… - GETList and filter titles
/list-titlesCredits: 1 per requested region per page; 1 when regions are omitted. Find movies and TV shows by streaming service, country, genre, release date, ratings,… - GETGet title seasons
/title/:title_id/seasonsGet all seasons for a TV series or mini-series. - GETGet title episodes
/title/:title_id/episodesGet episodes for a TV series or mini-series, including streaming sources for each episode. For paid plans, includes deep links to watch each episode on… - GETGet a single episode
/title/:title_id/episodes/:episode_idGet one episode by its Watchmode episode ID. Streaming sources are included by default. Use episode_language for localized episode metadata and… - GETGet title cast and crew
/title/:title_id/cast-crewGet all cast (actors) and crew (directors, writers, etc.) associated with a title. - GETReport incorrect title data
/title/:title_id/incorrect-dataReport incorrect or missing data for a title. This endpoint helps improve data quality by allowing users to flag issues with title information. Note: This…
Live TV, Sports & Events
- GETCheck your Live API access
/live-coverageCredits: 0, including after your monthly allowance is used; normal request-rate limits apply. Check which Live countries, leagues, event dates, and TV… - GETFind sports and awards events
/live-eventsCredits: 1/page; 2 with provider or availability filters. Including sources costs 1 + 1/event (1 for an empty page), with no extra filter charge. Find sports… - GETGet event details
/live-event/:idCredits: 1 per successful request. Get an event's name, league, teams, start time, status, venue, and TV broadcasts. Use /live-event/{id}/sources for viewing… - GETFind where to watch an event
/live-event/:id/sourcesCredits: 2 per requested country. Find services, event links, and mobile deep links for watching an event in one or more countries. Free accounts can request… - GETList TV channels
/live-channelsCredits: 1 per successful request. List US TV channels with stored guide listings, available dates, and a summary of the next 48 hours. Use their IDs with… - GETGet TV listings
/live-airingsCredits: 1 per successful page, including repeated and empty pages. Get scheduled US TV listings for up to 48 hours, including programs that started earlier… - GETList sports leagues and award programs
/live-leaguesCredits: 1 per request. List sports leagues and award programs available to your account. Use their IDs to filter events; a league can represent a tour,… - GETList sports teams
/live-teamsCredits: 1 per page. Find sports teams by league or name. Results are limited to leagues available to your account. Use the returned IDs to filter events. - GETDownload events and where to watch them
/live-scheduleCredits: 10 per successful page, including repeated and empty pages. Download events and viewing options for one country and up to seven days. Pages remain…
Configuration
- GETList streaming sources
/sourcesCosts 1 credit. Returns a list of all streaming sources (streaming services, networks, etc.) supported by Watchmode. This includes subscription services (like… - GETList supported regions
/regionsReturns a list of all countries/regions that Watchmode supports, including data quality tier and plan availability. Costs 1 credit. - GETList TV networks
/networksReturns a list of all TV networks that may be associated with titles. Costs 1 credit. - GETList genres
/genresReturns a mapping of genre names and IDs. Some genres include corresponding TMDB IDs. Costs 1 credit.
Person
- GETGet person details
/person/:person_idCredits: 1 per request, plus 1 when appending awards. Get a person's biography, professions, and known titles. Use append_to_response=awards to include their…
Awards
- GETList awards
/awardsCredits: 1 per successful request. List award programs and their permanent IDs for use in award filters. Available to eligible Free, active demo, and paid… - GETGet Free awards sample
/awards/sampleCredits: 1 per successful request. Discover the fixed 25 titles and 10 people whose award histories are available to all Free accounts and active demos.… - GETGet title awards and nominations
/title/:title_id/awardsCredits: 1 per successful page, including IMDb/TMDB alias resolution. Get a movie or TV series' awards and nominations. Filter by award program, edition,… - GETGet person awards and nominations
/person/:person_id/awardsCredits: 1 per successful page. Get a person's awards and nominations, including episode-specific credits. Filter by award program, edition, category, or… - GETList award results
/award/:award_id/resultsCredits: 1 per successful page. Browse an award program's winners and nominations without a title or person ID. Filter by edition, category, or result.… - GETList award editions
/award/:award_id/editionsCredits: 1 per successful request. List an award program's annual editions, with stable IDs, names, and source year ranges. Available to eligible Free, active… - GETList award categories
/award/:award_id/categoriesCredits: 1 per successful request. List an award program's historical categories and stable IDs. Optionally filter by edition. Available to eligible Free,…
Releases
- GETGet Title Release Dates - Simple
/releasesCosts 1 credit per page. Get recently released or upcoming releases on major streaming services. Includes original content flags to identify platform… - GETGet Title Release Dates - Advanced
/title-release-datesCredits: 1 per request; release-time fields add no credits. Find historical and upcoming streaming premieres and theatrical releases by date and country.… - GETTitles leaving streaming sources
/title-leaving-datesCredits: 1 per successful page. Find known dates when movies and TV seasons leave streaming services. Filter by country and date, then retrieve every page of…
Changes
- GETGet titles with changed sources
/changes/titles_sources_changedCredits: 1 per page. Get IDs of titles whose streaming availability changed during a date range. Use these IDs to refresh sources in your catalog. A title… - GETGet titles with changed details
/changes/titles_details_changedCredits: 1 per page. Get IDs of titles whose metadata changed, including overviews, cast, genres, and ratings. Details changes are global; use… - GETGet titles with changed episodes
/changes/titles_episodes_changedCredits: 1 per successful page. Get title IDs where episode data has changed (new episodes, updated details) within a date range. - GETGet newly added titles
/changes/new_titlesCredits: 1 per successful page. Get title IDs of new movies and shows added to Watchmode within a date range. Useful for keeping your database in sync with… - GETGet newly added people
/changes/new_peopleCredits: 1 per successful page. Get IDs of new people (actors, directors, etc.) added to Watchmode within a date range.
Account
- GETGet API quota status
/statusReturns your current API quota and usage for the month. Costs 0 credits.
API details
- Base URL
https://api.watchmode.com/v1- Authentication
- An API key in the X-API-Key header
A bearer token in the Authorization header
An API key in the apiKey query parameter - Operations
- 40 operations on 40 pathsGET 40
- Main resources
- Live TV, Sports & Events 9Title 8Awards 7Changes 5Configuration 4Releases 3Search 2Account 1Person 1
- Response formats
application/json- Description format
- OpenAPI 3.0.3, API version
1.10.1 - Links
- OpenAPI document · Support
- Listed from
- Watchmode's published OpenAPI description
How to test the Watchmode API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Watchmode API collection, without the publisher's secrets.
- Add your credentialsThis API uses an API key in the X-API-Key header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Search for titles and people” (GET /search?search_field=name&search_value=Breaking Bad), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Watchmode API?
The Watchmode API is a movie and TV show API with streaming availability for 436 services in 54 countries, plus live sports, TV listings, and awards data.… It is listed under Media & content and has 40 endpoints.
Who publishes the Watchmode API?
It is listed from Watchmode's public API description (an OpenAPI document), not published by Watchmode on Swastik Codes. Anyone who controls watchmode.com can claim the profile by adding a DNS TXT record.
What is the base URL of the Watchmode API?
Requests go to https://api.watchmode.com/v1. Endpoint paths are added to this base URL.
How do I authenticate with the Watchmode API?
It accepts 3 methods: an API key in the X-API-Key header; A bearer token in the Authorization header; an API key in the apiKey query parameter.
How many endpoints does the Watchmode API have?
40 operations on 40 paths (40 GET). The largest groups are Live TV, Sports & Events, Title, Awards, Changes.
Is forking the Watchmode API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.