TMDB Get Search Movie
1 credits/call
ae_tmdb_get_search_movie
Search for movies by title, including original, translated, or alternative names.
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 | Specify which page to query. | 1 |
year | string | No | Filter the results release dates to matches that include this year. | — |
query | string | Yes | Pass a text query to search. This value should be URI encoded. | — |
region | string | No | Specify a ISO 3166-1 code to filter release dates. | — |
language | string | No | Specify a language to search for results in. | en-US |
include_adult | boolean | No | Choose whether to include adult (pornography) content in the results. | false |
primary_release_year | string | No | Filter 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-KeyRequest 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
{
"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.

