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"
}'{
"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.
/api/parseapplication/jsonurlPublic post link — x.com, twitter.com or t.co.
modevideo · gif · mp3. Defaults to "video".
Errors
- 400
invalid_urlThe link is not an x.com or twitter.com post URL.
- 404
not_foundThe post is deleted, private, or the ID is wrong.
- 422
no_mediaThe post contains no video, GIF or photos.
- 501
unsupportedMP3 was requested but no transcoder is configured.
- 429
rate_limitedPlan quota or burst limit exceeded. Retry after the header value.
- 502
upstreamX 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
Growth
$49/mo
For products with real traffic.
50,000 parses / month
- 20 requests / second
- Priority parsing queue
- Usage dashboard + webhooks
- Slack support channel
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
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.