Search / discover feed | Movie Knight Server

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.

Query parameters

qstringOptional

string, optional. Free-text title search. When present, ALL filters and sort are ignored (pure relevance). Empty/omitted = popular discover feed.

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).

genrestringOptional

string, optional. One TMDB genre id or comma/pipe-joined ids (e.g. 28,12). Multi = OR.

yearFromintegerOptional

integer, optional. Inclusive release-year lower bound (4-digit).

yearTointegerOptional

integer, optional. Inclusive release-year upper bound (4-digit).

minRatingdoubleOptional

number, optional. 0-10 vote-average floor.

minVotesintegerOptional

integer, optional. Minimum TMDB vote count (quality floor). Rating sorts default this to 50 when unset.

languagestringOptional

string, optional. ISO 639-1 original language (e.g. en, ja, ko).

with_caststringOptional

string, optional. TMDB person id (actor). Resolve via /api/people/search.

with_crewstringOptional

string, optional. TMDB person id (director). Resolve via /api/people/search.

providersstringOptional

string, optional. One or comma/pipe-joined TMDB watch-provider ids (e.g. 8,9). OR semantics.

watch_regionstringOptional

string, optional. ISO 3166-1 region for provider filtering. Default US (required by TMDB whenever providers is set).

certificationstringOptional

string, optional. Exact age rating (e.g. R, PG-13).

certification_countrystringOptional

string, optional. ISO 3166-1 country for the certification. Default US.

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://movieknight-server-7d8h.onrender.com/api/movies/search \
>	-H "Content-Type: application/json" \
>	-d sortBy=trending \
>	-d page=1 \
>	-d watch_region=US \
>	-d certification_country=US \
>	-d q=inception \
>	--data-urlencode genre=28,12 \
>	-d yearFrom=1990 \
>	-d yearTo=1999 \
>	-d minRating=7 \
>	-d minVotes=1000 \
>	-d language=en \
>	-d with_cast=31 \
>	-d with_crew=525 \
>	--data-urlencode providers=8,9 \
>	-d certification=R

1	{
2	"ok": true,
3	"data": [
4	{
5	"id": 27205,
6	"title": "Inception",
7	"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.",
8	"popularity": 95.13,
9	"poster_path": "/oYuLEt3zVCKq57qu2F8dT7NIa6f.jpg",
10	"release_date": "2010-07-15",
11	"vote_average": 8.369,
12	"backdrop_path": "/s3TBrRGB1iav7gFOCNx3H31MoES.jpg",
13	"adult": false,
14	"video": false,
15	"genre_ids": [
16	28,
17	878,
18	12
19	],
20	"vote_count": 36219,
21	"original_title": "Inception",
22	"original_language": "en"
23	}
24	]
25	}