Search / discover feed | Movie Knight Server

{
  "ok": true,
  "data": [
    {
      "id": 27205,
      "adult": false,
      "title": "Inception",
      "video": false,
      "overview": "Cobb, a skilled thief who commits corporate espionage by infiltrating the subconscious of his targets, is offered a chance to regain his old life.",
      "genre_ids": [
        28,
        878,
        12
      ],
      "popularity": 95.13,
      "vote_count": 36219,
      "poster_path": "/oYuLEt3zVCKq57qu2F8dT7NIa6f.jpg",
      "release_date": "2010-07-15",
      "vote_average": 8.369,
      "backdrop_path": "/s3TBrRGB1iav7gFOCNx3H31MoES.jpg",
      "original_title": "Inception",
      "original_language": "en"
    },
    {
      "id": 157336,
      "adult": false,
      "title": "Interstellar",
      "video": false,
      "overview": "A team of explorers travel through a wormhole in space in an attempt to ensure humanity's survival.",
      "genre_ids": [
        12,
        18,
        878
      ],
      "popularity": 87.45,
      "vote_count": 24000,
      "poster_path": "/gEU2QniE6E77NI6lCU6MxlNBvIx.jpg",
      "release_date": "2014-11-05",
      "vote_average": 8.3,
      "backdrop_path": "/rAiYTfKGqDCRIIqo664sY9XZIvQ.jpg",
      "original_title": "Interstellar",
      "original_language": "en"
    }
  ]
}

What: The main movie feed with continuous pagination. Two modes: free-text (q present) returns TMDB relevance results; empty q returns the discover feed with the chosen sort + every filter applied natively.

Auth: None.

Query params: see the Params tab; common ones below.

Param	Type	Required	Description	Example
q	string	no	Title text. Present = relevance search (filters + sort ignored).	`inception`
sortBy	string	no	popularity (default), trending, rating_desc, rating_asc, title_asc, title_desc, year_desc, year_asc.	`trending`
genre	string	no	TMDB genre id, or comma/pipe list (OR).	`28,12`
yearFrom / yearTo	integer	no	Inclusive 4-digit release-year range.	`1990` / `1999`
minRating	number	no	0-10 vote-average floor.	`7`
minVotes	integer	no	Minimum vote count.	`1000`
language	string	no	ISO 639-1 original language.	`en`
with_cast / with_crew	string	no	TMDB person id (actor / director).	`31`
providers	string	no	TMDB provider id(s), comma/pipe list (OR). Needs watch_region.	`8`
watch_region	string	no	Region for providers, default US.	`US`
certification	string	no	Exact age rating. Needs certification_country (default US).	`R`
page	integer	no	1-500, default 1.	`1`

Returns: data = [movie] (raw TMDB list objects). Empty array only when TMDB has no more pages.

**What:** The main movie feed with continuous pagination. Two modes: free-text (`q` present) returns TMDB relevance results; empty `q` returns the discover feed with the chosen sort + every filter applied natively. **Auth:** None. **Query params:** see the Params tab; common ones below. | Param | Type | Required | Description | Example | | --- | --- | --- | --- | --- | | q | string | no | Title text. Present = relevance search (filters + sort ignored). | `inception` | | sortBy | string | no | popularity (default), trending, rating_desc, rating_asc, title_asc, title_desc, year_desc, year_asc. | `trending` | | genre | string | no | TMDB genre id, or comma/pipe list (OR). | `28,12` | | yearFrom / yearTo | integer | no | Inclusive 4-digit release-year range. | `1990` / `1999` | | minRating | number | no | 0-10 vote-average floor. | `7` | | minVotes | integer | no | Minimum vote count. | `1000` | | language | string | no | ISO 639-1 original language. | `en` | | with_cast / with_crew | string | no | TMDB person id (actor / director). | `31` | | providers | string | no | TMDB provider id(s), comma/pipe list (OR). Needs watch_region. | `8` | | watch_region | string | no | Region for providers, default US. | `US` | | certification | string | no | Exact age rating. Needs certification_country (default US). | `R` | | page | integer | no | 1-500, default 1. | `1` | **Returns:** `data = [movie]` (raw TMDB list objects). Empty array only when TMDB has no more pages.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

sortBystringOptional

string, optional. Semantic sort intent. One of: popularity (default), trending, rating_desc, rating_asc, title_asc, title_desc, year_desc, year_asc. Unknown = popularity.

pageintegerOptional

integer, optional. 1-500, default 1. Forwarded 1:1 to TMDB (20 results per page).

Response

okboolean

datalist of objects

Auth: None.

Query params: see the Params tab; common ones below.

Param	Type	Required	Description	Example
q	string	no	Title text. Present = relevance search (filters + sort ignored).	`inception`
sortBy	string	no	popularity (default), trending, rating_desc, rating_asc, title_asc, title_desc, year_desc, year_asc.	`trending`
genre	string	no	TMDB genre id, or comma/pipe list (OR).	`28,12`
yearFrom / yearTo	integer	no	Inclusive 4-digit release-year range.	`1990` / `1999`
minRating	number	no	0-10 vote-average floor.	`7`
minVotes	integer	no	Minimum vote count.	`1000`
language	string	no	ISO 639-1 original language.	`en`
with_cast / with_crew	string	no	TMDB person id (actor / director).	`31`
providers	string	no	TMDB provider id(s), comma/pipe list (OR). Needs watch_region.	`8`
watch_region	string	no	Region for providers, default US.	`US`
certification	string	no	Exact age rating. Needs certification_country (default US).	`R`
page	integer	no	1-500, default 1.	`1`

Returns: data = [movie] (raw TMDB list objects). Empty array only when TMDB has no more pages.

$	curl -G https://{{baseurl}}/api/movies/search \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d sortBy=trending \
>	-d page=1