𝕏TVDb

Endpoints

Collections

Official TMDb collections (film sagas) and hand-curated 𝕏TV collections, resolved against the catalog.

GET/api/v1/collections

All curated 𝕏TV collections.

Hand-picked themed sets maintained by the moderation team.

$curl -H "Authorization: Bearer xtvdb_YOUR_KEY" \

"https://xtvdb.com/api/v1/collections"

Returns { data: [{ code, name, description, title_count, updated_at }] }

GET/api/v1/collections/{slug}

One collection with its titles.

tmdb-{id} resolves an official TMDb collection (e.g. tmdb-556 for Spider-Man); anything else is a curated 𝕏TV collection code.

ParameterInRequiredDescription
slugpathyestmdb-{id} or the 𝕏TV collection code.

$curl -H "Authorization: Bearer xtvdb_YOUR_KEY" \

"https://xtvdb.com/api/v1/collections/tmdb-556"

Returns { data: { slug, kind, name, description, titles: Title[] } }