EasyDown REST API platform guide
Both x.com and twitter.com status links enter the same REST workflow. Large status IDs stay strings and all returned media variants are preserved for backend selection.
Parse public x.com and twitter.com status URLs with the EasyDown Twitter Download API and receive every available video bitrate, post image, thumbnail, and metadata candidate.
Twitter video download API · X video download API
Production REST endpoint
POST https://api.easydown.org/api/v1/parsex.com/{user}/status/{id}twitter.com/{user}/status/{id}x.com/i/status/{id}https://x.com/Taozhishuishui/status/2041638397358260556/video/1
curl -X POST https://api.easydown.org/api/v1/parse \
-H "Authorization: Bearer ed_live_xxx" \
-H "Content-Type: application/json" \
-d '{"url":"https://x.com/Taozhishuishui/status/2041638397358260556/video/1"}'The shared envelope stays stable while this platform determines which media arrays and attributes are populated.
Video posts can return multiple bitrate and dimension variants. Image posts keep every post image; thumbnails are not substituted for full post media.
{
"status": 200,
"data": {
"platform": "twitter",
"title": "Example twitter public post",
"thumbnail": "https://cdn.example.com/thumbnail.jpg",
"duration": 24,
"images": [
{
"url": "https://cdn.example.com/content-image.jpg",
"width": 1080,
"height": 1350
}
],
"videos": [
{
"url": "https://cdn.example.com/video.mp4",
"quality": "HD",
"mimeType": "video/mp4",
"width": 1080,
"height": 1920,
"hasAudio": true,
"source": "direct"
}
],
"audios": []
},
"msg": "success"
}Fetch selected media from your backend with Referer: https://x.com/ and a browser User-Agent. Forward Range for large files and re-parse if a selected variant expires.
User-Agent: Mozilla/5.0
Referer: https://x.com/
Range: bytes=0-Profiles, search pages, Spaces, Communities, Broadcast URLs, private posts, deleted posts, and direct CDN URLs are unsupported.
Only process public media you have the right to use. EasyDown does not bypass privacy controls, DRM, deleted content, or platform access restrictions.
Submit a status URL containing one post ID.
Choose a videos[] variant by quality and dimensions instead of array position alone.
Re-parse the original status when a media variant stops responding.
Create a private API token and allow this platform in its permissions.
POST one complete public post URL to the shared endpoint.
Select and proxy the required items from images, videos, and audios.
Use the MCP endpoint for AI agents, or open the browser tool for a manual public-media workflow.
Supported public single-post formats include x.com/{user}/status/{id}, twitter.com/{user}/status/{id}, x.com/i/status/{id}. Profiles, search pages, Spaces, Communities, Broadcast URLs, private posts, deleted posts, and direct CDN URLs are unsupported.
Video posts can return multiple bitrate and dimension variants. Image posts keep every post image; thumbnails are not substituted for full post media.
Fetch selected media from your backend with Referer: https://x.com/ and a browser User-Agent. Forward Range for large files and re-parse if a selected variant expires.
A response containing at least one image, video, or audio URL costs 1 credit. Failed, unsupported, authentication, and empty-media results do not consume credits.