TMDB Get Discover Movie

1 credits/call
ae_tmdb_get_discover_movie

Find movies using filters like genre, year, and ratings.

Entertainment
1 credits/call

Pricing

1 credits/call
ConditionCharge
Each call1 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
pageintegerNoPage number1
yearintegerNoYear—
regionstringNoRegion code—
sort_byenum (original_title.asc | original_title.desc | popularity.asc | popularity.desc | revenue.asc | revenue.desc | primary_release_date.asc | title.asc | title.desc | primary_release_date.desc | vote_average.asc | vote_average.desc | vote_count.asc | vote_count.desc)NoSort orderpopularity.desc
languagestringNoLanguage codeen-US
with_caststringNoCan be a comma (AND) or pipe (OR) separated query—
with_crewstringNoCan be a comma (AND) or pipe (OR) separated query—
with_genresstringNoCan be a comma (AND) or pipe (OR) separated query—
with_peoplestringNoCan be a comma (AND) or pipe (OR) separated query—
watch_regionstringNoUse in conjunction with with_watch_monetization_types or with_watch_providers—
certificationstringNoUse in conjunction with region—
include_adultbooleanNoInclude adult contentfalse
include_videobooleanNoInclude video resultsfalse
with_keywordsstringNoCan be a comma (AND) or pipe (OR) separated query—
vote_count.gtenumberNoVote count greater than or equal to—
vote_count.ltenumberNoVote count less than or equal to—
with_companiesstringNoCan be a comma (AND) or pipe (OR) separated query—
without_genresstringNoWithout genres—
release_date.gtestringNoRelease date greater than or equal to—
release_date.ltestringNoRelease date less than or equal to—
vote_average.gtenumberNoVote average greater than or equal to—
vote_average.ltenumberNoVote average less than or equal to—
with_runtime.gteintegerNoRuntime greater than or equal to—
with_runtime.lteintegerNoRuntime less than or equal to—
without_keywordsstringNoWithout keywords—
certification.gtestringNoUse in conjunction with region—
certification.ltestringNoUse in conjunction with region—
with_release_typeenum (1 | 2 | 3 | 4 | 5 | 6)NoPossible values are: [1, 2, 3, 4, 5, 6] can be a comma (AND) or pipe (OR) separated query—
without_companiesstringNoWithout companies—
with_origin_countrystringNoOrigin country—
primary_release_yearintegerNoPrimary release year—
with_watch_providersstringNoUse in conjunction with watch_region—
certification_countrystringNoUse in conjunction with the certification, certification.gte and certification.lte filters—
with_original_languagestringNoOriginal language—
without_watch_providersstringNoWithout watch providers—
primary_release_date.gtestringNoPrimary release date greater than or equal to—
primary_release_date.ltestringNoPrimary release date less than or equal to—
with_watch_monetization_typesenum (flatrate | free | ads | rent | buy)NoPossible values are: [flatrate, free, ads, rent, buy]—

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_discover_movie' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "page": 1,
    "sort_by": "popularity.desc"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "page": 1,
  "results": [
    {
      "adult": false,
      "backdrop_path": "/r08LxMJCbf1SiJIWeyH9aJmdqwC.jpg",
      "genre_ids": [
        878
      ],
      "id": 969681,
      "original_language": "en",
      "title": "Spider-Man: Brand New Day"
    }
  ]
}

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