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 中记录的停止状态决定下一步:
HTTP 错误、业务失败、动作不匹配、缺少数组以及损坏的 JSON 均属于失败而非成功空页。请保留请求记录和原始响应字节,并按空结果排查定位原因。本流程不会自动重试。若在 empty_with_cursor 停止后获批进一步排查,应将排查请求存为新批次,不要接在已停止的游标链后。
两页预算是40条吗?
不是。两页预算限制的是请求次数,并不保证每页条数、去重后的独立帖子数或覆盖的时间范围。第二页可能与第一页出现重叠帖子,因此去重后行数减少不代表漏采。
按当前 Inspect 价格每次请求 $0.003 计算,两次成功请求估算 $0.006(不含重试与额外页)。遇到空页或缺失游标时应提前停止,不要为凑满两页花掉剩余预算。
已经存了JSON,怎么继续而不重复付费?
使用指南中的本地导出器 export_saved_x.py 处理已保存响应;拉取数据与导出本地响应属于两条独立流程。
- 在
pages.json中记录每页的实际参数、查询时间和原始响应文件名。 - 运行
export_saved_x.py。export_saved_x.py会在不联网的情况下校验每页keyword与search_type一致、游标依次衔接、请求号互不重复且采集时间有序,并输出posts.csv、coverage.json、sources.json及原始文件的逐字节副本。 - 续页前先查看
stop_reason。只有状态为saved_batch_ended且next_params有效时才准备续页,发送前仍需确认预算。 - 保存新响应后,将新一页的实际记录追加到
pages.json,再导出到新的输出目录。
不要为了增加 CSV 列或调整本地解析而重跑第一页采集。
重叠、时间和证据怎么写进报告?
posts.csv 保留每个原始 tweet_id 的首次观察;同一帖子的后续观察留在原始 JSON 中,重复条数记录在 coverage.json。不要用后一次抓取的点赞数覆盖首次观察值。
报告中须写明样本实际最早和最晚的 created_at 以及每一页的采集时间。两页样本的帖子数量不等于关键词的总提及量。文件哈希仅用于标识保存下来的字节,无法证明服务器真实性、采集时间准确性或数据完整性。
免费合同参考:data:twitter.web.fetch_search_timeline。

