X (Twitter) — 搜索
SpiderHubs OpenAPI 文档：X (Twitter) — 搜索，分类 X (Twitter)。接口 GET /openapi/v1/contentcreator/twitter/web/fetch_search_timeline。关键词搜索推文 / 用户，支持 X 高级搜索语法（如 from:、...
OpId:
tw-search · 最近更新: 2026-05-23说明
关键词搜索推文 / 用户，支持 X 高级搜索语法（如 from:、since:）。
基础信息
- Endpoint:
- GET /openapi/v1/contentcreator/twitter/web/fetch_search_timeline
- 计费:
- 1 积分 / 次
- 限流:
- 300 次 / 分钟 / 用户
请求参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| keyword | string | 是 | 搜索关键词 |
| search_type | string | 否 | 搜索类型：Top（默认）/ Latest / People / Media |
| cursor | string | 否 | 翻页游标 |
响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| code | int | 业务状态码，200 表示成功 |
| request_id | string | 本次请求唯一标识，排查问题时可提供 |
| data | object | 业务数据容器，具体字段见下 |
| data.timeline | array | 推文列表，单条字段同「推文详情」（tweet_id / text / favorites / retweets / replies / views / media / author ...） |
| data.timeline[].quoted | object | 被引用的推文（若有） |
| data.next_cursor | string | 下一页游标，传回 cursor 参数翻页 |
| data.prev_cursor | string | 上一页游标 |
请求示例 · cURL
curl 'https://api.spiderhubs.com/openapi/v1/contentcreator/twitter/web/fetch_search_timeline?keyword=AI+agents&search_type=Top' \
-H 'Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxx'响应示例
{
"code": 200,
"request_id": "...",
"data": { /* platform-native data — see endpoint reference for shape */ }
}开始调用 SpiderHubs API
使用账户中心生成的 API Key，通过 Authorization: Bearer sk_live_xxx 调用接口。