媒体下载与代理规则
后端下载时携带 X Referer 与浏览器 User-Agent，大文件透传 Range；所选规格过期后重新解析。
建议的后端请求头
User-Agent: Mozilla/5.0
Referer: https://x.com/
Range: bytes=0-EasyDown REST API 平台指南
Twitter / X 视频下载 API
x.com 与 twitter.com 的 status 链接进入同一 REST 流程，大整数帖子 ID 始终按字符串处理，并保留全部媒体规格。
使用 EasyDown Twitter / X 视频下载 API 解析公开 status 链接，获取全部可用视频码率、帖子图片、缩略图与元数据候选。
Twitter 视频解析 API · X 视频下载 API
生产环境 REST Endpoint
POST https://api.easydown.org/api/v1/parse支持的公开 URL 格式
x.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"}'平台专属响应示例
统一响应外层保持稳定；具体平台决定哪些媒体数组和属性会被填充。
媒体返回行为
视频帖子可能返回多种码率和尺寸；图片帖子会保留全部正文图片，不会用缩略图替代原媒体。
{
"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"
}不支持或不可用的内容
不支持主页、搜索页、Spaces、社区、Broadcast、私密帖子、已删除帖子和 CDN 直链。
只处理你有权使用的公开媒体。EasyDown 不绕过隐私设置、DRM、已删除内容或平台访问限制。
平台专属排错
提交包含单个帖子 ID 的 status URL。
按清晰度和尺寸选择 videos[]，不要只依赖数组位置。
媒体规格失效时重新解析原始 status。
REST 集成流程
- 1
创建私有 API Token，并在权限中允许该平台。
- 2
把一个完整的公开作品 URL POST 到统一 Endpoint。
- 3
从 images、videos、audios 中选择所需媒体并通过后端代理。
下载 API 常见问题
Twitter / X 下载 API 支持哪些 URL？
支持的公开单条作品格式包括 x.com/{user}/status/{id}, twitter.com/{user}/status/{id}, x.com/i/status/{id}。不支持主页、搜索页、Spaces、社区、Broadcast、私密帖子、已删除帖子和 CDN 直链。
Twitter / X 下载 API 会返回哪些媒体？
视频帖子可能返回多种码率和尺寸；图片帖子会保留全部正文图片，不会用缩略图替代原媒体。
应用应该如何下载返回的 Twitter / X 媒体 URL？
后端下载时携带 X Referer 与浏览器 User-Agent，大文件透传 Range；所选规格过期后重新解析。
Twitter / X API 成功请求如何扣费？
成功返回至少一条图片、视频或音频 URL 时扣 1 credit；失败、不支持、鉴权错误和空媒体结果不扣 credits。