---
title: "Get a TMDB collection"
method: GET
path: "/tmdb/collection/{id}"
tags: ["TMDB"]
---

# Get a TMDB collection

`GET /tmdb/collection/{id}`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/tmdb/collection/{id}`
- Auth: API key in header `x-api-key`

Returns a TMDB collection (a movie franchise grouping) by `id`, which can be the collection id or an id-slug. The response has the collection title, overview, `uri` and `source_url`, plus its member movies, each with id, title, overview, poster URL, release date and `uri`.

## Path parameters

- `id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- TmdbCollectionResponseDoc
  - `code` integer
  - `data` TmdbCollectionResponse
    - `id` string
    - `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.
    - `overview` string
    - `source_url` string
    - `title` string
    - `uri` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `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/0497899e2016?raw)