文档

TwitterDown API v1

通过一个标准化的 POST /twitter 端点，解析 Twitter/X 视频信息。所有响应均返回结构化 JSON，并附带速率限制 header。

概览

TwitterDown API 提供对 Twitter/X 视频贴文的程序化解析能力。最适合需要批量下载视频、内容归档、生成二次创作素材的团队。

基地址：https://twitterdown.com/api/v1
认证方式：Bearer Token（API Key）
响应格式：application/json

认证与安全

所有请求必须在 HTTP Authorization 头中携带有效 API Key。Key 与用户账户绑定，可在 Dashboard 中随时吊销。

Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxx

获取 API Key

登录 TwitterDown 主站并完成付费订阅。
打开 Dashboard > API Keys。
创建新的 Key，命名方便识别的标签。

提示：为了安全，API Key 仅显示一次。请立即保存至安全的密钥保管工具。

核心端点

POST /twitter

解析包含视频的 Tweet 链接，返回多清晰度资源。

POST https://twitterdown.com/api/v1/twitter
Content-Type: application/json
Authorization: Bearer sk-xxxx

{
  "url": "https://x.com/username/status/1234567890123456789"
}

成功响应 (200)：

{
  "code": 0,
  "message": "ok",
  "data": {
    "thumbnail": "https://pbs.twimg.com/...jpg",
    "videos": [
      { "resolution": "720p", "quality": "HD", "url": "https://video.twimg.com/..." },
      { "resolution": "360p", "quality": "SD", "url": "https://video.twimg.com/..." }
    ],
    "text": "Tweet 文本内容",
    "username": "username",
    "statusId": "1234567890123456789",
    "processed_at": "2024-01-01T12:00:00.000Z"
  }
}

GET /twitter

返回文档/元数据，用于 SDK 与集成自动化读取。

速率限制

60 请求 / 分钟
1,000 请求 / 小时
10,000 请求 / 天

响应头包含 X-RateLimit-Limit,X-RateLimit-Remaining 和 X-RateLimit-Reset。当超过限制时，会返回 HTTP 429，并附带 Retry-After 秒数。

错误处理

所有错误均返回 JSON：

{
  "code": -1,
  "message": "错误描述"
}

状态码	含义
400	请求参数缺失或格式错误
401	API Key 缺失或无效
403	非付费用户调用了受限接口
422	URL 无法解析
429	超出速率限制
500	服务内部错误

请求示例

多语言示例可以帮助你快速集成：

JavaScript (fetch)

const res = await fetch("https://twitterdown.com/api/v1/twitter", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer sk-xxxx"
  },
  body: JSON.stringify({ url })
});
const data = await res.json();

Python (requests)

resp = requests.post(
  "https://twitterdown.com/api/v1/twitter",
  headers={
    "Authorization": "Bearer sk-xxxx",
    "Content-Type": "application/json",
  },
  json={"url": tweet_url},
)
print(resp.json())

想查看完整的 cURL、PHP、更多示例？阅读我们的官方博客文章。