---
title: "Get a TMDB movie chart"
method: GET
path: "/tmdb/movie/list"
tags: ["TMDB"]
---

# Get a TMDB movie chart

`GET /tmdb/movie/list`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/tmdb/movie/list`
- Auth: API key in header `x-api-key`

Returns a page of TMDB movies from the `category` chart (`popular` by default, or `top_rated`, `now_playing`, `upcoming`), optionally refined by `sort_by`, `with_genres`, `original_language`, release dates, rating, votes and runtime. `limit` defaults to 10 (max 20). Each movie has id, title, overview, poster, release date and `uri`; `has_next_page` signals more pages.

## Query parameters

- `category` 'popular' | 'top_rated' | 'now_playing' | 'upcoming'
- `page` integer
- `sort_by` 'popularity.desc' | 'popularity.asc' | 'vote_average.desc' | 'vote_average.asc' | 'primary_release_date.desc' | 'primary_release_date.asc' | 'title.asc' | 'title.desc'
- `with_genres` string
- `original_language` string
- `date_from` string
- `date_to` string
- `min_rating` number
- `max_rating` number
- `min_votes` integer
- `min_runtime` integer
- `max_runtime` integer
- `include_adult` boolean
- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- TmdbMovieListResponseDoc
  - `code` integer
  - `data` TmdbMovieListResponse
    - `category` string
    - `has_next_page` boolean
    - `movies` TmdbMediaRef[]
      - `id` string: TMDB id of the movie or TV show. Use it with the movie or TV detail endpoint.
      - `overview` string: Short plot summary. Not filled in for list and chart results.
      - `poster_url` string: URL of the poster image. Not filled in for list and chart results.
      - `release_date` string: Release or first air date. Not filled in for list and chart results.
      - `title` string: Title of the movie or TV show.
      - `uri` string: Link to the title's page on TMDB.
    - `page` integer
    - `source_url` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error
- `503`: Service Unavailable

---

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