# 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.7
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}/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