docs / streaming

Streaming Availability API

base /streaming/v111 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 by country/provider/genre/type/year 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.
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/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

offers for one title across multiple countries

Parameter		Allowed / range	Description
id	required	—	JustWatch node id (movie tm…, show ts…, season tse…). Get it from a search/browse result's `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

recently added titles 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 (upper-cased for JustWatch). Common values shown; case-insensitive.
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
}