# Get an IMDb chart (v1)

Get an IMDb chart in rank order, such as the Top 250 movies or the 100 most popular TV shows, with each title's rating, votes, year, genres and poster. The whole chart arrives in one response.

- Platform: IMDb
- Request: `GET https://api.toolzerhub.com/v1/imdb/chart`
- Auth: `x-api-key` header
- Cost: 1 credit per successful request. Failed requests are not billed.
- Page: https://docs.toolzerhub.com/reference/imdb/charts/get-imdb-chart

| Parameter | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `chart` | query | no | enum: top_movies, top_tv, popular_movies, popular_tv, lowest_movies, top_english_movies, top_indian_movies | top_movies and top_tv are the Top 250 lists; popular_movies and popular_tv the 100 most popular now; lowest_movies the Bottom 100; top_english_movies and top_indian_movies hold 250. Default: top_movies. |

## Example request

```bash
curl "https://api.toolzerhub.com/v1/imdb/chart" \
  -H "x-api-key: $TOOLZERHUB_API_KEY"
```

Success responses are wrapped as `{ "data": ... }`. Errors return `{ "error": { "code", "status", "message", "retryable", "details" } }`. See https://docs.toolzerhub.com/docs/responses-and-errors.