Docs menu

IMDb API endpoint

IMDb title charts API

Returns an IMDb title chart, chosen with `chart`: `top_rated_movies` (default), `top_rated_tv_shows`, `most_popular_movies`, `most_popular_tv_shows`, `top_rated_english_movies` or `lowest_rated_movies`. `limit` sets the rows (default 25, max 250). Each title has its rank, id, year, rating, rating count and credits.

GETapiKey3 credits/requestIMDbimdb.chartsResponseDoc/imdb/charts

Endpoint facts

Method: GET
API path: /imdb/charts
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: IMDb
Response schema: #/definitions/imdb.chartsResponseDoc

IMDb Scraper API Try IMDb title charts API in Playground IMDb API documentation

How this endpoint behaves

Returns rows from IMDb title charts.

Query parameters:

chart: chart to return. Allowed values are top_rated_movies, top_rated_tv_shows, most_popular_movies, most_popular_tv_shows, top_rated_english_movies, and lowest_rated_movies. Defaults to top_rated_movies.
limit: rows to return. Defaults to 25; maximum 250.

Notable response behavior:

data.titles is ranked in the chart order and includes title IDs, public title URLs, rating summaries, and any director, writer, or cast credits provided for that chart row.
A missing or empty chart payload is returned as an upstream error rather than a successful empty list.

Live monitoring

Monitored request: GET /imdb/charts?chart=top_rated_movies&limit=3
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.13 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /imdb/charts?chart=top_rated_movies&limit=20
Items in titles: 20
Fields filled in every checked item: 10

Field	Filled in, of 20 checked	Values in the sample
rank	20	1 to 20, median 10
id	20
title	20	“The Shawshank Redemption” and 19 other values
url	20	imdb.com
year	20	1,957 to 2,014, median 1,994
rating_value	20	8.6 to 9.3, median 8.8
rating_count	20	904,146 to 3,252,102, median 2,200,545
directors	20	median 1 entry
writers	20	median 2 entries
cast	20	median 10 entries

Request parameters

Parameter	Type	Required	Description
chart	string	No	IMDb chart Allowed values: top_rated_movies, top_rated_tv_shows, most_popular_movies, most_popular_tv_shows, top_rated_english_movies, lowest_rated_movies.
limit	integer	No	Rows to return, default 25, max 250
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/imdb/charts?chart=top_rated_movies&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "chart": "top_rated_movies",
    "limit": 25,
    "source_url": "https://www.imdb.com/chart/top/",
    "titles": [
      {
        "rank": 1,
        "id": "tt0111161",
        "title": "The Shawshank Redemption",
        "url": "https://www.imdb.com/title/tt0111161/",
        "year": 1994,
        "rating_value": 9.3,
        "rating_count": 3227390
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/imdb.chartsResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	imdb.ChartResponse	No
data.chart	string	No	top_rated_movies
data.fetched_at	string	No	2026-08-22T14:46:16Z
data.limit	integer	No	25
data.source_url	string	No	https://www.imdb.com/chart/top/
data.titles	array	No
data.titles[].cast	array	No
data.titles[].cast[].name	string	No	Christopher Nolan	Name of the person.
data.titles[].cast[].url	string	No	https://www.imdb.com/name/nm0634240/	IMDb page URL of the person.
data.titles[].directors	array	No
data.titles[].directors[].name	string	No	Christopher Nolan	Name of the person.
data.titles[].directors[].url	string	No	https://www.imdb.com/name/nm0634240/	IMDb page URL of the person.
data.titles[].id	string	No	tt0111161
data.titles[].rank	integer	No	1
data.titles[].rating_count	integer	No	3227390
data.titles[].rating_value	number	No	9.3
data.titles[].title	string	No	The Shawshank Redemption
data.titles[].url	string	No	https://www.imdb.com/title/tt0111161/
data.titles[].writers	array	No
data.titles[].writers[].name	string	No	Christopher Nolan	Name of the person.
data.titles[].writers[].url	string	No	https://www.imdb.com/name/nm0634240/	IMDb page URL of the person.
data.titles[].year	integer	No	1994
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
401	Unauthorized	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/imdb/charts?chart=top_rated_movies&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More IMDb endpoint docs IMDb Scraper API IMDb image types API documentation IMDb name detail API documentation IMDb name awards API documentation IMDb name credits API documentation IMDb name images API documentation IMDb name video metadata API documentation

Open in Playground Back to group

Docs menu

IMDb API endpoint

IMDb title charts API

GETapiKey3 credits/requestIMDbimdb.chartsResponseDoc/imdb/charts

Endpoint facts

Method: GET
API path: /imdb/charts
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: IMDb
Response schema: #/definitions/imdb.chartsResponseDoc

IMDb Scraper API Try IMDb title charts API in Playground IMDb API documentation

How this endpoint behaves

Returns rows from IMDb title charts.

Query parameters:

chart: chart to return. Allowed values are top_rated_movies, top_rated_tv_shows, most_popular_movies, most_popular_tv_shows, top_rated_english_movies, and lowest_rated_movies. Defaults to top_rated_movies.
limit: rows to return. Defaults to 25; maximum 250.

Notable response behavior:

data.titles is ranked in the chart order and includes title IDs, public title URLs, rating summaries, and any director, writer, or cast credits provided for that chart row.
A missing or empty chart payload is returned as an upstream error rather than a successful empty list.

Live monitoring

Monitored request: GET /imdb/charts?chart=top_rated_movies&limit=3
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.13 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /imdb/charts?chart=top_rated_movies&limit=20
Items in titles: 20
Fields filled in every checked item: 10

Field	Filled in, of 20 checked	Values in the sample
rank	20	1 to 20, median 10
id	20
title	20	“The Shawshank Redemption” and 19 other values
url	20	imdb.com
year	20	1,957 to 2,014, median 1,994
rating_value	20	8.6 to 9.3, median 8.8
rating_count	20	904,146 to 3,252,102, median 2,200,545
directors	20	median 1 entry
writers	20	median 2 entries
cast	20	median 10 entries

Request parameters

Parameter	Type	Required	Description
chart	string	No	IMDb chart Allowed values: top_rated_movies, top_rated_tv_shows, most_popular_movies, most_popular_tv_shows, top_rated_english_movies, lowest_rated_movies.
limit	integer	No	Rows to return, default 25, max 250
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/imdb/charts?chart=top_rated_movies&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "chart": "top_rated_movies",
    "limit": 25,
    "source_url": "https://www.imdb.com/chart/top/",
    "titles": [
      {
        "rank": 1,
        "id": "tt0111161",
        "title": "The Shawshank Redemption",
        "url": "https://www.imdb.com/title/tt0111161/",
        "year": 1994,
        "rating_value": 9.3,
        "rating_count": 3227390
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/imdb.chartsResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	imdb.ChartResponse	No
data.chart	string	No	top_rated_movies
data.fetched_at	string	No	2026-08-22T14:46:16Z
data.limit	integer	No	25
data.source_url	string	No	https://www.imdb.com/chart/top/
data.titles	array	No
data.titles[].cast	array	No
data.titles[].cast[].name	string	No	Christopher Nolan	Name of the person.
data.titles[].cast[].url	string	No	https://www.imdb.com/name/nm0634240/	IMDb page URL of the person.
data.titles[].directors	array	No
data.titles[].directors[].name	string	No	Christopher Nolan	Name of the person.
data.titles[].directors[].url	string	No	https://www.imdb.com/name/nm0634240/	IMDb page URL of the person.
data.titles[].id	string	No	tt0111161
data.titles[].rank	integer	No	1
data.titles[].rating_count	integer	No	3227390
data.titles[].rating_value	number	No	9.3
data.titles[].title	string	No	The Shawshank Redemption
data.titles[].url	string	No	https://www.imdb.com/title/tt0111161/
data.titles[].writers	array	No
data.titles[].writers[].name	string	No	Christopher Nolan	Name of the person.
data.titles[].writers[].url	string	No	https://www.imdb.com/name/nm0634240/	IMDb page URL of the person.
data.titles[].year	integer	No	1994
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
401	Unauthorized	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/imdb/charts?chart=top_rated_movies&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

IMDb title charts API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

IMDb title charts API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related