Endpoints
Find titles by text the way the website does, or resolve external ids directly.
/api/v1/searchFull-strength title search.
The same engine the website uses: prefixes (“Rook” → The Rookie), substrings, German title aliases, multi-word relevance, and boosts for titles available in the 𝕏TV library.
| Parameter | In | Required | Description |
|---|---|---|---|
| q | query | yes | Query text, 2–100 characters. |
$curl -H "Authorization: Bearer xtvdb_YOUR_KEY" \
"https://xtvdb.com/api/v1/search?q=the%20rookie"
Returns { data: Title[] }
/api/v1/lookup/{provider}/{id}External id → catalog title.
Resolve an IMDb, TMDb or TVDb id straight to the catalog entry. The fastest way to bridge an existing dataset onto 𝕏TV ids.
| Parameter | In | Required | Description |
|---|---|---|---|
| provider | path | yes | imdb | tmdb | tvdb |
| id | path | yes | The provider's id, e.g. tt0903747 (IMDb) or 1396 (TMDb). |
$curl -H "Authorization: Bearer xtvdb_YOUR_KEY" \
"https://xtvdb.com/api/v1/lookup/imdb/tt0903747"
Returns { data: Title }