SerpHubAPI

结果存档

GET /v1/searches/{id}——30 天内回看任意一次历史搜索的完整结果。

GET https://api.serphubapi.com/v1/searches/{id}

每次成功的搜索(包括空结果)都会存档 30 天。用 meta.id(Markdown 响应则取 X-Search-Id 响应头)即可拿回当时的完整返回——排查问题、复现答案、审计 agent 当时看到了什么,都用得上。查询存档不计费。

请求参数

参数位置说明
idpath调用 ID,如 sch_01J9Z3KQ8W。
curl https://api.serphubapi.com/v1/searches/sch_01J9Z3KQ8W \
  -H "X-API-Key: shapi_xxxxxxxx"

返回结果

与原搜索返回的 JSON 相同,另加 created_at:

{
  "meta": { "id": "sch_01J9Z3KQ8W", "status": "success", "engine": "google", "cached": false, "credits_charged": 10, "time_ms": 812 },
  "params": { "q": "best espresso machine 2026", "engine": "google", "type": "web", "num": 10, "page": 1, "mode": "live" },
  "results": { "organic": [ ... ] },
  "created_at": "2026-10-23T08:15:42.120000+00:00"
}

如果原调用使用了 include_content,content 数组也会一并返回。

说明

  • 只能查询本账户(任意 Key)发起的调用。
  • 失败的调用不存档,没有可返回的内容。
  • /v1/fetch 的结果不存档。
  • 超过 30 天后记录被删除,接口返回 404 not_found。该调用仍会保留在用量统计和积分流水中。
  • 也可以在控制台 /dashboard/logs 浏览调用记录并查看完整返回。

错误

HTTP错误码场景
401invalid_api_keyKey 缺失、无效或已停用
404not_foundID 不存在、属于其他账户,或已超过 30 天