---
title: "Chart Rankings"
method: GET
path: "/api/imdb/title-chart-rankings/v1"
tags: ["IMDb"]
---

# Chart Rankings

`GET /api/imdb/title-chart-rankings/v1`

## Request

- Base URL: `https://api.justoneapi.com`
- URL: `https://api.justoneapi.com/api/imdb/title-chart-rankings/v1`
- Auth: none declared

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.

## Query parameters

- `token` string, required
- `rankingsChartType` 'TOP_250' | 'TOP_250_TV', required: Chart types for IMDb rankings.
- `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.

## Response `200`

OK

- object
  - `code` 0 | 100 | 101 | 202 | 300 | 301 | 302 | 303 | 400 | 404 | 500 | 503 | 600 | 601 | 602, required
  - `message` string, nullable, required
  - `data` unknown, required
  - `recordTime` string, nullable, required
  - `requestId` string
  - `reason` string
  - `requestParams` object
    - `query` object
    - `body` object
      - `empty` boolean
      - `array` boolean
      - `null` boolean
      - `object` boolean
      - `float` boolean
      - `integralNumber` boolean
      - `floatingPointNumber` boolean
      - `bigDecimal` boolean
      - `bigInteger` boolean
      - `textual` boolean
      - `nodeType` 'ARRAY' | 'BINARY' | 'BOOLEAN' | 'MISSING' | 'NULL' | 'NUMBER' | 'OBJECT' | 'POJO' | 'STRING'
      - `string` boolean
      - `missingNode` boolean
      - `valueNode` boolean
      - `container` boolean
      - `pojo` boolean
      - `short` boolean
      - `int` boolean
      - `long` boolean
      - `double` boolean
      - `boolean` boolean
      - `binary` boolean
      - `number` boolean
      - `embeddedValue` boolean

## Other responses

- `400`: Invalid request parameters or body
- `401`: Invalid or inactive access token
- `403`: Permission denied
- `429`: Request rate or daily quota limit exceeded
- `500`: Internal server error
- `503`: Service temporarily unavailable

## Changes

- **2026-10-31** `4f43dc260e5b`: 7 info
  - added the optional property `requestParams` to the response with the `200` status
  - added the optional property `requestParams` to the response with the `400` status
  - added the optional property `requestParams` to the response with the `401` status
  - added the optional property `requestParams` to the response with the `403` status
  - …3 more
- **2026-10-02** `9c931cc01324`: 7 info
  - added the optional property `reason` to the response with the `200` status
  - added the optional property `reason` to the response with the `400` status
  - added the optional property `reason` to the response with the `401` status
  - added the optional property `reason` to the response with the `403` status
  - …3 more

[Operation history](https://skmtc.dev/justoneapi/apis/justoneapi-api/changes/api/imdb/title-chart-rankings/v1/get.md)

---

[API](https://skmtc.dev/justoneapi/apis/justoneapi-api.md) - [All operations](https://skmtc.dev/justoneapi/apis/justoneapi-api/llms.txt) - [OpenAPI document](https://skmtc.dev/justoneapi/apis/justoneapi-api/revisions/4f43dc260e5b?raw)