docs / movies-tv
Movies & TV
Film and series details, cast and ratings.
base /movies-tv/v113 endpoints
post
/movies-tv/v1/search1 creditsearch titles (type=multi|movie|tv|streaming)
| Parameter | Required |
|---|---|
| query | required |
| type | optional |
| limit | optional |
| year | optional |
| country | optional |
| page | optional |
post
/movies-tv/v1/detail2 creditsunified title detail (tv→TVmaze, movie→TMDB depth + JustWatch offers)
| Parameter | Required |
|---|---|
| id | required |
| type | optional |
| id_type | optional |
| country | optional |
| include_streaming | optional |
post
/movies-tv/v1/episodes1 creditTV episodes (optionally one season)
| Parameter | Required |
|---|---|
| id | required |
| id_type | optional |
| season | optional |
| specials | optional |
post
/movies-tv/v1/cast1 creditcast (tv→TVmaze, movie→TMDB)
| Parameter | Required |
|---|---|
| id | required |
| type | optional |
| id_type | optional |
post
/movies-tv/v1/crew1 creditcrew (tv→TVmaze, movie→TMDB)
| Parameter | Required |
|---|---|
| id | required |
| type | optional |
| id_type | optional |
post
/movies-tv/v1/akas1 creditalternative titles (tv→TVmaze, movie→TMDB)
| Parameter | Required |
|---|---|
| id | required |
| type | optional |
| id_type | optional |
post
/movies-tv/v1/schedule1 creditTV broadcast (kind=tv) or streaming-premiere (kind=web) calendar
| Parameter | Required |
|---|---|
| country | optional |
| date | optional |
| kind | optional |
post
/movies-tv/v1/streaming1 creditwhere-to-watch offers via JustWatch (query/node_id/imdb/tmdb)
| Parameter | Required |
|---|---|
| query | optional |
| id | optional |
| id_type | optional |
| node_id | optional |
| country | optional |
| object_types | optional |
| title | optional |
| year | optional |
post
/movies-tv/v1/people1 creditperson search or detail (tv→TVmaze, movie→TMDB)
| Parameter | Required |
|---|---|
| query | optional |
| id | optional |
| type | optional |
post
/movies-tv/v1/lookup1 creditcross-resolve imdb↔tmdb↔tvmaze ids
| Parameter | Required |
|---|---|
| imdb_id | optional |
| tmdb_id | optional |
| tvmaze_id | optional |
| id | optional |
| id_type | optional |
| type | optional |
post
/movies-tv/v1/genresfreeTMDB genre reference (movie|tv)
| Parameter | Required |
|---|---|
| type | optional |
post
/movies-tv/v1/countriesfreestreaming services available in a country (JustWatch)
| Parameter | Required |
|---|---|
| country | optional |
post
/movies-tv/v1/new_titles1 creditrecently added/changed on streaming (≈ catalog changes)
| Parameter | Required |
|---|---|
| date | required |
| country | optional |
| limit | optional |
| object_types | optional |
| packages | optional |
Example request · search
curl -X POST https://api.reefapi.com/movies-tv/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"breaking bad","type":"tv"}'Response shape
{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}