结果存档
GET /v1/searches/{id}——30 天内回看任意一次历史搜索的完整结果。
GET https://api.serphubapi.com/v1/searches/{id}
每次成功的搜索(包括空结果)都会存档 30 天。用 meta.id(Markdown 响应则取 X-Search-Id 响应头)即可拿回当时的完整返回——排查问题、复现答案、审计 agent 当时看到了什么,都用得上。查询存档不计费。
请求参数
| 参数 | 位置 | 说明 |
|---|---|---|
id | path | 调用 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 | 错误码 | 场景 |
|---|---|---|
| 401 | invalid_api_key | Key 缺失、无效或已停用 |
| 404 | not_found | ID 不存在、属于其他账户,或已超过 30 天 |