Web Tools

Open a browser session

Opens a session and navigates. Same fields as /scrape; formats defaults to ["controls"]. Returns sessionId. HTTP supports the same Bearer API key and shared credits as MCP, or an independent x402 wallet payment.

post/web/v1/session

Request

  • Base URL: https://api.oassis.dev
  • URL: https://api.oassis.dev/web/v1/session
  • Auth: one of:
    • HTTP bearer
    • none

Request body

urlstring uri required

Page to process.

formatsstring[]

Outputs you want in the same response. controls is the map of what can be clicked; elements needs selectors; json needs json.prompt or json.schema.

selectorsstring[]

CSS selectors for the elements format.

maxAgeinteger

Accept an answer up to this many milliseconds old. A cache hit costs $0.0002 instead of the format price. Leave it out to force a fresh render.

binaryAs'base64'

How a screenshot or a PDF comes back. base64 is the only value today.

Response

The result.

Changes

No recorded changes to this operation across all 1 revision of this API.