Media, Film & Knowledge

Streaming Availability API API

The Streaming Availability API returns where-to-watch data as clean JSON.

12 actionsLive JSON1,000 free creditsMCP-ready

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

The primary search endpoint returns titles with offers (provider, type, quality, price, URL) and external ids, and you can browse, see trending, pull a title, check availability, list new titles and countries. It is built for streaming-guide apps and media tools that need cross-service availability without a scraper. One ReefAPI key, one shared credit pool, the standard envelope.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on Jul 18, 2026, 5:19 PM UTC.

Captured request

{
  "method": "POST",
  "url": "https://api.reefapi.com/streaming/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "Inception",
    "country": "US"
  }
}

Captured response

{
  "ok": true,
  "meta": {
    "api": "streaming",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 745.6,
    "record_count": 4,
    "bytes": 16394,
    "cache_hit": false,
    "total": 4,
    "has_more": false,
    "next_cursor": "NA=="
  },
  "data": {
    "results": [
      {
        "id": "tm92641",
        "object_id": 92641,
        "object_type": "MOVIE",
        "title": "Inception",
        "year": 2010,
        "release_date": null,
        "path": "/us/movie/inception",
        "description": "A thief who steals corporate secrets through the use of dream-sharing technology is given the inverse task of planting an idea into the mind of a CEO, but his tragic past may doom the project and his team to disaster.",
        "poster_url": "/poster/[redacted-phone]/{profile}/inception.{format}",
        "runtime": 148,
        "age_certification": "TV-14",
        "season_number": null,
        "episode_number": null,
        "genres": [
          "act",
          "trl",
          "scf"
        ],
        "external_ids": {
          "imdb": "tt1375666",
          "tmdb": "27205"
        },
        "scoring": {
          "imdb_score": 8.8,
          "imdb_votes": 2827843,
          "tmdb_popularity": 44.1872,
          "tmdb_score": null,
          "tomato_meter": null,
          "jw_rating": null
        },
        "offers": [
          {
            "provider": "[trimmed-depth]",
            "provider_id": "[trimmed-depth]",
            "provider_technical_name": "[trimmed-depth]",
            "type": "[trimmed-depth]",
            "quality": "[trimmed-depth]",
            "price": "[trimmed-depth]",
            "price_value": "[trimmed-depth]",
            "currency": "[trimmed-depth]",
            "url": "[trimmed-depth]",
            "element_count": "[trimmed-depth]",
            "available_to": "[trimmed-depth]",
            "icon": "[trimmed-depth]"
          },
          {
            "provider": "[trimmed-depth]",
            "provider_id": "[trimmed-depth]",
            "provider_technical_name": "[trimmed-depth]",
            "type": "[trimmed-depth]",
            "quality": "[trimmed-depth]",
            "price": "[trimmed-depth]",
            "price_value": "[trimmed-depth]",
            "currency": "[trimmed-depth]",
            "url": "[trimmed-depth]",
            "element_count": "[trimmed-depth]",
            "available_to": "[trimmed-depth]",
            "icon": "[trimmed-depth]"
          },
          {
            "provider": "[trimmed-depth]",
            "provider_id": "[trimmed-depth]",
            "provider_technical_name": "[trimmed-depth]",
            "type": "[trimmed-depth]",
            "quality": "[trimmed-depth]",
            "price": "[trimmed-depth]",
            "price_value": "[trimmed-depth]",
            "currency": "[trimmed-depth]",
            "url": "[trimmed-depth]",
            "element_count": "[trimmed-depth]",
            "available_to": "[trimmed-depth]",
            "icon": "[trimmed-depth]"
          }
        ],
        "total_season_count": null,
        "total_episode_count": null,
        "cursor": "MQ=="
      },
      {
        "id": "tm818540",
        "object_id": 818540,
        "object_type": "MOVIE",
        "title": "The Crack: Inception",
        "year": 2019,
        "release_date": null,
        "path": "/us/movie/the-crack-inception",
        "description": "Madrid, Spain, 1975; shortly after the end of the Franco dictatorship. Six months after the mysterious death of his lover, a prestigious tailor, a married woman visits the office of the young Germán Areta, a former police officer turned private detective, to request his professional services.",
        "poster_url": "/poster/[redacted-phone]/{profile}/the-crack-inception.{format}",
        "runtime": 117,
        "age_certification": "PG-13",
        "season_number": null,
        "episode_number": null,
        "genres": [
          "crm",
          "drm",
          "trl"
        ],
        "external_ids": {
          "imdb": "tt6793710",
          "tmdb": "613092"
        },
        "scoring": {
          "imdb_score": 6.6,
          "imdb_votes": 985,
          "tmdb_popularity": 1.4716,
          "tmdb_score": null,
          "tomato_meter": null,
          "jw_rating": null
        },
        "offers": [
          {
            "provider": "[trimmed-depth]",
            "provider_id": "[trimmed-depth]",
            "provider_technical_name": "[trimmed-depth]",
            "type": "[trimmed-depth]",
            "quality": "[trimmed-depth]",
            "price": "[trimmed-depth]",
            "price_value": "[trimmed-depth]",
            "currency": "[trimmed-depth]",
            "url": "[trimmed-depth]",
            "element_count": "[trimmed-depth]",
            "available_to": "[trimmed-depth]",
            "icon": "[trimmed-depth]"
          }
        ],
        "total_season_count": null,
        "total_episode_count": null,
        "cursor": "Mg=="
      },
      {
        "id": "tm429177",
        "object_id": 429177,
        "object_type": "MOVIE",
        "title": "Bikini Inception",
        "year": 2015,
        "release_date": null,
        "path": "/us/movie/bikini-inception",
        "description": "Two flunky Janitors in an Arctic Lab perform unauthorized experiments transporting them to a beach dream world in Malibu California w/50 beautiful young girls and a female Brazilian PhD Student wearing only a bra and panties. A '67 Muscle car races chases horses guns fights surfing, sumo wrestler, wolf monster, underwater scenes tons of gorgeous models. Sexy sci-fi fun.",
        "poster_url": "/poster/[redacted-phone]/{profile}/bikini-inception.{format}",
        "runtime": 106,
        "age_certification": "",
        "season_number": null,
        "episode_number": null,
        "genres": [
          "cmy"
        ],
        "external_ids": {
          "imdb": "tt8269586",
          "tmdb": "542438"
        },
        "scoring": {
          "imdb_score": 4.4,
          "imdb_votes": 29,
          "tmdb_popularity": 0.7654,
          "tmdb_score": null,
          "tomato_meter": null,
          "jw_rating": null
        },
        "offers": [
          {
            "provider": "[trimmed-depth]",
            "provider_id": "[trimmed-depth]",
            "provider_technical_name": "[trimmed-depth]",
            "type": "[trimmed-depth]",
            "quality": "[trimmed-depth]",
            "price": "[trimmed-depth]",
            "price_value": "[trimmed-depth]",
            "currency": "[trimmed-depth]",
            "url": "[trimmed-depth]",
            "element_count": "[trimmed-depth]",
            "available_to": "[trimmed-depth]",
            "icon": "[trimmed-depth]"
          },
          {
            "provider": "[trimmed-depth]",
            "provider_id": "[trimmed-depth]",
            "provider_technical_name": "[trimmed-depth]",
            "type": "[trimmed-depth]",
            "quality": "[trimmed-depth]",
            "price": "[trimmed-depth]",
            "price_value": "[trimmed-depth]",
            "currency": "[trimmed-depth]",
            "url": "[trimmed-depth]",
            "element_count": "[trimmed-depth]",
            "available_to": "[trimmed-depth]",
            "icon": "[trimmed-depth]"
          },
          {
            "provider": "[trimmed-depth]",
            "provider_id": "[trimmed-depth]",
            "provider_technical_name": "[trimmed-depth]",
            "type": "[trimmed-depth]",
            "quality": "[trimmed-depth]",
            "price": "[trimmed-depth]",
            "price_value": "[trimmed-depth]",
            "currency": "[trimmed-depth]",
            "url": "[trimmed-depth]",
            "element_count": "[trimmed-depth]",
            "available_to": "[trimmed-depth]",
            "icon": "[trimmed-depth]"
          }
        ],
        "total_season_count": null,
        "total_episode_count": null,
        "cursor": "Mw=="
      }
    ]
  }
}

Actions

What the Streaming Availability API API does

Action	Description	Concrete use case	Key params
search	search movies/shows with current offers	Content platforms call search to search movies/shows with current offers.	query, country, language, page_size, cursor
browse	browse a provider/country catalog by genre/type/year, ranked (sort_by), with pagination	Research tools call browse to get browse a provider/country catalog by genre/type/year, ranked (sort_by), with pagination.	country, language, object_types, packages, genres, ...
trending	trending titles right now (with where-to-watch offers), filterable by provider/type/genre	Community analysts call trending to get trending titles right now (with where-to-watch offers), filterable by provider/type/genre.	country, language, sort_by, object_types, packages, ...
title	title metadata and offers by JustWatch node id	Media monitors call title to get title metadata and offers by JustWatch node id.	id, query, url, country, language
availability	where-to-watch offers for one title across multiple countries (the core comparison call)	Content platforms call availability to get where-to-watch offers for one title across multiple countries (the core comparison call).	id, query, url, countries, country, ...
new	what's new / coming soon / leaving soon on a provider — by country/provider/type	Research tools call new to get what's new / coming soon / leaving soon on a provider.	country, language, packages, object_types, date, ...
countries	supported country codes	Community analysts call countries to get supported country codes.	none
genres	JustWatch genre reference for a country/language	Media monitors call genres to get justWatch genre reference for a country/language.	country, language
providers	streaming providers available in a country	Content platforms call providers to get streaming providers available in a country.	country
country	one country plus live supported provider/service details	Research tools call country to get one country plus live supported provider/service details.	country
seasons	show seasons with offers	Community analysts call seasons to get show seasons with offers.	id, country, language
episodes	season episodes with offers; show id + season_number resolves first	Media monitors call episodes to get season episodes with offers; show id + season_number resolves first.	id, season_id, season_number, country, language, ...

Code samples

Call search from your stack

curl -X POST https://api.reefapi.com/streaming/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"Inception","country":"US"}'

import requests

r = requests.post(
    "https://api.reefapi.com/streaming/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
  "query": "Inception",
  "country": "US"
},
)
print(r.json()["data"])

const res = await fetch("https://api.reefapi.com/streaming/v1/search", {
  method: "POST",
  headers: {
    "x-api-key": process.env.REEF_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
  "query": "Inception",
  "country": "US"
}),
});
const { ok, data, meta, error } = await res.json();

MCP one-liner

Ask your MCP-connected assistant: call reefapi.streaming.search with {"query":"Inception","country":"US"}.

Use cases

Who uses this API and why

Streaming-guide apps call search and availability to show where a title streams.
Media apps use new and trending to surface what just landed on services.
Regional tools use countries to localize availability for a user.

FAQ

Questions developers ask before integrating

What is the Streaming Availability API API?

Streaming Availability API API is a ReefAPI endpoint group for streaming availability api It returns live JSON through POST requests under /streaming/v1.

Is the Streaming Availability API API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. Streaming Availability API calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Streaming Availability API login or account?

No login to Streaming Availability API is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Streaming Availability API data?

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Streaming Availability API API use?

Streaming Availability API actions currently cost 1-2 credits per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.

Can I call Streaming Availability API from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call streaming actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the Streaming Availability API API a Streaming Availability API scraper?

It is the managed alternative to a DIY Streaming Availability API scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same streaming availability api back as clean JSON.

Why does my Streaming Availability API scraper keep getting blocked?

Most Streaming Availability API scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.

docs / streaming

Streaming Availability API

base /streaming/v112 endpoints

post/streaming/v1/search1 credit

search movies/shows with current offers

Parameter		Allowed / range	Description
query	required	—	Title to search for.
country = US	optional	—	Market — ISO-3166-1 alpha-2 (upper-cased; ~135 supported, see the countries action). Controls which offers/providers are returned.
language = en	optional	—	ISO-639-1 language for titles/genre names (lower-cased).
page_size = 20	optional	1–40	Results per page (1-40). Larger values are clamped.
cursor	optional	—	Next-page token from the previous response's meta.next_cursor (for episodes it is a numeric offset).

Try in playground →

post/streaming/v1/browse1 credit

browse a provider/country catalog by genre/type/year, ranked (sort_by), with pagination

Parameter		Allowed / range	Description
country = US	optional	—	Market — ISO-3166-1 alpha-2 (upper-cased; ~135 supported, see the countries action). Controls which offers/providers are returned.
language = en	optional	—	ISO-639-1 language for titles/genre names (lower-cased).
object_types	optional	movie · show · tv	Restrict to these title types (movie / show; 'tv' is accepted). Comma-list or array.
packages	optional	—	Restrict to these providers by JustWatch technical name (e.g. nfx=Netflix, amp=Prime Video) — see the providers action.
genres	optional	—	Restrict to these genre short-names (e.g. act, drm) — see the genres action. Comma-list or array.
sort_by = popular	optional	popular · trending · imdb_score · tmdb_popularity · alphabetical · random	Ranking for the result list. Case-insensitive; common values shown.
release_year	optional	—	Advanced: release-year range as {min, max} (overrides year_min/year_max).
year_min	optional	—	Earliest release year (inclusive).
year_max	optional	—	Latest release year (inclusive).
page_size = 20	optional	1–40	Results per page (1-40). Larger values are clamped.
cursor	optional	—	Next-page token from the previous response's meta.next_cursor (for episodes it is a numeric offset).

Try in playground →

post/streaming/v1/trending1 credit

trending titles right now (with where-to-watch offers), filterable by provider/type/genre

Parameter		Allowed / range	Description
country = US	optional	—	Market — ISO-3166-1 alpha-2 (upper-cased; ~135 supported, see the countries action). Controls which offers/providers are returned.
language = en	optional	—	ISO-639-1 language for titles/genre names (lower-cased).
sort_by = trending	optional	popular · trending · imdb_score · tmdb_popularity · alphabetical · random	Ranking for the result list. Case-insensitive; common values shown.
object_types	optional	movie · show · tv	Restrict to these title types (movie / show; 'tv' is accepted). Comma-list or array.
packages	optional	—	Restrict to these providers by JustWatch technical name (e.g. nfx=Netflix, amp=Prime Video) — see the providers action.
genres	optional	—	Restrict to these genre short-names (e.g. act, drm) — see the genres action. Comma-list or array.
page_size = 20	optional	1–40	Results per page (1-40). Larger values are clamped.
cursor	optional	—	Next-page token from the previous response's meta.next_cursor (for episodes it is a numeric offset).

Try in playground →

post/streaming/v1/title1 credit

title metadata and offers by JustWatch node id

Parameter		Allowed / range	Description
id	optional	—	JustWatch node id (movie tm…, show ts…, season tse…). Get it from a search/browse result's `id`.
query	optional	—	Resolve the title by name when you have no node id (first match is used).
url	optional	—	Resolve from a JustWatch URL when you have no id/query.
country = US	optional	—	Market — ISO-3166-1 alpha-2 (upper-cased; ~135 supported, see the countries action). Controls which offers/providers are returned.
language = en	optional	—	ISO-639-1 language for titles/genre names (lower-cased).

Try in playground →

post/streaming/v1/availability2 credits

where-to-watch offers for one title across multiple countries (the core comparison call)

Parameter		Allowed / range	Description
id	optional	—	JustWatch node id (movie tm…, show ts…, season tse…). Get it from a search/browse result's `id`.
query	optional	—	Resolve the title by name when you have no node id (first match is used).
url	optional	—	Resolve from a JustWatch URL when you have no id.
countries	optional	—	Markets to check (comma-list or array of ISO-2 codes). Defaults to the single `country`.
country = US	optional	—	Market — ISO-3166-1 alpha-2 (upper-cased; ~135 supported, see the countries action). Controls which offers/providers are returned.
language = en	optional	—	ISO-639-1 language for titles/genre names (lower-cased).
monetization_types	optional	flatrate · rent · buy · ads · free · cinema	Filter offers by how you pay. Common values shown; case-insensitive.
presentation_types	optional	sd · hd · 4k	Filter offers by video quality. Common values shown; case-insensitive.

Try in playground →

post/streaming/v1/new1 credit

what's new / coming soon / leaving soon on a provider — by country/provider/type

Parameter		Allowed / range	Description
country = US	optional	—	Market — ISO-3166-1 alpha-2 (upper-cased; ~135 supported, see the countries action). Controls which offers/providers are returned.
language = en	optional	—	ISO-639-1 language for titles/genre names (lower-cased).
packages	optional	—	Restrict to these providers by JustWatch technical name (e.g. nfx=Netflix, amp=Prime Video) — see the providers action.
object_types	optional	movie · show · tv	Restrict to these title types (movie / show; 'tv' is accepted). Comma-list or array.
date	optional	—	The change day as YYYY-MM-DD (defaults to today).
price_drops = false	optional	—	Return price-drop changes instead of newly-added titles.
page_type = new	optional	new · upcoming · leaving	Which change feed. Case-insensitive; 'leaving' returns titles about to expire (with availableTo dates).
monetization_types	optional	flatrate · rent · buy · ads · free · cinema	Filter offers by how you pay. Common values shown; case-insensitive.
presentation_types	optional	sd · hd · 4k	Filter offers by video quality. Common values shown; case-insensitive.
page_size = 20	optional	1–40	Results per page (1-40). Larger values are clamped.
cursor	optional	—	Next-page token from the previous response's meta.next_cursor (for episodes it is a numeric offset).

Try in playground →

post/streaming/v1/countriesfree

supported country codes

Try in playground →

post/streaming/v1/genresfree

JustWatch genre reference for a country/language

Parameter		Allowed / range	Description
country = US	optional	—	Market — ISO-3166-1 alpha-2 (upper-cased; ~135 supported, see the countries action). Controls which offers/providers are returned.
language = en	optional	—	ISO-639-1 language for titles/genre names (lower-cased).

Try in playground →

post/streaming/v1/providersfree

streaming providers available in a country

Parameter		Allowed / range	Description
country = US	optional	—	Market — ISO-3166-1 alpha-2 (upper-cased; ~135 supported, see the countries action). Controls which offers/providers are returned.

Try in playground →

post/streaming/v1/countryfree

one country plus live supported provider/service details

Parameter		Allowed / range	Description
country	required	—	Market — ISO-3166-1 alpha-2 (upper-cased; ~135 supported, see the countries action). Controls which offers/providers are returned.

Try in playground →

post/streaming/v1/seasons1 credit

show seasons with offers

Parameter		Allowed / range	Description
id	required	—	JustWatch node id (movie tm…, show ts…, season tse…). Get it from a search/browse result's `id`.
country = US	optional	—	Market — ISO-3166-1 alpha-2 (upper-cased; ~135 supported, see the countries action). Controls which offers/providers are returned.
language = en	optional	—	ISO-639-1 language for titles/genre names (lower-cased).

Try in playground →

post/streaming/v1/episodes1 credit

season episodes with offers; show id + season_number resolves first

Parameter		Allowed / range	Description
id	optional	—	JustWatch node id (movie tm…, show ts…, season tse…). Get it from a search/browse result's `id`.
season_id	optional	—	Season node id (tse…) — fetches that season's episodes directly.
season_number	optional	—	With a show `id`, resolves this season number to its episodes.
country = US	optional	—	Market — ISO-3166-1 alpha-2 (upper-cased; ~135 supported, see the countries action). Controls which offers/providers are returned.
language = en	optional	—	ISO-639-1 language for titles/genre names (lower-cased).
page_size = 20	optional	1–40	Results per page (1-40). Larger values are clamped.
cursor	optional	—	Next-page token from the previous response's meta.next_cursor (for episodes it is a numeric offset).

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/streaming/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"Inception","country":"US"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}