Skip to navigation

Get a Link Search Job

View as Markdown

Returns the result of a link search accepted with Prefer: respond-async. Answers 202 with Location and Retry-After while the job is pending or running, 200 with the search once it completes, and 503 when the job failed; resubmit the search to retry. An unknown or expired job id returns 404.

Authentication

AuthorizationBearer

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

Path parameters

jobIdstringRequiredformat: "uuid"
Link search job UUID

Response headers

X-RateLimit-Limitinteger

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

X-RateLimit-Remaininginteger

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

X-RateLimit-Resetinteger

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

Response

Records reachable from the submitted link.
querystring
Search query synthesized from the page content.
relatedobject
Federated entity, person, and news results for the synthesized query.
urlstring
The fetched page URL after validation.

Errors

400
Bad Request Error
401
Unauthorized Error
402
Payment Required 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