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
  }'

请求体

参数

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请求状态、标识、耗时和结果文件链接。
search_parameters本次请求使用的账号标识和分页参数。
user目标账号的公开资料字段。
tweets返回的公开帖子，包括正文和可用的互动数据。
next_cursor用于请求下一页的不透明游标。
异步响应search_metadata.status 为 Queued 或 Processing 时，将 search_metadata.id 用于 GET /v1/twitter/{search_id} 继续查询。

计费

积分消耗

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

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