跳到导航

X 搜索结果怎么取下一页?

获取 X 搜索下一页时,再次调用 twitter.web.fetch_search_timeline,保持 keyword 和 search_type 不变,并将上一页响应中的 data.next_cursor 原样传入 params.cursor。第一页省略 cursor;更换搜索词或在 Top 与 Latest 之间切换时,从不带 cursor 的第一页重新开始。

例如第一页以品牌名和 search_type:"Latest" 搜索,第二页发送相同的品牌名、search_type:"Latest" 以及第一页返回的 data.next_cursor。完整流程见搜索与 CSV 导出。

何时停止,交付时怎样解释?

根据 coverage.json 中记录的停止状态决定下一步:

coverage.json 状态下一步能在报告里写什么
saved_batch_ended已保存批次到达末页;仅在预算允许时发送 next_params 获取下一页。已处理所保存的页面,结果属于抽样而非全量。
cursor_absent停止,不再发送请求。本次响应未返回续页游标;没有游标不能证明已覆盖全部历史。
repeated_cursor停止并核查原始响应文件。游标重复,继续翻页可能进入死循环。
empty_with_cursor停止并排查空结果。本页请求成功但返回零条帖子且附带游标,不要自动再买下一页。

HTTP 错误、业务失败、动作不匹配、缺少数组以及损坏的 JSON 均属于失败而非成功空页。请保留请求记录和原始响应字节,并按空结果排查定位原因。本流程不会自动重试。若在 empty_with_cursor 停止后获批进一步排查,应将排查请求存为新批次,不要接在已停止的游标链后。

两页预算是40条吗?

不是。两页预算限制的是请求次数,并不保证每页条数、去重后的独立帖子数或覆盖的时间范围。第二页可能与第一页出现重叠帖子,因此去重后行数减少不代表漏采。

按当前 Inspect 价格每次请求 $0.003 计算,两次成功请求估算 $0.006(不含重试与额外页)。遇到空页或缺失游标时应提前停止,不要为凑满两页花掉剩余预算。

已经存了JSON,怎么继续而不重复付费?

使用指南中的本地导出器 export_saved_x.py 处理已保存响应;拉取数据与导出本地响应属于两条独立流程。

  1. 在 pages.json 中记录每页的实际参数、查询时间和原始响应文件名。
  2. 运行 export_saved_x.py。export_saved_x.py 会在不联网的情况下校验每页 keyword 与 search_type 一致、游标依次衔接、请求号互不重复且采集时间有序,并输出 posts.csv、coverage.json、sources.json 及原始文件的逐字节副本。
  3. 续页前先查看 stop_reason。只有状态为 saved_batch_ended 且 next_params 有效时才准备续页,发送前仍需确认预算。
  4. 保存新响应后,将新一页的实际记录追加到 pages.json,再导出到新的输出目录。

不要为了增加 CSV 列或调整本地解析而重跑第一页采集。

重叠、时间和证据怎么写进报告?

posts.csv 保留每个原始 tweet_id 的首次观察;同一帖子的后续观察留在原始 JSON 中,重复条数记录在 coverage.json。不要用后一次抓取的点赞数覆盖首次观察值。

报告中须写明样本实际最早和最晚的 created_at 以及每一页的采集时间。两页样本的帖子数量不等于关键词的总提及量。文件哈希仅用于标识保存下来的字节,无法证明服务器真实性、采集时间准确性或数据完整性。

免费合同参考:data:twitter.web.fetch_search_timeline。