X 搜索

/twitter.search

使用完整高级搜索语法搜索 X（Twitter），可在查询中直接使用 from:、since:、until:、min_faves: 等运算符，获取含正文、作者和互动的结构化帖子，支持游标分页。limit 是每页上限；除非 requireSinglePage 选择批量通道，否则原生页面通常约有 20 条帖子。

最近 7 天完成的调用: 0

统计不包含取消的调用。执行时间仅统计成功调用。

文档（英文）

;;;;----=====++++++++=====----;;;::::····........                   .............···········............                             ......····:::::;;;;--------------;;;;;:::::······..................
;;;----===++++++++++++++====---;;;;:::·····.........             .................·····..............                                 ......····::::;;;;;--------------;;;;;:::::·······................
;;;---===++++++*****++++++===----;;;::::·····...................................·····.............                                     ......····::::;;;;;-------------;;;;;;::::::········.............
;;;---===++++*********+++++===---;;;;::::·····.............................···········...........                                       ......····::::;;;;;------------;;;;;;:::::::····················
;;;---===++++**********++++====---;;;;::::·······....................··················.........                                         ......····::::;;;;;;;------;;;;;;;;;:::::::····················
:;;;---===+++++*******+++++====----;;;:::::··········........···························........                                          ......····:::::;;;;;;;;;;;;;;;;;;:::::::::·················:::
::;;---====++++++++++++++++====---;;;;;:::::·····························::::::··········.......                                           ......·····::::::;;;;;;;;;;;;::::::::::················::::::
::;;;----====++++++++++++=====----;;;;:::::::····················:::::::::::::::::::······......                                            ......······:::::::::::::::::::::::··················:::::::
:::;;;;----=================----;;;;;;:::::::···············::::::::::::::::::::::::::·····......                                            ......·······::::::::::::::::·······················::::::;
·::::;;;-----===========------;;;;;;::::::::·············::::::::::;;;;;;;;;;;;;;;::::::·····.....                                           .......·············································::::::;
··::::;;;;;----------------;;;;;;::::::::···············:::::::::;;;;;;;;;;;;;;;;;;;;::::·····.....                                           ........························...........·········:::::;
···:::::;;;;;;;-----;;;;;;;;;::::::::···················:::::::;;;;;;;;---------;;;;;;::::·····.....                                          .........···············.......................······::::;
····::::::;;;;;;;;;;;;;;::::::::························:::::::;;;;;;--------------;;;;;::::····.....                                        .............·····................................·····::::
·····:::::::::::::::::::::::··········..........·········::::::;;;;;;---------------;;;;;:::·····.....                                     .....................................................·····:::
······:::::::::::::::::·········....................·······:::::;;;;;----------------;;;;::::····......                                  ..................................               ........·····:
······::::::::::::··········..........................······:::::;;;;;---------------;;;;;::::····......                              ..............·····...............                    ........····
······::::::::··········............          ..........······::::;;;;;--------------;;;;;::::·····.......                        ............·············............                       .......···
·····:::::::··········.........                   ........·····:::::;;;;;;---------;;;;;;:::::·····........                   ...........····················.........                          ......··
·:::::::::::········........                         .......·····:::::;;;;;;;;;;;;;;;;;;::::::·····...........          ............···········:::::··········.........                          .......
::::::::::::·······........                            .......·····::::::;;;;;;;;;;;;;::::::·······.............................········:::::::::::::::::·······.......                           ......
:::::::::::::······.......                               .......······::::::::::::::::::::········...........................·······:::::::;;;;;;;;;;:::::::·····.......                           .....
;;;;;;;;::::::·····......                                  .......·······::::::::::::::·········..........................······::::::;;;;;;;;;;;;;;;;;;;:::::·····......                          .....
---;;;;;;;;::::·····.....                                   ........·························...........................······:::::;;;;;--------------;;;;;:::::····.......                        .....
--------;;;;::::····......                                    .........·················...............................······::::;;;;------=========-----;;;;::::·····.......                      .....
=====-----;;;;:::····.....                                     ....................................          ..........·····::::;;;;----===============----;;;;::::····........                  .......
+=======----;;;:::····.....                                      ............................                  ........····::::;;;----=====++++++++++====----;;;::::·····.........            ..........
++++++====---;;;:::····.....                                      .....................                         .......····::::;;;---====++++++++++++++====---;;;;::::·····.............................
**++++++===---;;;:::···......                                     ................                                ......····:::;;;---===+++++++***++++++====---;;;;::::······.........................··
*****++++===---;;;:::···......                                    .............                                    .....····:::;;;---====+++++*****++++++====---;;;;::::········.................·······
******++++===--;;;:::····......                                 ............                                        .....····:::;;;---===+++++++**+++++++====----;;;;:::::······························
******++++===---;;;:::····......                            ................                                         .....···::::;;----===++++++++++++++=====----;;;;::::::························:::::
******++++===---;;;:::·····.......                     ......................                                         .....···:::;;;----=====+++++++++======----;;;;;:::::::·················:::::::::::
****+++++===----;;;::::····..........            .............................                                         ....····:::;;;;----================-----;;;;;:::::::::···········::::::::::::;;;;
+++++++====----;;;::::······...................................................                                        .....····::::;;;------=========-------;;;;;;:::::::::········:::::::::::;;;;;;;;;
+++=======----;;;:::::······...........................················.........                                        .....····::::;;;;;---------------;;;;;;;:::::::::··········::::::::::;;;;;;;;;--
======------;;;;:::::······.......................························.......                                       .....·····:::::;;;;;;;;;-;;;;;;;;;;;::::::::················::::::::;;;;;;;-----
--------;;;;;;:::::······......................···········::::::::::········.......                                     ......·····::::::;;;;;;;;;;;;;;::::::::······················:::::::;;;;;-------
;;;;;;;;;;::::::·······......................········:::::::::::::::::::······......                                    ......······::::::::::::::::::::::····························::::::;;;;;-------
;;;;;:::::::········........................·······:::::::::;;;;;;;:::::::······......                                 .......·······::::::::::::::::···········................········:::::;;;;;------
::::::::········............................······:::::::;;;;;;;;;;;;;;:::::·····.......                              .......·········:::::::::::··········........................······:::::;;;;------
::·········............           ..........······:::::;;;;;;;;;;;;;;;;;;:::::·····.......                          ........··········::::::···········..............    ............······::::;;;;;----
·······..........                    ........·····:::::;;;;;;;------;;;;;;;:::::·····.......                    ..........··········::::::··········...........                ........·····:::::;;;;;--
···..........                          .......····:::::;;;;;;---------;;;;;;:::::·····..........           ............·········::::::::::·········.........                      .......·····:::::;;;;;
..........                              ......·····::::;;;;;;----------;;;;;;:::::······...........................········::::::::::::::::·······........                          .......·····::::::;;
.......                                   ......····::::;;;;;;;-------;;;;;;;::::::·······....................·········:::::::::::::::::::::······.......                             .......·····::::::
......                                     ......····:::::;;;;;;;;;;;;;;;;;;;:::::::·········............·········::::::::;;;;;;;;;;;;;::::::·····......                                .......······:::
.....                                       ......····::::::;;;;;;;;;;;;;;;;::::::::··························:::::::;;;;;;;;;;;;;;;;;;;;:::::····......                                  .......·······
....                                          .....·····::::::;;;;;;;;;;;;:::::::::·······················:::::::;;;;;;---------------;;;;;::::····......                                  .........····

通过你的 Agent 使用

请安装 https://www.agentrouter.to/SKILL.md，然后通过 AgentRouter 使用 AnyAPI 的 /twitter.search 接口。

输入参数

limit选填: 请求的每页数量（1-50，默认 20）。部分数据源接受此值，其他源始终返回约 20 条的一整页原生结果。调用后不会裁剪页面，使用 nextCursor 可从本次响应结束位置准确继续。
query必填: 使用 X（Twitter）高级搜索语法的查询。注意：普通词按 AND 组合，帖子必须包含每个词，松散相关关键词列表可能无匹配；请使用一个短语，或以 OR 连接候选词（例如 'anyapi OR getanyapi'）。OR 列表后接运算符时，请给列表加括号，例如 '(anyapi OR getanyapi) -filter:replies'；否则 X 仅对最后一个候选词应用运算符。此类查询仍按 X 的解读执行，响应 hint 会包含修正查询。可直接嵌入高级运算符：from:username、to:username（作者或接收者），since:YYYY-MM-DD、until:YYYY-MM-DD（日期范围），min_faves:N、min_retweets:N、min_replies:N（互动下限），"exact phrase"（精确短语），-term（排除），filter:media、filter:links、-filter:replies（内容筛选），lang:en、near:city、geocode:lat,long,radius。示例：'from:OpenAI'、'AI agents min_faves:500 -filter:replies'、'nvidia since:2026-01-01 until:2026-03-01'。无匹配时返回空 items 数组；优先使用能识别主题的最少词语。
cursor选填: 上一响应 nextCursor 中的不透明分页游标。首页省略；获取下一页搜索结果时传入。
queryType选填: 返回帖子类型：'Latest'（最新优先，默认）、'Top'（最热门）、'Photos'（最新含图片帖子）或 'Videos'（最新含视频帖子）。Photos 和 Videos 按原查询附加 filter:images 或 filter:videos 搜索，因此价格与 Latest 搜索相同。
requireFields选填: 可选；省略时保持原路由，由最便宜的数据源提供结果。指定本次请求必须能够返回的字段，如 `nextCursor`；只会使用能提供全部指定字段的数据源。未指定的字段，只要当前数据源提供，也仍会返回。这可能提高费用：若最便宜的数据源无法返回指定字段，会改用较贵的数据源，并按该来源的价格报价和计费。若帖子本身确实没有某个指定字段，该字段仍可能缺失。若指定的字段组合无法由任何单一数据源同时提供，会作为无效输入拒绝且不计费。分页查询时仅对第一页应用；后续页继续使用第一页所选的数据源及其报价。
requireSinglePage选填: 设为 true，在一个响应中获取最多 limit 条结果，而非服务商原生分页；必要时由批量服务商响应。
preferLatencyUnderMs选填: 可选；省略时保持原路由，由最便宜的数据源提供结果。优先选择典型响应时间低于指定毫秒数的数据源，再从中选择最便宜的一个；典型响应时间指该接口数据源健康信息公布的过去 30 天响应时间中位数。这可能提高费用：如果最便宜的数据源无法达到目标，会改用更快但更贵的数据源，并按该来源的价格报价和计费。若没有数据源满足速度目标，仍会选择性价比最高的数据源完成请求，不会仅因速度慢而拒绝。尚未计时的数据源最后尝试。这只是偏好，不是保证：中位数描述历史请求，不是本次请求的耗时上限，也不包括请求本身要求的等待时间。对分页查询，该偏好仅用于第一页；后续页继续使用第一页所选的数据源及其报价。
source选填: 可选。按优先顺序指定数据源 ID，取值来自 /catalog 或 /apis 中该接口的 `lanes[].source.id`。省略时使用最便宜的数据源，并支持自动故障切换。除非 `allowFallbacks` 为 false，否则先按给定顺序尝试列表中的来源，再尝试其他来源。仅指定一个来源且将 `allowFallbacks` 设为 false 时，只会由该来源按其价格提供结果，准确报价和计费，不会切换。报价取所有可能被使用的数据源中的最高价。不支持该接口的数据源 ID 会作为无效输入拒绝且不计费；列表中当前不可用的数据源也会被拒绝且不计费，省略 `source` 可改用其他来源。分页查询的后续请求必须继续包含第一页使用的数据源，或省略 `source`。
allowFallbacks选填: 可选，默认为 true。设为 false 时，只允许 `source` 中列出的来源提供结果；若没有来源能提供服务，则拒绝请求且不计费。设为 true 时先尝试列出的来源，之后可按正常价格尝试其他来源。
ignoreSources选填: 可选。指定本次请求要跳过的数据源 ID，取值来自该接口的 `lanes[].source.id`。使用剩余来源中最便宜的一个，报价则取剩余来源中的最高价。不支持该接口的数据源 ID，或同时出现在 `source` 中的 ID，都会作为无效输入拒绝且不计费；跳过全部来源也会以同样方式拒绝。

输入示例

{
  "query": "openai"
}

输出

AnyAPI 输出：found （布尔值）, data.items （一页结果），以及用于下一页的 data.nextCursor；未找到结果时包含 reason。