Skip to navigation

Search From a Page URL

View as Markdown

Fetches the page at the supplied URL, identifies the single company, product, or person the page is primarily about, and returns the federated entity, person, and news results for that name together with the synthesized query itself. A page whose content cannot be read returns 404; a fetch or inference failure returns a problem (503 only when a retry can succeed), never an empty result. For direct URL-to-record identity resolution use the entities lookup operation with the url instead. Send Prefer: respond-async to skip the live wait: the search is committed as a link search job and the read answers 202 with a Location status URL and Retry-After; poll it. A repeat of a search that completed in the last few minutes answers 200 from its stored result. A failed job commit answers 503; a caller already holding the maximum active link searches gets 429.

Authentication

AuthorizationBearer

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

Headers

PreferstringOptional

Send respond-async to request a pollable link search job.

Query parameters

urlstringRequired
Public article or page URL to search from
pageintegerOptional>=0

Zero-based page index (0..N)

sizeintegerOptional>=1
The size of the page to be returned

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
406
Not Acceptable Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error