Skip to content

REST API · v1 · JSON

The X resolver,
as an API.

One POST turns any public post link into post metadata and every MP4 rendition, with direct CDN URLs. The same pipeline behind this site, without the UI.

latency
~700 ms
cache
10 min
price
$19/mo
curl -X POST https://xvideo.download/api/parse \
  -H "Authorization: Bearer $XVD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://x.com/NASA/status/1783456789012345678",
    "mode": "video"
  }'
200 · application/json
{
  "statusId": "1783456789012345678",
  "authorHandle": "@NASA",
  "durationSeconds": 47,
  "qualities": [
    {
      "label": "1080p",
      "detail": "1920×1080",
      "url": "https://video.twimg.com/...",
      "recommended": true
    },
    { "label": "720p", "detail": "1280×720", "url": "..." }
  ]
}

Documentation

One endpoint, predictable shape

Send a public post URL. You get back the author, the post text, the duration and a sorted list of qualities. Nothing to poll, no job queue.

POST/api/parseapplication/json
url

Public post link — x.com, twitter.com or t.co.

stringrequired
mode

video · gif · mp3. Defaults to "video".

enumoptional
Authentication uses a bearer token. Keys are scoped per plan and can be rotated from the dashboard at any time.

Errors

400
invalid_url

The link is not an x.com or twitter.com post URL.

404
not_found

The post is deleted, private, or the ID is wrong.

422
no_media

The post contains no video, GIF or photos.

501
unsupported

MP3 was requested but no transcoder is configured.

429
rate_limited

Plan quota or burst limit exceeded. Retry after the header value.

502
upstream

X did not answer in time. Safe to retry with backoff.

Cached by status ID

Repeat posts return instantly for ten minutes.

No media re-hosting

URLs point straight at X's CDN, so downloads stay fast.

Key-scoped access

Rotate or revoke a key without touching the rest.

Pricing

Priced per parse, not per seat

Month-to-month, cancel whenever. Cache hits are cheap, so busy products rarely reach their quota.

Starter

$19/mo

For side projects and prototypes.

10,000 parses / month

  • 5 requests / second
  • Full quality list
  • 10-minute result cache
  • Email support
Start with Starter
Most popular

Growth

$49/mo

For products with real traffic.

50,000 parses / month

  • 20 requests / second
  • Priority parsing queue
  • Usage dashboard + webhooks
  • Slack support channel
Start with Growth

Scale

$139/mo

For apps that cannot miss.

250,000 parses / month

  • 100 requests / second
  • 99.9% uptime SLA
  • Custom cache TTL
  • Named engineer on call
Talk to us

Need a custom quota, on-prem deployment or a different media type? hello@xvideo.download

API FAQ

Before you integrate

The operational questions that come up in the first ten minutes of integration.

Still stuck? Email us and we'll take a look.

Yes. The API exposes the same parsing pipeline, with keys, higher rate limits and a usage dashboard layered on top.

Parsed posts are cached by status ID for ten minutes, which is why repeat requests usually return in a few milliseconds. Cache hits are billed at a fraction of a parse.

No. Every quality URL points at X's own CDN. Your download traffic never touches our servers, which is also why the service stays cheap.

Parsing failures trip an alert, and the resolver is updated before the window is usually noticed. During an incident the API returns 502 with a retry hint rather than a wrong payload.

Yes, within the terms: single-post resolution, no bulk scraping, and you remain responsible for how the media is used downstream.

Just want to download a video?

The web tool is free and needs no key.

Open the downloader