Core concepts
Shared success, error, metadata, and headers.
{
"success": true,
"data": {
"query": "bhusaval",
"results": []
},
"meta": {
"api_version": "v1",
"request_id": "req_01J...",
"trace_id": "trc_01J...",
"timestamp": "2026-11-20T10:57:12.762Z",
"freshness": {
"mode": "live",
"retrieved_at": "2026-11-20T10:57:12.762Z",
"sources": [
{
"confidence": "high"
}
]
}
}
}successbooleanWhether the operation succeeded.
dataobjectEndpoint-specific payload. Replaced by error on failures.
meta.api_versionstringAPI major used for the response.
meta.request_idstringStable request identifier to include with support requests.
meta.trace_idstringDistributed trace identifier.
meta.timestampstring(date-time)Response creation time as an ISO instant.
meta.freshnessobjectLive retrieval time and source confidence metadata.
Live requests emit Cache-Control: no-store, no-cache, must-revalidate, private. The confidence header and freshness block report whether live sources agreed and when they last reported.
success before reading data.error.code, never parse the human message.Last updated