← 开发者

REST API

支撑网站、CLI 认证流程和 MCP 服务器的简洁 JSON HTTP API。

Base URL

https://xvideodownloader.org

认证

匿名请求可在匿名额度内进行基础下载。如需长期账号（更高额度、下载记录、SVIP），请发送 Authorization: Bearer <token>——token 可通过 CLI 的 auth login 命令或在网站登录获得。

频率限制

免费套餐（匿名或注册）：每天 2 次下载，最高 720p，单文件 25MB。终身 SVIP：无每日上限，不限画质和大小。匿名请求按 IP 计算，登录后按账号计算。

接口

POST/api/download

根据 X/Twitter 帖子 URL 创建下载任务。

GET/api/downloads/{id}

获取下载任务的状态和元数据。

GET/api/file/{id}

302 跳转到已下载的文件。带上 ?dl=1 会计入每日额度；不带则为只读预览。

GET/api/downloads

列出你的下载记录。需要认证。

DELETE/api/downloads/{id}

删除一条下载记录。无法删除正在运行的任务。

GET/api/user/usage

今日用量与套餐每日上限的对比。

GET/api/user/subscription

当前套餐；老订阅用户还会返回订阅状态。

错误码

EMPTY_URL未提供 URL
INVALID_URL_FORMATURL 不是以 http(s) 开头
UNSUPPORTED_HOST仅支持 x.com 和 twitter.com
RATE_LIMIT已达每日下载上限
FILE_SIZE_LIMIT视频超出套餐的文件大小限制
VIDEO_NOT_FOUND找不到视频或无法解析
PRIVATE_TWEET该帖子为私密或受保护
GEO_BLOCKED源内容有地区限制

示例

创建下载，然后轮询直到完成：

curl -X POST https://xvideodownloader.org/api/download \
  -H "Content-Type: application/json" \
  -d '{"url": "https://x.com/user/status/123456789"}'

OpenAPI 规范

OpenAPI 3.0 格式的完整请求/响应 schema，可用于代码生成或导入 API 工具：

/openapi.json →