# Oassis Browser Session Opener

> Oassis Browser Session Opener is a paid API for AI agents from api.oassis.dev, paid per call via x402, $0.006/call, status unknown (last checked 2026-10-11).

Opens a browser session on a target URL and returns a map of interactive controls (links, buttons, inputs) found on the page.

## Facts

- Endpoint: GET https://api.oassis.dev/web/v1/session?utm_source=zero.xyz
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oassis-browser-session-opener-0a4bad27
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DfWodyoWhpnXK83ZtqyOd

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability oassis-browser-session-opener-0a4bad27
```

Example prompt: Open a browser session on https://example.com and give me a map of all the interactive controls — buttons, links, and inputs — so I can start navigating the page.

## When to prefer this

Choose this endpoint when you need to start an interactive browser session and discover the full map of controls on a page before driving further automation steps. It is the right first call when you need element references ('ref') for subsequent click or fill actions. Prefer it over static scraping endpoints when the page requires real browser rendering or when you need to interact with the page programmatically rather than just read its text content.

## Known failure modes

- Target URL is unreachable or returns an error — session may fail to initialize
- Page has no discoverable controls — returns empty controls array
- JavaScript-heavy SPAs may not fully render before controls are mapped
- Session timeout or browser crash — returns error with no session ID
- Rate limiting or payment failure — 402 response before session is created

## How this service works

Opens a browser session and returns the map of controls.

## Output

Returns a JSON object with a session ID, a success flag, and a 'controls' array. Each control has a 'ref' (element reference for follow-up actions), a 'name' (human-readable label), and a 'role' (e.g. 'link', 'button', 'input') describing its type.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input",
  "output"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object"
    },
    "type": {
     "enum": [
      "http"
     ],
     "type": "string"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type",
    "example"
   ],
   "properties": {
    "type": {
     "enum": [
      "json"
     ],
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   },
   "additionalProperties": false
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "controls": [
    {
     "ref": "e3",
     "name": "OpenAPI",
     "role": "link"
    }
   ]
  },
  "success": true,
  "sessionId": "6f1c…"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oassis-browser-session-opener-0a4bad27/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.oassis.dev](https://www.zero.xyz/host/api.oassis.dev/llms.txt)