Getting started
Everything the website knows, as clean JSON — 16 endpoints covering titles, live availability, search, collections and people. Access requires an API key from the Developer Program; the Developer plan is free and asks only for attribution.
Base URL
https://xtvdb.com
All endpoints are HTTPS GET under /api/v1.
Versioning
/api/v1
v1 is stable: fields are added, never removed or renamed.
Your first request in three steps
1.Apply to the Developer Program
Log in with Telegram, then apply at Account → Developer settings — name, email and a short description of what you are building. A moderator reviews every application (usually within a day or two); you are notified with the decision.
2.Create your API key
Once approved: one click in Developer settings. The full key is shown exactly once — store it like a password.
3.Call the API
curl -H "Authorization: Bearer xtvdb_YOUR_KEY" \ "https://xtvdb.com/api/v1/search?q=the%20rookie"
𝕏TV IDs
Every title has one canonical id: X{n}TV for movies, XS{n}TV for series — cross-referenced against IMDb, TMDb and TVDb. If you only have an external id, /lookup translates it.
The endpoint map
Titles3 endpoints
Everything about a single title: full metadata, what 𝕏TV can deliver right now, and what to watch next.
Search & lookup2 endpoints
Find titles by text the way the website does, or resolve external ids directly.
Browse & discovery5 endpoints
Paginated browsing with the website's filters, plus curated discovery shortcuts.
Collections2 endpoints
Official TMDb collections (film sagas) and hand-curated 𝕏TV collections, resolved against the catalog.
People1 endpoint
Cast and crew, with their appearances resolved against the catalog.
Platform3 endpoints
Meta endpoints: catalog stats, change feeds for mirrors, and key introspection.