Search archive
GET /v1/searches/{id} — retrieve the stored result of a past search for 30 days.
GET https://api.serphubapi.com/v1/searches/{id}
Every successful search (including empty results) is archived for 30 days. Use the call ID from meta.id (or the X-Search-Id header for Markdown responses) to get the exact response back — handy for debugging, reproducing an answer, or auditing what an agent saw. Retrieving an archived result is free.
Request
| Parameter | In | Description |
|---|---|---|
id | path | The call ID, e.g. sch_01J9Z3KQ8W. |
curl https://api.serphubapi.com/v1/searches/sch_01J9Z3KQ8W \
-H "X-API-Key: shapi_xxxxxxxx"
Response
The same body the original search returned (JSON format), plus 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"
}
If the original call used include_content, the content array is included too.
Notes
- You can only read calls made by your own account (any of its keys).
- Failed calls are not archived — there is nothing to return for them.
/v1/fetchresults are not archived.- After 30 days the record is deleted and the endpoint returns
404 not_found. The call still appears in your usage history and ledger. - You can also browse calls and open full responses in the console at /dashboard/logs.
Errors
| HTTP | Code | When |
|---|---|---|
| 401 | invalid_api_key | Missing, invalid or disabled key |
| 404 | not_found | Unknown ID, belongs to another account, or older than 30 days |