Endpoints
Meta endpoints: catalog stats, change feeds for mirrors, and key introspection.
/api/v1/statsHeadline numbers.
Total titles, movies, series, how many are deliverable in the library, people and curated collections.
$curl -H "Authorization: Bearer xtvdb_YOUR_KEY" \
"https://xtvdb.com/api/v1/stats"
Returns { data: { titles, movies, series, available_in_library, people, xtv_collections } }
/api/v1/changesWhat changed since a timestamp.
Every catalog entry created or updated after the given Unix time, oldest first, 200 per page. Poll this instead of re-crawling if you mirror the catalog. Window capped at 30 days.
| Parameter | In | Required | Description |
|---|---|---|---|
| since | query | yes | Unix timestamp (seconds), at most 30 days in the past. |
$curl -H "Authorization: Bearer xtvdb_YOUR_KEY" \
"https://xtvdb.com/api/v1/changes?since=1751500000"
Returns { data: [{ xtv_id, media_type, title, updated_at, has_bundles }], meta: { has_more, next_since } }
Page by feeding meta.next_since back as ?since= until has_more is false.
/api/v1/meIntrospect the key you are calling with.
Your project name, plan, limits and whether attribution is required. The only endpoint whose response is about you.
$curl -H "Authorization: Bearer xtvdb_YOUR_KEY" \
"https://xtvdb.com/api/v1/me"
Returns { data: { project_name, key_prefix, plan: { id, name, requests_per_minute, requests_per_day, commercial_use }, attribution_required } } (never cached)