api.oassis.dev

Live 402 challenge

Captured by the enrichment pass, not read just now. Prices can change — always read the 402 the endpoint answers with.

{
  "notes": [
    "Today every format consumes a browser render: 4 formats = 4 renders. `metadata.renders` and `metadata.browserMsUsed` say so in every response.",
    "The PDF and the screenshot arrive base64-encoded inside the JSON.",
    "`controls` returns what can be acted on (role, name, selector, box on screen) in a single render: it is the map an agent needs to decide where to click.",
    "Send `maxAge` to reuse a recent render: `metadata.cached` lists which formats came from the cache, and those are priced at $0.0002. Requests carrying cookies, auth or custom headers are never cached, because the cache is shared."
  ],
  "example": {
    "pdf": {
      "format": "a4"
    },
    "url": "https://oassis.dev",
    "json": {
      "prompt": "Product name, price and availability"
    },
    "wait": {
      "until": "networkidle0"
    },
    "formats": [
      "markdown",
      "links",
      "pdf",
      "json"
    ]
  },
  "request": {
    "pdf": "{ format, landscape, printBackground, scale }",
    "url": "string — page to process (or `html`)",
    "html": "string — raw HTML instead of `url`",
    "json": "{ prompt, schema } — required with the `json` format",
    "wait": "{ until, selector, timeout }",
    "block": "{ resourceTypes, urlPatterns } — urlPatterns are regular expressions, not globs: `\\\\.svg$`, not `*.svg`",
    "links": "{ visibleOnly, excludeExternal }",
    "maxAge": "number — accept an answer up to this many ms old. A cache hit costs $0.0002 instead of the format price, and the price already says so",
    "formats": "array — html, markdown, links, screenshot, pdf, elements, json, accessibility, controls (defaults to [\"markdown\"])",
    "request": "{ headers, cookies, userAgent, auth }",
    "binaryAs": "base64 (the only value for now; \"url\" arrives with storage)",
    "controls": "{ visibleOnly, limit } — options for the `controls` format",
    "viewport": "{ width, height, deviceScaleFactor }",
    "documents": "a url pointing at a PDF, Word, Excel, CSV or OpenDocument file is converted to markdown without a browser. Only `markdown` comes out of a document",
    "selectors": "array of string — required with the `elements` format",
    "screenshot": "{ fullPage, type, quality, omitBackground, selector, viewport }"
  },
  "endpoint": "POST /web/v1/scrape",
  "response": {
    "data": "one key per requested format that succeeded",
    "errors": "one key per format that failed, with the reason",
    "success": "true when at least one format came out",
    "metadata": "url, formats, renders, browserMsUsed, ms, title"
  },
  "description": "Processes a page and returns every output you ask for in `formats` at once. A partial failure does not void the rest."
}

Accepts

The payment requirements as published to the catalog. Read the live 402 before paying — a price here is a claim, not a quote.

[
  {
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "extra": {
      "name": "USD Coin",
      "version": "2"
    },
    "payTo": "0x23Fc725e8EAa1c58900C6507Ba89be99a6DFc75d",
    "scheme": "exact",
    "network": "eip155:8453",
    "mimeType": "application/json",
    "resource": "https://api.oassis.dev/web/v1/scrape",
    "description": "",
    "maxAmountRequired": "4000",
    "maxTimeoutSeconds": 300
  }
]

Provenance

Seen in the source catalog

2026-10-17 13:54Z

Last indexed by Roundhouse

2026-10-18 21:15Z

Last enriched (probe, favicon, geo)

2026-10-07 16:46Z

x402 version

1

Max timeout

300s

Liveness probe

HTTP 402