# Watchmode API Full LLM Context

> Expanded context for coding agents integrating with the Watchmode API.

OpenAPI document version: 3.0.3
API version: 1.1.8
Base API URL: https://api.watchmode.com/v1
Raw specs: https://api.watchmode.com/openapi.json and https://api.watchmode.com/openapi.yaml

## Integration Notes

- Use HTTPS and JSON.
- Send API keys with `X-API-Key: YOUR_API_KEY` or `Authorization: Bearer YOUR_API_KEY`.
- Avoid putting API keys in URLs unless maintaining a legacy integration.
- Check quota and rate-limit response headers such as `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-Account-Quota`, and `X-Account-Quota-Used`.
- Third-party image URLs are references only. Verify rights and source terms before storing, displaying, or redistributing images.
- For complete request parameters, response schemas, enum values, and examples, use the OpenAPI spec.

## Key Links

- [Interactive API docs](https://api.watchmode.com/docs)
- [OpenAPI JSON](https://api.watchmode.com/openapi.json)
- [OpenAPI YAML](https://api.watchmode.com/openapi.yaml)
- [Official TypeScript SDK](https://www.npmjs.com/package/@watchmode/api-client)
- [Request API key](https://api.watchmode.com/requestApiKey)
- [Terms and Conditions](https://api.watchmode.com/tc)
- [Title ID map](https://api.watchmode.com/datasets/title_id_map.csv)
- [Person ID map](https://api.watchmode.com/datasets/person_id_map.csv)

## Account

Account and quota information

- `GET /status` (getStatus): Get API quota status

## Configuration

Reference data for streaming sources, regions, networks, and genres

- `GET /sources` (getSources): List streaming sources
- `GET /regions` (getRegions): List supported regions
- `GET /networks` (getNetworks): List TV networks
- `GET /genres` (getGenres): List genres

## Search

Search for titles and people

- `GET /search` (search): Search for titles and people
- `GET /autocomplete-search` (autocompleteSearch): Autocomplete search

## Title

Get detailed information about movies and TV shows

- `GET /list-titles` (listTitles): List and filter titles
- `GET /title/{title_id}/details` (getTitleDetails): Get title details
- `GET /title/{title_id}/sources` (getTitleSources): Get title streaming sources
- `GET /title/{title_id}/seasons` (getTitleSeasons): Get title seasons
- `GET /title/{title_id}/episodes` (getTitleEpisodes): Get title episodes
- `GET /title/{title_id}/episodes/{episode_id}` (getTitleEpisode): Get a single episode
- `GET /title/{title_id}/cast-crew` (getTitleCastCrew): Get title cast and crew
- `GET /title/{title_id}/incorrect-data` (reportIncorrectData): Report incorrect title data

## Person

Get information about actors, directors, and other people

- `GET /person/{person_id}` (getPerson): Get person details

## Releases

Track new and upcoming streaming releases

- `GET /releases` (getReleases): Get Title Release Dates - Simple
- `GET /title-release-dates` (getTitleReleaseDatesAdvanced): Get Title Release Dates - Advanced

## Changes

Monitor changes to titles, sources, and metadata

- `GET /changes/new_titles` (getNewTitles): Get newly added titles
- `GET /changes/new_people` (getNewPeople): Get newly added people
- `GET /changes/titles_sources_changed` (getTitlesSourcesChanged): Get titles with changed sources
- `GET /changes/titles_details_changed` (getTitlesDetailsChanged): Get titles with changed details
- `GET /changes/titles_episodes_changed` (getTitlesEpisodesChanged): Get titles with changed episodes

## Live TV, Sports & Events (Beta)

Build TV guides, discover sports and awards events, and show people where to watch.
These endpoints are in beta. Contact us at https://api.watchmode.com/support to request access for your account.
Your API key works once access is enabled. Your current plan determines which features and dates you can use.

Free: a shared sample of up to 25 events, including their viewing options.
Startup: events from the past 7 days through the next 7 days in all supported countries.
Business and Enterprise: all available event dates, event downloads, and the US TV guide.
Check `/live-coverage` to see what your account can access. It costs no credits.
Beta access continues when you change plans. Shared RapidAPI accounts are not supported.

A channel is a specific station or channel version, such as an East Coast channel or a local ABC station.
A network is the brand that may have multiple channels. An airing is one scheduled showing of a program.
A source is a where-to-watch option, such as a streaming service, TV channel app, or event page.
A package is a service's subscription bundle or add-on.
Live `network_id` values belong to the Live dataset; do not join them to the catalog `/networks` directory.
Use the included network name, and use `channel_id` to join a broadcast to a guide channel when available.
Some event-only channels have no guide listings and therefore do not appear in `/live-channels`.

Live errors include `success: false`, `statusCode`, a machine-readable `code`, and a readable `statusMessage`.
Common codes include `LIVE_QUERY_INVALID`, `LIVE_REGION_UNSUPPORTED`, `LIVE_UNAUTHORIZED`,
`LIVE_NOT_FOUND`, and `LIVE_PLAN_REQUIRED`. Errors may also include more specific access or quota codes.
Handle the HTTP status and code; do not parse the wording of the message. Older catalog errors keep their existing format.

September 9, 2026 (UTC) beta update (spec 1.1.8): event search now includes league and team names; league totals,
clearer validation errors, and corrected viewing-option labels are available. The earlier prelaunch change
renamed channel/streaming fields to the names in this reference. Build against this published contract.
More fields and data may be added during beta; tolerate unknown response fields.

Listings and viewing options may be incomplete or outdated. An empty result does not prove that nothing
is airing or that an event cannot be watched. Viewing links may open a service homepage rather than a
player. Check the link type; location and subscription restrictions may apply.


- `GET /live-channels` (getLiveGuideChannels): List TV channels
- `GET /live-airings` (getLiveGuideAirings): Get TV listings
- `GET /live-coverage` (getLiveCoverage): Check your Live API access
- `GET /live-leagues` (getLiveLeagues): List sports leagues and award series
- `GET /live-teams` (getLiveTeams): List sports teams
- `GET /live-events` (getLiveEvents): Find sports and awards events
- `GET /live-event/{id}` (getLiveEvent): Get event details
- `GET /live-event/{id}/sources` (getLiveEventSources): Find where to watch an event
- `GET /live-schedule` (getLiveSchedule): Download events and where to watch them