Skip to main content
POST
Fetch a page and return its raw HTML and metadata, without LLM extraction. A quarter the price.

Authorizations

Authorization
string
header
required

An API key minted in the console, sent as Authorization: Bearer <key>. Keys are project-scoped and carry per-operation scopes. A gck_test_… key runs the full request path — including the real upstream call — and bills nothing.

Every scope is enumerated in x-scopes below and in the RFC 9728 protected-resource metadata at https://cloud.gomry.com/.well-known/oauth-protected-resource, which is also what a 401 points at through its WWW-Authenticate: Bearer resource_metadata="…" header.

Body

application/json
url
any

Required. The page to scrape. Max 2048 characters. Private addresses and internal hostnames are refused.

schema
any

Required for /v1/scrape. A JSON Schema object describing the shape you want back. Returned in data.

prompt
any

Required for /v1/scrape. 1–2000 characters of instruction for the extraction, e.g. "Extract the event".

waitFor
any

Milliseconds to wait after load before reading the page, for content that arrives late. 0–15000.

timeout
any

Milliseconds before the vendor call is abandoned. 1000–90000. The whole request is capped at 120s server-side, so budget for two calls if you use retry.

onlyMainContent
any

Strip navigation, footers and boilerplate before extraction. Defaults to true; set false when the data you want lives in the chrome.

includeRawHtml
any

Also return the page's raw HTML in rawHtml. Use when you parse JSON-LD or embedded blobs yourself.

retry
any

{ requiredField, waitFor }. If the first pass returns without that field, the page is fetched once more with the longer wait. Bills both calls, and only when each returned a page.

Response

Success. fetches reports what was metered.

The response is of type object.