Endpoints

Titles

Everything about a single title: full metadata, what 𝕏TV can deliver right now, and what to watch next.

GET/api/v1/titles/{xtv_id}

One title, complete.

The full catalog record: titles (incl. German alias), overview, year, genres, runtime or seasons, certification, artwork, cast, trailer, keywords, external ids (IMDb/TMDb/TVDb), community ratings and library availability flags.

Parameter	In	Required	Description
xtv_id	path	yes	X{n}TV for movies, XS{n}TV for series (e.g. XS1TV).

$curl -H "Authorization: Bearer xtvdb_YOUR_KEY" \

"https://xtvdb.com/api/v1/titles/XS1TV"

Returns { data: Title }

GET/api/v1/titles/{xtv_id}/availability

What 𝕏TV can deliver right now.

One item per season (or one for a movie): the qualities on offer, episode counts, whether the season is still airing, and the public Telegram deep link that starts delivery. Never any file internals.

Parameter	In	Required	Description
xtv_id	path	yes	The title's 𝕏TV id.

$curl -H "Authorization: Bearer xtvdb_YOUR_KEY" \

"https://xtvdb.com/api/v1/titles/XS1TV/availability"

Returns { data: { xtv_id, available, bundle_count, items: [{ season, qualities, airing, episode_count, telegram_link }] } }

GET/api/v1/titles/{xtv_id}/similar

Related titles — the website's “More like this” row.

TMDb recommendations that actually exist in the catalog, topped up with genre-overlap matches. Only real catalog titles are ever returned.

Parameter	In	Required	Description
xtv_id	path	yes	The title's 𝕏TV id.

$curl -H "Authorization: Bearer xtvdb_YOUR_KEY" \

"https://xtvdb.com/api/v1/titles/XS1TV/similar"

Returns { data: Title[] } (up to 12)

← Rate limits & errors Search & lookup →