### Get Title Release Dates - Simple - Request Sample

Source: https://api.watchmode.com/docs

Example cURL request to get recent or upcoming releases.

```Shell
curl -i -H 'X-API-Key: YOUR_API_KEY' 'https://api.watchmode.com/v1/releases/'
```

--------------------------------

### Get title episodes - Request Sample

Source: https://api.watchmode.com/docs

Example request to get episodes for a given title using cURL.

```shell
curl -i -H 'X-API-Key: YOUR_API_KEY' 'https://api.watchmode.com/v1/title/345534/episodes/'
```

--------------------------------

### Quick Start: TypeScript SDK Usage

Source: https://api.watchmode.com/docs

Demonstrates basic usage of the Watchmode TypeScript SDK for searching titles, getting details, and finding streaming sources.

```typescript
import { WatchmodeClient } from '@watchmode/api-client';

const client = new WatchmodeClient({ apiKey: 'YOUR_API_KEY' });

// Search for titles
const { data: results } = await client.search.byName({ searchValue: 'Breaking Bad' });

// Get title details
const { data: title } = await client.title.getDetails({ id: '3173903' });

// Get streaming sources
const { data: sources } = await client.title.getSources({ id: '3173903' });

```

--------------------------------

### Install Official TypeScript SDK

Source: https://api.watchmode.com/docs

Install the official Watchmode API client SDK using npm.

```bash
npm install @watchmode/api-client
```

--------------------------------

### Release Dates Request Sample

Source: https://api.watchmode.com/docs

Example request to get release dates for titles within a specified date range and regions.

```shell
curl -i -H 'X-API-Key: YOUR_API_KEY' 'https://api.watchmode.com/v1/title-release-dates/?start_date=20240101&end_date=20240331&regions=US,GB'
```

--------------------------------

### Get Title Release Dates - Simple - Response Sample

Source: https://api.watchmode.com/docs

Example JSON response for a simple release dates request.

```JSON
{
  "releases": [
    {
      "id": 3165490,
      "title": "Slow Horses",
      "type": "tv_series",
      "tmdb_id": 95480,
      "tmdb_type": "tv",
      "imdb_id": "tt5875444",
      "season_number": 1,
      "poster_url": "http://www.some-poster-site.com/image.jpg",
      "source_release_date": "2022-04-01",
      "source_id": 371,
      "source_name": "AppleTV+",
      "is_original": 1
}
]
}
```

--------------------------------

### Get title episodes - Response Sample

Source: https://api.watchmode.com/docs

Example JSON response for a successful request to get title episodes.

```json
[{
  "id": 1234567,
  "name": "Pilot",
  "episode_number": 1,
  "season_number": 1,
  "season_id": 12345,
  "tmdb_id": 54321,
  "imdb_id": "tt0959621",
  "thumbnail_url": "http://www.some-poster-site.com/image.jpg",
  "release_date": "2008-01-20",
  "runtime_minutes": 58,
  "overview": "Walter White, a high school chemistry teacher...",
  "sources": [
    {
      "source_id": 203,
      "name": "Netflix",
      "type": "sub",
      "region": "US",
      "web_url": "https://www.netflix.com/watch/123456"
}
]
}]
```

--------------------------------

### New People Request Sample

Source: https://api.watchmode.com/docs

Example request to get IDs of new people (actors, directors, etc.) added within a date range.

```shell
curl -i -H 'X-API-Key: YOUR_API_KEY' 'https://api.watchmode.com/v1/changes/new_people/'
```

--------------------------------

### Get title sources

Source: https://api.watchmode.com/docs

Example cURL command to retrieve streaming sources for a given title.

```Shell
curl -i -H 'X-API-Key: YOUR_API_KEY' 'https://api.watchmode.com/v1/title/345534/sources/'
```

--------------------------------

### Request Sample

Source: https://api.watchmode.com/docs

Example of how to request title details using curl.

```shell
curl -i -H 'X-API-Key: YOUR_API_KEY' 'https://api.watchmode.com/v1/title/345534/details/'
```

--------------------------------

### List Sources Request Sample

Source: https://api.watchmode.com/docs

Example cURL request to list available streaming sources.

```shell
curl -i -H 'X-API-Key: YOUR_API_KEY' 'https://api.watchmode.com/v1/sources/'
```

--------------------------------

### API Key in Header (Recommended)

Source: https://api.watchmode.com/docs

Example of how to include the API key in the X-API-Key header for requests.

```bash
curl -H 'X-API-Key: YOUR_API_KEY' 'https://api.watchmode.com/v1/status/'

```

--------------------------------

### Get title cast and crew - Request Sample

Source: https://api.watchmode.com/docs

Example request to get cast and crew for a given title using cURL.

```shell
curl -i -H 'X-API-Key: YOUR_API_KEY' 'https://api.watchmode.com/v1/title/345534/cast-crew/'
```

--------------------------------

### List TV Networks Request Sample

Source: https://api.watchmode.com/docs

Example cURL request to get a list of TV networks.

```shell
curl -i -H 'X-API-Key: YOUR_API_KEY' 'https://api.watchmode.com/v1/networks/'
```

--------------------------------

### API Key as Query Parameter (Backwards Compatibility)

Source: https://api.watchmode.com/docs

Example of using the apiKey query parameter, which is accepted for backwards compatibility but not recommended for new integrations.

```bash
curl 'https://api.watchmode.com/v1/status/?apiKey=YOUR_API_KEY'

```

--------------------------------

### Get Person Details - Response Sample

Source: https://api.watchmode.com/docs

Example JSON response for a person details request.

```JSON
{
  "id": 7110004,
  "full_name": "Brad Pitt",
  "first_name": "Brad",
  "last_name": "Pitt",
  "tmdb_id": 287,
  "imdb_id": "nm0000093",
  "main_profession": "actor",
  "secondary_profession": "producer",
  "tertiary_profession": "soundtrack",
  "date_of_birth": "1963-12-18",
  "date_of_death": null,
  "place_of_birth": "Shawnee, Oklahoma, USA",
  "gender": "m",
  "known_for": [
    1132806,
    1336708,
    1183315,
    1387087
],
  "relevance_percentile": 100
}
```

--------------------------------

### Get Person Details - Request Sample

Source: https://api.watchmode.com/docs

Example cURL request to retrieve details for a specific person.

```Shell
curl -i -H 'X-API-Key: YOUR_API_KEY' 'https://api.watchmode.com/v1/person/7110004'
```

--------------------------------

### Get API quota status - JSON Response Sample

Source: https://api.watchmode.com/docs

Example JSON response for a successful request to get API quota status.

```JSON
{
  "quota": 1000,
  "quotaUsed": 150
}
```

--------------------------------

### Get title cast and crew - Response Sample

Source: https://api.watchmode.com/docs

Example JSON response for a successful request to get title cast and crew.

```json
[
  {
    "person_id": 7110004,
    "type": "Cast",
    "full_name": "Bryan Cranston",
    "role": "Walter White",
    "episode_count": 62,
    "order": 1
},
  {
    "person_id": 7110005,
    "type": "Crew",
    "full_name": "Vince Gilligan",
    "role": "Creator",
    "episode_count": 62,
    "order": null
}
]
```

--------------------------------

### List Supported Regions Request Sample

Source: https://api.watchmode.com/docs

Example cURL request to retrieve a list of supported regions.

```shell
curl -i -H 'X-API-Key: YOUR_API_KEY' 'https://api.watchmode.com/v1/regions/'
```

--------------------------------

### Get titles with changed details - JSON Response Sample

Source: https://api.watchmode.com/docs

Example JSON response for a successful request to get titles with changed details.

```JSON
{
  "titles": [
    3171655,
    3127447,
    3146794
  ],
  "page": 1,
  "total_results": 14,
  "total_pages": 1
}
```

--------------------------------

### New Titles Request Sample

Source: https://api.watchmode.com/docs

Example request to get IDs of new movies and shows added within a date range, filtered by type.

```shell
curl -i -H 'X-API-Key: YOUR_API_KEY' 'https://api.watchmode.com/v1/changes/new_titles?types=movie,tv_series'
```

--------------------------------

### Get titles with changed sources - JSON Response Sample

Source: https://api.watchmode.com/docs

Example JSON response for a successful request to get titles with changed sources.

```JSON
{
  "titles": [
    12490,
    115801,
    144030
  ],
  "page": 1,
  "total_results": 488,
  "total_pages": 2
}
```

--------------------------------

### Get title seasons

Source: https://api.watchmode.com/docs

Example cURL command to retrieve all seasons for a TV series or mini-series.

```Shell
curl -i -H 'X-API-Key: YOUR_API_KEY' 'https://api.watchmode.com/v1/title/345534/seasons/'
```

--------------------------------

### Autocomplete search - Shell Request Sample

Source: https://api.watchmode.com/docs

Example of how to use the /autocomplete-search endpoint with cURL.

```Shell
curl -i -H 'X-API-Key: YOUR_API_KEY' 'https://api.watchmode.com/v1/autocomplete-search/?search_value=Breaking%20bad&search_type=1'
```

--------------------------------

### List Titles Request Sample

Source: https://api.watchmode.com/docs

Example cURL command to list titles based on source IDs.

```Shell
curl -i -H 'X-API-Key: YOUR_API_KEY' 'https://api.watchmode.com/v1/list-titles/?source_ids=203,57'
```

--------------------------------

### Get titles with changed episodes - JSON Response Sample

Source: https://api.watchmode.com/docs

Example JSON response for a successful request to get titles with changed episodes.

```JSON
{
  "titles": [
    3123402,
    3165766,
    3107530
  ],
  "page": 1,
  "total_results": 130,
  "total_pages": 1
}
```

--------------------------------

### Get titles with changed sources - Shell Request Sample

Source: https://api.watchmode.com/docs

Example request using curl to fetch a list of title IDs with changed sources.

```Shell
curl -i -H 'X-API-Key: YOUR_API_KEY' 'https://api.watchmode.com/v1/changes/titles_sources_changed?regions=US'
```

--------------------------------

### Get API quota status - Shell Request Sample

Source: https://api.watchmode.com/docs

Example request using curl to fetch the current API quota and usage status.

```Shell
curl -i -H 'X-API-Key: YOUR_API_KEY' 'https://api.watchmode.com/v1/status/'
```

--------------------------------

### List Genres Request Sample

Source: https://api.watchmode.com/docs

Example cURL request to fetch a mapping of genre names and IDs.

```shell
curl -i -H 'X-API-Key: YOUR_API_KEY' 'https://api.watchmode.com/v1/genres/'
```

--------------------------------

### Search for titles and people - Shell Request Sample

Source: https://api.watchmode.com/docs

Example of how to search for titles or people using the /search endpoint with cURL.

```Shell
curl -i -H 'X-API-Key: YOUR_API_KEY' 'https://api.watchmode.com/v1/search/?search_field=name&search_value=Ed%20Wood'
```

--------------------------------

### Get titles with changed details - Shell Request Sample

Source: https://api.watchmode.com/docs

Example request using curl to fetch a list of title IDs with changed details.

```Shell
curl -i -H 'X-API-Key: YOUR_API_KEY' 'https://api.watchmode.com/v1/changes/titles_details_changed'
```

--------------------------------

### Get titles with changed episodes - Shell Request Sample

Source: https://api.watchmode.com/docs

Example request using curl to fetch a list of title IDs with changed episodes.

```Shell
curl -i -H 'X-API-Key: YOUR_API_KEY' 'https://api.watchmode.com/v1/changes/titles_episodes_changed'
```

--------------------------------

### Autocomplete search - 200 Response Sample

Source: https://api.watchmode.com/docs

Example JSON response for a successful autocomplete search query.

```JSON
{
  "results": [
    {
      "name": "Breaking Bad",
      "relevance": 445.23,
      "type": "tv_series",
      "id": 3173903,
      "year": 2008,
      "result_type": "title",
      "imdb_id": "tt0903747",
      "tmdb_id": 1396,
      "tmdb_type": "tv",
      "image_url": "http://www.some-poster-site.com/image.jpg"
},
    {
      "name": "El Camino: A Breaking Bad Movie",
      "relevance": 169.83,
      "type": "movie",
      "id": 1586594,
      "year": 2019,
      "result_type": "title",
      "imdb_id": "tt9243946",
      "tmdb_id": 559969,
      "tmdb_type": "movie",
      "image_url": "http://www.some-poster-site.com/image.jpg"
}
]

}
```

--------------------------------

### Search for titles and people - 200 Response Sample

Source: https://api.watchmode.com/docs

Example JSON response for a successful search query.

```JSON
{
  "title_results": [
    {
      "id": 3173903,
      "name": "Breaking Bad",
      "type": "tv_series",
      "year": 2008,
      "imdb_id": "tt0903747",
      "tmdb_id": 1396,
      "tmdb_type": "tv"
}
],
  "people_results": [
    {
      "id": 710125611,
      "name": "Bryan Cranston",
      "main_profession": "actor",
      "imdb_id": "nm0186505",
      "tmdb_id": 17419
}
]

}
```

--------------------------------

### Report incorrect title data - Request Sample

Source: https://api.watchmode.com/docs

Example request to report incorrect title data using cURL, specifying missing source and details.

```shell
curl -i -H 'X-API-Key: YOUR_API_KEY' 'https://api.watchmode.com/v1/title/345534/incorrect-data/?sourceMissing=1&somethingWrongDetails=Missing%20Netflix'
```

--------------------------------

### Report incorrect title data - Response Sample

Source: https://api.watchmode.com/docs

Example JSON response for a successful request to report incorrect title data.

```json
{
  "success": true,
  "statusMessage": "Request to correct title information received. Please wait 2 minutes while we attempt to auto-correct the issue."

}
```

--------------------------------

### API Key in Header (Authorization Bearer)

Source: https://api.watchmode.com/docs

Alternative method to include the API key using the Authorization: Bearer header.

```bash
curl -H 'Authorization: Bearer YOUR_API_KEY' 'https://api.watchmode.com/v1/status/'

```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.