tmdbsearch.md

Search Movies Or Tv Shows By Query Text

Search movies or tv shows by query text.

URL : /api/tmdbsearch/type/{type}/lang/{lang}/page/{page}/text/{text}

Method : GET

Query Parameters :

Parameter	Type	Description
type	string	Switch between searching movies or tv shows.
lang	string	ISO 639-1 two-letter language code.
page	integer	Specify the page of results to query.
text	string	Text query to search. Space characters must be replaced with minus or non-breaking space characters. This value should be URI encoded.

Accepted Values [ type ] :

Value	Description
movie	Discover movies.
tv	Discover tv shows.

Success Response

Code : 200 OK

Main Object :

Name	Type	Description
success	bool	Indicates whether the query was successful.
results	array[object]	Contains the complete TMDB API response.

Object [ results ] :

Name	Type	Description
page	integer	Current page number.
total_results	integer	Total number of movies or tv shows.
total_pages	integer	Total number of ages.
results	array[object]	Array of movie or tv show objects.

Object [ results ] :

Movie results	TV Show results
Name Type poster_path string or null adult bool overview string release_date string genre_ids array[integer] id integer original_title string original_language string title string backdrop_path string or null popularity number vote_count integer video bool vote_average number	Name Type poster_path string or null popularity number id integer backdrop_path string or null vote_average number overview string first_air_date string origin_country array[string] genre_ids array[integer] original_language string vote_count integer name string original_name string

Decode Table [ genre_ids ] :

Movie genre_ids	TV Show genre_ids
Value Genre 28 Action 12 Adventure 16 Animation 35 Comedy 80 Crime 99 Documentary 18 Drama 10751 Family 14 Fantasy 36 History 27 Horror 10402 Music 9648 Mystery 10749 Romance 878 Sci-fi 53 Thriller 10752 War 37 Western	Value Genre 10759 Action & Adventure 16 Animation 35 Comedy 80 Crime 99 Documentary 18 Drama 10751 Family 10762 Kids 9648 Mystery 10763 News 10764 Reality 10765 Sci-fi & Fantasy 10766 Soap 10767 Talk 10768 War & Politics 37 Western

Error Response

Code : 404 (Not Found)

Main Object :

Name	Type	Description
success	bool	Indicates whether the query was successful.
message	string	Text message that describes the response.

Examples

Request :

GET http://localhost:9000/api/tmdbsearch/type/tv/lang/en/page/1/text/raised-by-wolves

Success Response :

{
    "success": true,
    "results": [{
        "page": 1,
        "total_results": 2,
        "total_pages": 1,
        "results": [{
            "original_name": "Raised by Wolves",
            "genre_ids": [10765, 18],
            "name": "Raised by Wolves",
            "popularity": 168.868,
            "origin_country": ["US"],
            "vote_count": 433,
            "first_air_date": "2020-09-03",
            "backdrop_path": "\/na2xUduK8HviOFT97TiFG2MkJmY.jpg",
            "original_language": "en",
            "id": 85723,
            "vote_average": 7.7,
            "overview": "After Earth is ravaged by a great religious war, an atheistic android architect sends two of his creations, Mother and Father, to start a peaceful, godless colony on the planet Kepler-22b. Their treacherous task is jeopardized by the arrival of the Mithraic, a deeply devout religious order of surviving humans.",
            "poster_path": "\/mTvSVKMn2Npf6zvYNbGMJnYLtvp.jpg"
        }, {
            "original_name": "Raised by Wolves",
            "genre_ids": [35],
            "name": "Raised by Wolves",
            "popularity": 5.674,
            "origin_country": ["GB"],
            "vote_count": 8,
            "first_air_date": "2015-03-16",
            "backdrop_path": "\/cSA5pPdkEgFDWFcjdr4S2IohLXd.jpg",
            "original_language": "en",
            "id": 62160,
            "vote_average": 7.5,
            "overview": "Set on a Wolverhampton council estate, Raised By Wolves is modern day reimagining of the childhood of Caitlin Moran and her brothers and sisters.\n\nSingle-mum Della lives in a three bedroom council house with Germaine, Aretha, Yoko, Mariah, Wyatt and baby Cher. She is attempting to raise the children by herself, but does have visits from Grampy, who likes to come around to dispense his wisdom to his grandchildren.",
            "poster_path": "\/54ONCnoHQZdMnPZU90QN8ezjhS2.jpg"
        }]
    }]
}

Error Response :

{
    "success": false,
    "message": "No TMDB data found."
}