TwitterDown API v1

概览

TwitterDown API 为开发者提供稳定的 Twitter/X 视频解析能力，适合自动化流程、媒体归档、内容运营和内部工具集成。

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

认证与安全

所有请求都必须在 Authorization 头中携带有效 API Key。密钥与账户绑定，可随时在控制台中吊销。

Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxx

API Key

1. 登录 TwitterDown 并开通支持 API 的套餐。
2. 打开 Dashboard > API Keys。
3. 创建一个与应用或环境对应的 API Key 标签。

API Key 只会展示一次，请在离开页面前保存到安全的密钥管理工具中。

核心端点

POST /twitter

POST /twitter 用于解析公开 Tweet 链接，并返回缩略图、视频清晰度、推文文本、用户名和状态 ID。

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 text",
    "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。超出配额时，API 会返回 HTTP 429 与 Retry-After。

错误处理

所有错误都以 JSON 返回，包含数字错误码和可读的错误信息。

{
  "code": -1,
  "message": "Readable error message"
}

请求示例

以下示例可直接用于后端接入、自动化脚本和内部开发工具。

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();

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())

想看更多接入思路？ 浏览博客中的 API 指南 查看集成范式、发布说明和工作流示例。