Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
还没有输出。提交表单以生成内容。
透明定价，无隐藏费用。按需支付。
| 规则与模式 | 渠道 | 积分 | 价格（美元） | 官方/参考价格 | 每日节省 |
|---|---|---|---|---|---|
search-timeline otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 使用完整指南
以编程方式搜索 Twitter 时间线，并按关键词、话题标签或高级查询检索实时推文结果。
ApiPass 上的 Twitter Graphql Search Timeline API 是一个基于任务的端点，允许开发者通过 Twitter 原生客户端使用的同一 GraphQL schema 查询 Twitter（X）的搜索时间线。通过向 /api/v1/jobs/createTask 发送 POST 请求，并将 model 设置为 twitter/graphql/search-timeline，你可以提交原始搜索查询（关键词、话题标签、运算符或用户账号），并接收包含匹配推文、作者资料、媒体实体、互动指标和分页游标的结构化 JSON 载荷。该 API 支持 Latest 等多种结果模式，并返回完整的 GraphQL 响应，让你获得与 Twitter 自身搜索界面相同深度的数据，而无需处理 OAuth、速率限制或抓取基础设施的复杂性。
跳过冗长的申请、审核和高级访问权限流程。一个 ApiPass API key 即可立即解锁该端点。
获取与 Twitter 原生 Web 客户端使用的完全相同的丰富数据结构，包括 tweet_results、user_results、媒体 variants、浏览量和高亮范围。
使用默认的 channel: auto 设置时，ApiPass 会根据实时价格和稳定性，在 starter、regular 和 official 提供商之间自动均衡你的请求，以获得最佳成本与可靠性比。
提交搜索任务，并通过轮询或 callBackUrl 接收回调，非常适合大规模抓取、批处理流水线和长时间运行的工作负载。
使用 cursor 参数遍历单页返回结果之外的数千条匹配推文。
选择适合你预算的提供商层级：超低成本的 starter、兼具成本效率的 regular，或定价与 Twitter 自身服务一致且稳定性更高的 official。
rawQuery 参数可接受从简单关键词（"twitter"）到复杂 Twitter 搜索运算符、话题标签、from: 过滤器、日期范围和语言标记等各种输入。
通过 product 参数在 Latest 等搜索产品之间切换，以检索按时间排序的最新推文，并使用 count（默认 40）控制页面大小。
每条记录都包含完整文本、媒体（图片、GIF、视频 variants）、用户资料详情、时间戳、回复/转推/收藏数、浏览量以及会话线程字段。
监控品牌提及、竞品动态或突发新闻关键词，并将其呈现在分析工具中。
将原始推文流输入 NLP 模型，以跟踪围绕产品、选举或市场事件的情绪变化。
监控 cashtags（$BTC、$TSLA）或意见领袖账号，并在相关推文出现时触发提醒、交易或 Discord/Telegram 通知。
按话题标签或主题自动整理推文嵌入内容，用于博客、实时活动页面和记者研究仪表盘。
比较 ApiPass 与 Twitter 官方开发者平台在访问要求以及搜索请求返回数据深度方面的差异。
Twitter 官方 v2 Search API 要求在发起任何请求之前先订阅付费开发者方案（Basic、Pro 或 Enterprise 层级）、通过项目审批，并完成 OAuth 2.0 设置。ApiPass 只需要一个 Bearer API key——注册后几分钟内即可创建任务，基础搜索访问无需任何门槛层级。
Twitter 官方 REST v2 端点返回的是扁平化、按字段选择的 JSON，受你请求的 tweet.fields / user.fields 限制，并会省略许多内部信号。ApiPass 返回原始 GraphQL 响应（search_by_raw_query.search_timeline.timeline.instructions），与 Twitter 自身 Web 客户端保持一致，可暴露更丰富的对象，例如 views.count、edit_control、highlights.textHighlights、clientEventInfo 以及完整媒体 video_info.variants——这些数据在官方 API 中要么被隐藏，要么需要高级层级才能访问。
持续搜索与你的公司、产品 SKU 或高管相关的提及，并将负面情绪路由到客户支持工作流。
围绕特定主题、话题标签或地理位置，收集大规模历史或实时推文数据集，用于定量研究。
搜索垂直领域关键词，按 followers_count、favourites_count 和互动表现对结果作者进行排名，识别细分领域中的新兴声音。
搜索竞品活动话题标签或口号，对平台上的覆盖范围、互动表现和正在使用的创意角度进行基准分析。
在 ApiPass 注册，并从你的仪表盘生成 Bearer token。这个单一 key 可用于验证你的所有请求，因此无需 OAuth 流程或 Twitter 开发者申请。
向 /api/v1/jobs/createTask 端点发送 POST 请求，将 model 设置为 twitter/graphql/search-timeline，并在 input.variables 中包含你的搜索参数——至少需要 rawQuery，也可以加入 count、product 和 cursor 等可选字段。你也可以提供 callBackUrl，以便在任务完成时接收推送通知。
使用 Step 2 返回的 taskId 查询 /api/v1/jobs/recordInfo 端点。当任务状态变为 success 后，解析 resultJson 字段以获取完整的匹配推文列表，并根据需要使用返回的分页 cursor 获取更多页面。
所有 API 都需要通过 Bearer Token 进行身份验证。
Authorization: Bearer
搜索时间线。
该 API 接受以下结构的 JSON payload：
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "variables": {
7 "rawQuery": "string",
8 "count": "number",
9 "cursor": "string",
10 "querySource": "string",
11 "product": "string",
12 "includePromotedContent": "boolean",
13 }
14 }
15}model必填string用于生成的模型名称
"twitter/graphql/search-timeline"
callBackUrl可选string用于任务完成通知的回调 URL。如果省略，则不会发送回调。
"https://your-domain.com/api/callback"
channel可选string你可以通过 channel 参数指定 APIPASS 中对应的提供商；这些提供商负责处理实际的图像和视频生成任务。APIPASS 目前提供三种提供商选项：
channel 参数的默认值为 auto。启用后，APIPASS 会根据实时价格和稳定性指标，在可用提供商之间自动分配任务，以平衡最低成本和可靠性能。除非你有自定义路由需求，否则请保留默认值 auto。
可用选项：
auto
input 对象包含以下参数：
input.variables.rawQuery必填stringinput.variables.count可选number40
input.variables.cursor可选stringinput.variables.querySource可选stringtyped_query
input.variables.product可选stringLatest
input.variables.includePromotedContent可选booleanfalse
1curl -X POST "https://api.apipass.dev/api/v1/jobs/createTask" \
2 -H "Content-Type: application/json" \
3 -H "Authorization: Bearer YOUR_API_KEY" \
4 -d '{
5 "model": "twitter/graphql/search-timeline",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "variables": {
9 "rawQuery": "twitter",
10 "count": 40,
11 "cursor": "",
12 "querySource": "typed_query",
13 "product": "Latest",
14 "includePromotedContent": false,
15 }
16 }
17 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}code状态码，200 表示成功，其他表示失败
message响应消息，失败时为错误描述
data.taskId用于查询任务状态和结果的任务 ID
