用 X 搜索 API 检索帖子
通过 HTTP 检索 X 帖子，每条结果直接带上账号 handle，不需要 X 开发者账号，也没有按套餐的帖子额度限制。
接口
结果的 JSON 结构与其他引擎一致，现有的解析逻辑不需要改动。
标题的形式是 OpenAI (@OpenAI)。
链接指向 x.com 上的原帖。
摘要就是帖子本身的文字。
适用于
官宣追踪 / 舆情分析 / 监控
官宣最先落地的地方
把 `search_service` 设为 `x`，结果就来自 X 的帖子。接口地址、鉴权方式和响应结构与其他引擎完全一致，整个过程不涉及 X 开发者账号。
标题里直接带 handle
`title` 字段包含显示名和 `@handle`，不用再发一次请求就能拿到账号。
摘要就是帖子正文
`snippet` 字段是帖子本身而不是对帖子的描述，对短官宣来说这通常就是完整答案。
不需要开发者账号，也没有帖子额度
请求按 Search1API 积分计费，而不是走 X 的 API 套餐，不用为月度帖子额度做规划。
标准 Search 参数
`max_results` 最大 50，以及 `include_sites`、`exclude_sites`、`time_range`。
什么是 X 搜索 API？
X 搜索 API 是一种 HTTP 接口，把 X 上的帖子以结构化结果返回。X 自己的 API 按付费档位售卖，并有月度帖子额度，探索性用途和小规模使用很难估算预算。Search1API 把 X 作为 Search 接口的一个搜索服务提供，标题里带显示名和 handle，另有帖子链接和作为摘要的帖子正文，JSON 结构与其他引擎一致。X 对 agent 之所以重要，是因为产品官宣、故障通告和价格调整常常先出现在这里，之后才进入公司博客或公开网页。
典型流程
通过 HTTP 检索 X 帖子，每条结果直接带上账号 handle，不需要 X 开发者账号，也没有按套餐的帖子额度限制。
把 `search_service` 设为 `x` 后发送查询。
从 `title` 读取账号，把 `snippet` 当作帖子正文处理。
当时效性是重点时，用 `time_range` 把结果限定在近期。
一次请求，带账号出处的帖子
一次调用即可检索 X 帖子，每条结果带上账号 handle，回答时可以把某个说法归到具体发布者。
bash
适合场景
需要在博客文章之前就拿到官宣的 AI 助手。
跨账号的品牌与竞品监控。
第一手信号是帖子而不是状态页的故障追踪。
围绕发布或调价的舆情分析。
常见问题
需要 X 开发者账号吗？
不需要。鉴权用的是 Search1API 的 key。请求是向 https://api.search1api.com/search 发 POST，把 `search_service` 设为 `x`。
和 X 官方 API 有什么区别？
X 按档位售卖访问权限，并设有月度帖子额度。Search1API 按自己的积分逐次请求计费，小规模和探索性使用不需要先承诺一个档位。代价是这里返回的是搜索结果，不覆盖发帖、流式订阅、账号管理等 X API 的完整能力。
可以拿到帖子或整个话题串的全文吗？
摘要就是帖子正文，对多数结果来说这已经是完整内容。当流程需要渲染后的页面时设置 `crawl_results`，成功抓取的页面会包含 markdown 格式的 `content` 字段。
X 搜索的费用是多少？
每次搜索消耗 1 积分，通过 `crawl_results` 每成功抓取一个页面追加 1 积分。按 $1 = 1,000 积分的充值基础价计算，1,000 次搜索为 $1。注册即送 100 个免费积分，无需信用卡。
可以只搜某个账号的帖子吗？
把 handle 写进查询词里。账号也会在标题中返回，因此也可以在拿到结果之后再过滤。
还支持哪些社区类来源？
同一个 Search 接口还支持讨论的 `reddit`、仓库的 `github` 和视频的 `youtube`，加上通用网页引擎和中文引擎，一套契约共 17 个引擎。