IMDb Get Title Chart Rankings

8.73 credits/call
ae_imdb_get_title_chart_rankings

Retrieve a Top 250 movie or TV chart. Set the required rankingsChartType to TOP_250 for movies or TOP_250_TV for TV series. Optionally set languageCountry to en_US (default), fr_CA, fr_FR, de_DE, hi_IN, it_IT, pt_BR, es_ES, es_US, or es_MX to express a language and country/region preference. The JSON response contains the chart payload in data, together with code, message, and recordTime. The fields within data are not specified. Useful for browsing charts and comparing highly ranked titles; a single call does not provide historical rank changes.

Entertainment
8.73 credits/call

Pricing

8.73 credits/call
ConditionCharge
Each call8.73 credits/call

The fixed charge is 8.73 credits per call.

The same fixed charge applies to both movie and TV charts. Language and country/region preferences do not affect the charge.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
languageCountryenum (en_US | fr_CA | fr_FR | de_DE | hi_IN | it_IT | pt_BR | es_ES | es_US | es_MX)No语言与国家/地区偏好。en_US
rankingsChartTypeenum (TOP_250 | TOP_250_TV)Yes要获取的排行榜类型。—

Invocation example

Parameter template

Generated from the parameter configuration. Replace the sample values before use.

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_imdb_get_title_chart_rankings' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "rankingsChartType": "TOP_250"
  }
}'

No response example available yet.