TMDB Get Search Movie

1 credits/call
ae_tmdb_get_search_movie

Search for movies by title, including original, translated, or alternative names.

Entertainment
1 credits/call

Pricing

1 credits/call
ConditionCharge
Each call1 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
pageintegerNoSpecify which page to query.1
yearstringNoFilter the results release dates to matches that include this year.—
querystringYesPass a text query to search. This value should be URI encoded.—
regionstringNoSpecify a ISO 3166-1 code to filter release dates.—
languagestringNoSpecify a language to search for results in.en-US
include_adultbooleanNoChoose whether to include adult (pornography) content in the results.false
primary_release_yearstringNoFilter the results release dates to matches that include this year.—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_tmdb_get_search_movie' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "page": 1,
    "query": "Inception"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "page": 1,
  "results": [
    {
      "adult": false,
      "backdrop_path": "/8ZTVqvKDQ8emSGUEMjsS4yHAwrp.jpg",
      "genre_ids": [
        28
      ],
      "id": 27205,
      "original_language": "en",
      "title": "Inception"
    }
  ],
  "total_pages": 1,
  "total_results": 12
}

This example shows part of the response. Copied content is valid JSON.