Streaming Availability API

https://docs.movieofthenight.com
Admin
Streaming Availability API enables developers to query streaming availability of movies and series...
Tokens:22,934
Snippets:260
Trust Score:9.2
Update:4 months ago
Show doc for...
Tokens:
Raw
### Install cURL

Source: https://docs.movieofthenight.com/guide/quickstart

Check the installed version of cURL.

```bash
# cURL is most likely already installed on your machine
curl --version
```

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

### Get streaming availability for 'The Godfather' using cURL

Source: https://docs.movieofthenight.com/guide/quickstart

Send a GET request to the Shows endpoint to retrieve streaming availability information for 'The Godfather'. Two examples are provided: one for API keys obtained from developers.movieofthenight.com and another for RapidAPI.

```bash
# If you got your API key from https://developers.movieofthenight.com/
curl -G https://api.movieofthenight.com/v4/shows/tt0068646 \
	-H "X-API-Key: {YOUR_API_KEY}"
```

```bash
# If you got your API key from https://rapidapi.com/
curl -G https://streaming-availability.p.rapidapi.com/shows/tt0068646 \
	-H "X-RapidAPI-Key: {YOUR_API_KEY}"
```

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

### Request Examples

Source: https://docs.movieofthenight.com/resource/changes

Examples of GET requests to the /changes endpoint with different parameters.

```curl
GET
/changes
cURLGoTypeScriptJavaScript
```

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

### Response Example

Source: https://docs.movieofthenight.com/guide/pagination

Example response indicating more results are available and providing the next cursor.

```json
{
	"shows":  [
		...list of movies...
	],
	"hasMore": true,
	"nextCursor": "47196:A California Christmas: City Lights"
}
```

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

### Final Response Example

Source: https://docs.movieofthenight.com/guide/pagination

Example response indicating no more results are available.

```json
{
	"shows":  [
		...list of movies...
	],
	"hasMore": false
}
```

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

### Get Top Shows

Source: https://docs.movieofthenight.com/guide/shows

Example of getting the daily top 10 movies or series in a specific country and streaming service.

```bash
# If you got your API key from https://developers.movieofthenight.com/
curl -G https://api.movieofthenight.com/v4/shows/top \
	-H "X-API-Key: {YOUR_API_KEY}" \
	--data-urlencode country="us" \
	--data-urlencode service="netflix" \
	--data-urlencode show_type="series"

# If you got your API key from https://rapidapi.com/
curl -G https://streaming-availability.p.rapidapi.com/shows/top \
	-H "X-RapidAPI-Key: {YOUR_API_KEY}" \
	--data-urlencode country="us" \
	--data-urlencode service="netflix" \
	--data-urlencode show_type="series"
```

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

### Sample Streaming Options

Source: https://docs.movieofthenight.com/guide/shows

Example of streaming options data structure.

```json
{
  "type": "subscription",
  "link": "https://www.netflix.com/title/80234304/",
  "videoLink": "https://www.netflix.com/watch/80234304",
  "quality": "uhd",
  "audios": [],
  "subtitles": [],
  "expiresSoon": false,
  "availableSince": 1648574159
}
```

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

### Example Change Object

Source: https://docs.movieofthenight.com/resource/changes

An example of a 'new' movie change object, illustrating its properties.

```json
{
  "changeType": "new",
  "itemType": "show",
  "showId": "20924",
  "showType": "movie",
  "service": {
    "streamingOptionType": "buy",
    "timestamp": 1774645061,
    "link": "https://tv.apple.com/us/movie/the-little-vampire/umc.cmc.1wlgid90z8air6elggt6z7voi?playableId=tvs.sbd.9001%3A397616813"
  }
}
```

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

### First Request (cURL)

Source: https://docs.movieofthenight.com/guide/pagination

Example cURL request to fetch the first set of comedy movies on Netflix US.

```bash
# If you got your API key from https://developers.movieofthenight.com/
curl -G https://api.movieofthenight.com/v4/shows/search/filters \
	-H "X-API-Key: {YOUR_API_KEY}" \
	--data-urlencode country="us" \
	--data-urlencode catalogs="netflix" \
	--data-urlencode show_type="movie" \
	--data-urlencode genres="comedy"

# If you got your API key from https://rapidapi.com/
curl -G https://streaming-availability.p.rapidapi.com/shows/search/filters \
	-H "X-RapidAPI-Key: {YOUR_API_KEY}" \
	--data-urlencode country="us" \
	--data-urlencode catalogs="netflix" \
	--data-urlencode show_type="movie" \
	--data-urlencode genres="comedy"
```

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

### Get Changes

Source: https://docs.movieofthenight.com/guide/shows

Example of fetching the latest shows added to a specific streaming service, shows about to expire, or coming soon.

```bash
# If you got your API key from https://developers.movieofthenight.com/
curl -G https://api.movieofthenight.com/v4/changes \
	-H "X-API-Key: {YOUR_API_KEY}" \
	--data-urlencode country="us" \
	--data-urlencode change_type="new" \
	--data-urlencode item_type="show" \
	--data-urlencode catalogs="netflix"

# If you got your API key from https://rapidapi.com/
curl -G https://streaming-availability.p.rapidapi.com/changes \
	-H "X-RapidAPI-Key: {YOUR_API_KEY}" \
	--data-urlencode country="us" \
	--data-urlencode change_type="new" \
	--data-urlencode item_type="show" \
	--data-urlencode catalogs="netflix"
```

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

### Sample cURL Requests

Source: https://docs.movieofthenight.com/guide/authentication

Examples of how to authenticate requests using cURL, depending on whether the API key is obtained from the Developers Platform or RapidAPI.

```bash
# If you got your API key from https://developers.movieofthenight.com/
curl -G https://api.movieofthenight.com/v4/shows/tt0068646 \
	-H "X-API-Key: {YOUR_API_KEY}"

# If you got your API key from https://rapidapi.com/
curl -G https://streaming-availability.p.rapidapi.com/shows/tt0068646 \
	-H "X-RapidAPI-Key: {YOUR_API_KEY}"
```

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

### Get all Genres (English)

Source: https://docs.movieofthenight.com/resource/genres

Example cURL request to get all supported genres in English.

```bash
# If you got your API key from https://developers.movieofthenight.com/
curl -G https://api.movieofthenight.com/v4/genres \
	-H "X-API-Key: {YOUR_API_KEY}" \
	--data-urlencode output_language="en"

# If you got your API key from https://rapidapi.com/
curl -G https://streaming-availability.p.rapidapi.com/genres \
	-H "X-RapidAPI-Key: {YOUR_API_KEY}" \
	--data-urlencode output_language="en"
```

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

### Get all Countries - cURL Example

Source: https://docs.movieofthenight.com/resource/countries

Example cURL requests to fetch all supported countries and their associated streaming services. It shows how to authenticate using either a direct API key or a RapidAPI key.

```bash
# If you got your API key from https://developers.movieofthenight.com/
curl -G https://api.movieofthenight.com/v4/countries \
	-H "X-API-Key: {YOUR_API_KEY}"

# If you got your API key from https://rapidapi.com/
curl -G https://streaming-availability.p.rapidapi.com/countries \
	-H "X-RapidAPI-Key: {YOUR_API_KEY}"
```

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

### Get a Country - cURL Example

Source: https://docs.movieofthenight.com/resource/countries

Example cURL requests to fetch details for a specific country, including its supported streaming services. It demonstrates authentication methods similar to the 'Get all Countries' endpoint.

```bash
# If you got your API key from https://developers.movieofthenight.com/
curl -G https://api.movieofthenight.com/v4/countries/us \
	-H "X-API-Key: {YOUR_API_KEY}"

# If you got your API key from https://rapidapi.com/
curl -G https://streaming-availability.p.rapidapi.com/countries/us \
	-H "X-RapidAPI-Key: {YOUR_API_KEY}"
```

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

### API Key from RapidAPI

Source: https://docs.movieofthenight.com/resource/changes

Example request to the Changes API using an API key from RapidAPI.

```bash
curl -G https://streaming-availability.p.rapidapi.com/changes \
	-H "X-RapidAPI-Key: {YOUR_API_KEY}" \
	--data-urlencode country="us" \
	--data-urlencode catalogs="netflix" \
	--data-urlencode change_type="new" \
	--data-urlencode item_type="show" \
	--data-urlencode show_type="movie"
```

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

### Fetch show details in Spanish using cURL

Source: https://docs.movieofthenight.com/guide/localization

Example of fetching show details in Spanish using cURL, demonstrating the `output_language` parameter.

```bash
# If you got your API key from https://developers.movieofthenight.com/
curl -G https://api.movieofthenight.com/v4/shows/tt0068646 \
	-H "X-API-Key: {YOUR_API_KEY}" \
	--data-urlencode output_language="es"

# If you got your API key from https://rapidapi.com/
curl -G https://streaming-availability.p.rapidapi.com/shows/tt0068646 \
	-H "X-RapidAPI-Key: {YOUR_API_KEY}" \
	--data-urlencode output_language="es"
```

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

### Auto Pagination with TypeScript Client Library

Source: https://docs.movieofthenight.com/guide/pagination

Example of fetching paginated results using the TypeScript client library with auto-pagination enabled.

```typescript
import * as streamingAvailability from "streaming-availability";

const RAPID_API_KEY = "<YOUR_RAPID_API_KEY>";

// Fetch up to 10 pages of results.
// You can increase this number if you want to fetch more results,
// or set it to 0 to fetch all pages.
const PAGES_TO_FETCH = 10;

const client = new streamingAvailability.Client(new streamingAvailability.Configuration({
	apiKey: RAPID_API_KEY
}));

const movies = client.showsApi.searchShowsByFiltersWithAutoPagination({
	country: "us",
	catalogs: ["netflix"],
	genres: ["action"],
	showType: streamingAvailability.ShowType.Movie,
}, PAGES_TO_FETCH);

for await (const movie of movies) {
	// Do something with the movie
	// You can break the loop at any time if you don't want the rest of the pages
}
```

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

### Subsequent Request with Cursor (cURL)

Source: https://docs.movieofthenight.com/guide/pagination

Example cURL request to fetch the next set of movies using the 'nextCursor'.

```bash
# If you got your API key from https://developers.movieofthenight.com/
curl -G https://api.movieofthenight.com/v4/shows/search/filters \
	-H "X-API-Key: {YOUR_API_KEY}" \
	--data-urlencode country="us" \
	--data-urlencode catalogs="netflix" \
	--data-urlencode show_type="movie" \
	--data-urlencode genres="comedy" \
	--data-urlencode cursor="47196:A California Christmas: City Lights"

# If you got your API key from https://rapidapi.com/
curl -G https://streaming-availability.p.rapidapi.com/shows/search/filters \
	-H "X-RapidAPI-Key: {YOUR_API_KEY}" \
	--data-urlencode country="us" \
	--data-urlencode catalogs="netflix" \
	--data-urlencode show_type="movie" \
	--data-urlencode genres="comedy" \
	--data-urlencode cursor="47196:A California Christmas: City Lights"
```

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

### Search Shows by Filters

Source: https://docs.movieofthenight.com/guide/shows

Example of searching for shows with specific filters like genre, keyword, and year.

```bash
# If you got your API key from https://developers.movieofthenight.com/
curl -G https://api.movieofthenight.com/v4/shows/search/filters \
	-H "X-API-Key: {YOUR_API_KEY}" \
	--data-urlencode country="us" \
	--data-urlencode catalogs="netflix,hulu" \
	--data-urlencode show_type="movie" \
	--data-urlencode genres="action" \
	--data-urlencode keyword="zombie" \
	--data-urlencode year_min="2000" \
	--data-urlencode year_max="2009" \
	--data-urlencode order_by="rating"

# If you got your API key from https://rapidapi.com/
curl -G https://streaming-availability.p.rapidapi.com/shows/search/filters \
	-H "X-RapidAPI-Key: {YOUR_API_KEY}" \
	--data-urlencode country="us" \
	--data-urlencode catalogs="netflix,hulu" \
	--data-urlencode show_type="movie" \
	--data-urlencode genres="action" \
	--data-urlencode keyword="zombie" \
	--data-urlencode year_min="2000" \
	--data-urlencode year_max="2009" \
	--data-urlencode order_by="rating"
```

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

### Search Shows by Popularity

Source: https://docs.movieofthenight.com/guide/shows

Example of fetching the most popular shows in a country for the past week.

```bash
# If you got your API key from https://developers.movieofthenight.com/
curl -G https://api.movieofthenight.com/v4/shows/search/filters \
	-H "X-API-Key: {YOUR_API_KEY}" \
	--data-urlencode country="gb" \
	--data-urlencode order_by="popularity_1week"

# If you got your API key from https://rapidapi.com/
curl -G https://streaming-availability.p.rapidapi.com/shows/search/filters \
	-H "X-RapidAPI-Key: {YOUR_API_KEY}" \
	--data-urlencode country="gb" \
	--data-urlencode order_by="popularity_1week"
```

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

### API Key from movieofthenight.com

Source: https://docs.movieofthenight.com/resource/changes

Example request to the Changes API using an API key from movieofthenight.com.

```bash
curl -G https://api.movieofthenight.com/v4/changes \
	-H "X-API-Key: {YOUR_API_KEY}" \
	--data-urlencode country="us" \
	--data-urlencode catalogs="netflix" \
	--data-urlencode change_type="new" \
	--data-urlencode item_type="show" \
	--data-urlencode show_type="movie"
```

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

### Top Shows on Apple TV+ UK

Source: https://docs.movieofthenight.com/resource/shows

Example cURL request to get top shows on Apple TV+ in the UK.

```shell
# If you got your API key from https://developers.movieofthenight.com/
curl -G https://api.movieofthenight.com/v4/shows/top \
	-H "X-API-Key: {YOUR_API_KEY}" \
	--data-urlencode country="gb" \
	--data-urlencode service="apple_tv"

# If you got your API key from https://rapidapi.com/
curl -G https://streaming-availability.p.rapidapi.com/shows/top \
	-H "X-RapidAPI-Key: {YOUR_API_KEY}" \
	--data-urlencode country="gb" \
	--data-urlencode service="apple_tv"
```

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

### Example Genre Object

Source: https://docs.movieofthenight.com/resource/genres

An example of a genre object, showing its id and name properties.

```json
{
  "id": "action",
  "name": "Action"
}
```

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

### Search Shows by Title (cURL)

Source: https://docs.movieofthenight.com/resource/shows

Example cURL request to search for shows by their title.

```cURL
# If you got your API key from https://developers.movieofthenight.com/
curl -G https://api.movieofthenight.com/v4/shows/search/title \
	-H "X-API-Key: {YOUR_API_KEY}" \
	--data-urlencode title="Batman"

# If you got your API key from https://rapidapi.com/
curl -G https://streaming-availability.p.rapidapi.com/shows/search/title \
	-H "X-RapidAPI-Key: {YOUR_API_KEY}" \
	--data-urlencode title="Batman"
```

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

### Fetch shows available on Netflix in the US

Source: https://docs.movieofthenight.com/guide/shows

Example cURL request to fetch shows available on Netflix in the US. Demonstrates using the Search shows by filters endpoint.

```bash
# If you got your API key from https://developers.movieofthenight.com/
curl -G https://api.movieofthenight.com/v4/shows/search/filters \
	-H "X-API-Key: {YOUR_API_KEY}" \
	--data-urlencode country="us" \
	--data-urlencode catalogs="netflix"

# If you got your API key from https://rapidapi.com/
curl -G https://streaming-availability.p.rapidapi.com/shows/search/filters \
	-H "X-RapidAPI-Key: {YOUR_API_KEY}" \
	--data-urlencode country="us" \
	--data-urlencode catalogs="netflix"
```

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

### Fetch science fiction movies in the UK

Source: https://docs.movieofthenight.com/guide/shows

Example cURL request to fetch all science fiction movies available in the United Kingdom across all streaming services. Demonstrates filtering by country, show type, and genre.

```bash
# If you got your API key from https://developers.movieofthenight.com/
curl -G https://api.movieofthenight.com/v4/shows/search/filters \
	-H "X-API-Key: {YOUR_API_KEY}" \
	--data-urlencode country="gb" \
	--data-urlencode show_type="movie" \
	--data-urlencode genres="scifi"

# If you got your API key from https://rapidapi.com/
curl -G https://streaming-availability.p.rapidapi.com/shows/search/filters \
	-H "X-RapidAPI-Key: {YOUR_API_KEY}" \
	--data-urlencode country="gb" \
	--data-urlencode show_type="movie" \
	--data-urlencode genres="scifi"
```

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

### Fetch a show by IMDb ID with country-specific streaming availability

Source: https://docs.movieofthenight.com/guide/shows

This example demonstrates how to fetch show data, including streaming availability for a specific country (US), using its IMDb ID.

```cURL
# If you got your API key from https://developers.movieofthenight.com/
curl -G https://api.movieofthenight.com/v4/shows/tt0068646 \
	-H "X-API-Key: {YOUR_API_KEY}" \
	--data-urlencode country="us"

# If you got your API key from https://rapidapi.com/
curl -G https://streaming-availability.p.rapidapi.com/shows/tt0068646 \
	-H "X-RapidAPI-Key: {YOUR_API_KEY}" \
	--data-urlencode country="us"
```

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

### Search Shows by Filters (cURL)

Source: https://docs.movieofthenight.com/resource/shows

Example cURL request to search for shows based on filters like country, catalog, keyword, and show type.

```cURL
# If you got your API key from https://developers.movieofthenight.com/
curl -G https://api.movieofthenight.com/v4/shows/search/filters \
	-H "X-API-Key: {YOUR_API_KEY}" \
	--data-urlencode country="us" \
	--data-urlencode catalogs="netflix" \
	--data-urlencode keyword="zombie" \
	--data-urlencode show_type="movie"

# If you got your API key from https://rapidapi.com/
curl -G https://streaming-availability.p.rapidapi.com/shows/search/filters \
	-H "X-RapidAPI-Key: {YOUR_API_KEY}" \
	--data-urlencode country="us" \
	--data-urlencode catalogs="netflix" \
	--data-urlencode keyword="zombie" \
	--data-urlencode show_type="movie"
```

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

### Search for 'The Godfather' streaming availability in the US

Source: https://docs.movieofthenight.com/guide/shows

Example cURL request to find the streaming availability for a specific show title ('The Godfather') in a given country ('US'). Uses the Search shows by title endpoint.

```bash
# If you got your API key from https://developers.movieofthenight.com/
curl -G https://api.movieofthenight.com/v4/shows/search/title \
	-H "X-API-Key: {YOUR_API_KEY}" \
	--data-urlencode title="The Godfather" \
	--data-urlencode country="us"

# If you got your API key from https://rapidapi.com/
curl -G https://streaming-availability.p.rapidapi.com/shows/search/title \
	-H "X-RapidAPI-Key: {YOUR_API_KEY}" \
	--data-urlencode title="The Godfather" \
	--data-urlencode country="us"
```

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

### Shows API Endpoints

Source: https://docs.movieofthenight.com/resource/shows

List of available endpoints for retrieving and searching shows.

```bash
GET
/shows/{id}
GET
/shows/search/filters
GET
/shows/search/title
GET
/shows/top
```
Tokens:
Raw