TMDB Get Discover Movie
1 credits/call
ae_tmdb_get_discover_movie
Find movies using filters like genre, year, and ratings.
1 credits/call
Pricing
1 credits/call
| Condition | Charge |
|---|---|
| Each call | 1 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
page | integer | No | Page number | 1 |
year | integer | No | Year | — |
region | string | No | Region code | — |
sort_by | enum (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) | No | Sort order | popularity.desc |
language | string | No | Language code | en-US |
with_cast | string | No | Can be a comma (AND) or pipe (OR) separated query | — |
with_crew | string | No | Can be a comma (AND) or pipe (OR) separated query | — |
with_genres | string | No | Can be a comma (AND) or pipe (OR) separated query | — |
with_people | string | No | Can be a comma (AND) or pipe (OR) separated query | — |
watch_region | string | No | Use in conjunction with with_watch_monetization_types or with_watch_providers | — |
certification | string | No | Use in conjunction with region | — |
include_adult | boolean | No | Include adult content | false |
include_video | boolean | No | Include video results | false |
with_keywords | string | No | Can be a comma (AND) or pipe (OR) separated query | — |
vote_count.gte | number | No | Vote count greater than or equal to | — |
vote_count.lte | number | No | Vote count less than or equal to | — |
with_companies | string | No | Can be a comma (AND) or pipe (OR) separated query | — |
without_genres | string | No | Without genres | — |
release_date.gte | string | No | Release date greater than or equal to | — |
release_date.lte | string | No | Release date less than or equal to | — |
vote_average.gte | number | No | Vote average greater than or equal to | — |
vote_average.lte | number | No | Vote average less than or equal to | — |
with_runtime.gte | integer | No | Runtime greater than or equal to | — |
with_runtime.lte | integer | No | Runtime less than or equal to | — |
without_keywords | string | No | Without keywords | — |
certification.gte | string | No | Use in conjunction with region | — |
certification.lte | string | No | Use in conjunction with region | — |
with_release_type | enum (1 | 2 | 3 | 4 | 5 | 6) | No | Possible values are: [1, 2, 3, 4, 5, 6] can be a comma (AND) or pipe (OR) separated query | — |
without_companies | string | No | Without companies | — |
with_origin_country | string | No | Origin country | — |
primary_release_year | integer | No | Primary release year | — |
with_watch_providers | string | No | Use in conjunction with watch_region | — |
certification_country | string | No | Use in conjunction with the certification, certification.gte and certification.lte filters | — |
with_original_language | string | No | Original language | — |
without_watch_providers | string | No | Without watch providers | — |
primary_release_date.gte | string | No | Primary release date greater than or equal to | — |
primary_release_date.lte | string | No | Primary release date less than or equal to | — |
with_watch_monetization_types | enum (flatrate | free | ads | rent | buy) | No | Possible values are: [flatrate, free, ads, rent, buy] | — |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest 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
{
"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.

