Skip to navigation

Get an Async Web Search Job

View as Markdown

Reads the web-search job a search accepted with a 202. Answers 200 with the finished search (charged like a search), 202 with Retry-After while the search is queued or running, 503 search_provider_error when the job ended without a result, and 404 for an unknown job. On that 503, follow the problem’s disposition: TRANSIENT means the job ended before a provider answered, so send the search once more after Retry-After; TERMINAL means the provider refused this query or aVenture already retried it, so record the outage instead of resending it. Never starts or resubmits a provider search.

Authentication

AuthorizationBearer

Your aVenture API key (https://aventure.vc/settings/api-keys) or OAuth access token

Path parameters

jobIdstringRequiredformat: "uuid"

Web-search job UUID from the 202 response

Response headers

Cache-ControlstringOptional

Always no-store: a metered per-caller read

X-RateLimit-LimitintegerOptional

Requests allowed per client IP in the current rate-limit window.

X-RateLimit-RemainingintegerOptional

Requests left before the tightest applicable rate-limit bucket rejects.

X-RateLimit-ResetintegerOptional

Seconds until the exhausted rate-limit bucket admits another request; 0 when none is exhausted.

Response

Finished web search; never cached by intermediaries

documentobject
Stored record, metadata only, of the page this web search fetched
resultlist of objects
Normalized result items in provider rank order
searchobject
Web search request represented by this result
accountingReceiptobject or nullOptionalRead-only

Accounting identity of this caller’s admitted search work, not historical shared-cache spend

aiOverviewobject or nullOptional

Google’s AI Overview: returned whenever Google answers inline or its deferred overview is stored (fetched by this or an earlier search that set deferredAiOverview); null when Google produced none or no such fetch stored its deferred overview

answerBoxobject or nullOptional

Google’s direct answer box; null when the page shows none

knowledgeGraphobject or nullOptional

Google’s knowledge panel; null when the page shows none

relatedQuestionlist of objects or nullOptional

Google’s “People also ask” questions; null when the page shows none

relatedSearchlist of strings or nullOptional

Google’s related searches; null when the page shows none

sportsResultobject or nullOptional

Google’s game spotlight; null when the page shows none

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
406
Not Acceptable Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error