SukidataSukidata

WEB DATA

Twitter 用户时间线

获取一个 Twitter 账号的公开帖子和个人资料信息。

POSThttps://api.sukidata.com/v1/twitter

快速开始

发送请求

使用用户名或数字用户 ID 指定账号。默认每页最多返回 20 条帖子。

cURL
curl --request POST \
  --url https://api.sukidata.com/v1/twitter \
  --header "Authorization: Bearer $SUKIDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "username": "Cloudflare",
    "max_results": 20
  }'

在 Playground 中试用 →

请求体

参数

username 和 user_id 必须且只能提供其中一个。

username字符串 · 二选一必填

Twitter 用户名，可带或不带 @。

user_id字符串 · 二选一必填

Twitter 数字用户 ID。

max_results整数

本页最多返回的帖子数量，可选 1 至 100，默认值为 20。

cursor字符串

上一页响应中返回的不透明 next_cursor 值。

async布尔值

设为 true 时立即返回搜索 ID，稍后查询结果；默认为 false。

在 API 参考中查看完整 Twitter 请求结构

响应

时间线结果

完成的响应会包含账号信息、公开帖子，以及下一页可用时返回的游标。

以下示例包含一条帖子。可选的用户资料与互动字段以实际可获取的数据为准。

响应示例
{
  "search_metadata": {
    "id": "twitter_example",
    "status": "Success",
    "created_at": "2026-09-22T00:00:00Z",
    "total_time_taken": 1.1
  },
  "search_parameters": {
    "engine": "twitter",
    "username": "Cloudflare",
    "max_results": 20
  },
  "user": {
    "id": "123456789",
    "username": "Cloudflare",
    "name": "Cloudflare"
  },
  "tweets": [
    {
      "id": "1234567890123456789",
      "text": "Example post content.",
      "created_at": "2026-09-21T09:00:00Z"
    }
  ],
  "next_cursor": "example_next_page_cursor"
}
search_metadata请求状态、标识、耗时和结果文件链接。
search_parameters本次请求使用的账号标识和分页参数。
user目标账号的公开资料字段。
tweets返回的公开帖子，包括正文和可用的互动数据。
next_cursor用于请求下一页的不透明游标。
请求仍在处理？search_metadata.status 为 Queued 或 Processing 时，将 search_metadata.id 用于 GET /v1/twitter/{search_id}，查询至 Success 或 Error。同步请求等待结束后也可能出现此情况，查询进度无需重新提交同一页。

请求下一页

把上一页响应的 next_cursor 填入 cursor，账号保持不变。请将下方示例游标替换为实际返回的值，不要自行解析或构造。响应不再包含 next_cursor 时停止翻页。每一页都是独立请求。

cURL
curl --request POST \
  --url https://api.sukidata.com/v1/twitter \
  --header "Authorization: Bearer $SUKIDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "username": "Cloudflare",
    "max_results": 20,
    "cursor": "example_next_page_cursor"
  }'

计费

积分消耗

Twitter 使用 Web Data 积分，最终费用以 X-Sukidata-Credits-Used 为准。单价与免费响应规则见 Web Data 计费说明。

请求遇到问题？请将 X-Request-ID 响应头一并发送至 support@sukidata.com。

处理错误

  • 400：账号标识只能提供一个，max_results 需在 1 至 100 之间。
  • 401：检查 API Key；402：补充 Web Data 积分。
  • 503：服务暂时不可用，稍后再试。

HTTP 200 响应中 search_metadata.status 为 Error 表示搜索失败，请查看 error 对象。Success 且 tweets 为空，表示本页没有可获取的帖子。