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.
Pricing
| Condition | Charge |
|---|---|
| Each call | 8.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.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
languageCountry | enum (en_US | fr_CA | fr_FR | de_DE | hi_IN | it_IT | pt_BR | es_ES | es_US | es_MX) | No | 语言与国家/地区偏好。 | en_US |
rankingsChartType | enum (TOP_250 | TOP_250_TV) | Yes | 要获取的排行榜类型。 | — |
Invocation example
Parameter templateGenerated from the parameter configuration. Replace the sample values before use.
/agent-api/v1/tool/executeX-Api-Keycurl --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.

