Sign in
IMDb

Chart Rankings

Retrieves the IMDb Top 250 movie or TV chart selected by ranking type using language and country preferences. Use it to monitor chart positions or compare highly ranked titles.

get/api/imdb/title-chart-rankings/v1

Query parameters

tokenstring required

User's authentication token.

rankingsChartType'TOP_250' | 'TOP_250_TV' required

Chart types for IMDb rankings.

Type of rankings chart to retrieve.

Available Values:

  • TOP_250: Top 250 Movies
  • TOP_250_TV: Top 250 TV Shows
languageCountry'en_US' | 'fr_CA' | 'fr_FR' | 'de_DE' | 'hi_IN' | 'it_IT' | 'pt_BR' | 'es_ES' | 'es_US' | 'es_MX'

Language and country options for IMDb data.

Language and country preferences.

Available Values:

  • en_US: English (US)
  • fr_CA: French (Canada)
  • fr_FR: French (France)
  • de_DE: German (Germany)
  • hi_IN: Hindi (India)
  • it_IT: Italian (Italy)
  • pt_BR: Portuguese (Brazil)
  • es_ES: Spanish (Spain)
  • es_US: Spanish (US)
  • es_MX: Spanish (Mexico)

Response

OK

code0 | 100 | 101 | 202 | 300 | 301 | 302 | 303 | 400 | 404 | 500 | 503 | 600 | 601 | 602 required
messagestring nullable required
{"stackTrail":"paths:/api/imdb/title-chart-rankings/v1:get:responses:200:content:application/json:schema:properties:data","oasType":"schema","type":"unknown"}
recordTimestring nullable required
requestIdstring

Changes

No recorded changes to this endpoint across all 1 revision of this API.