POST

Run a multi-step browser flow (click, fill, wait, scroll, evaluate; max 5 steps) in a persistent session. Powered by Playwright stealth

/v1/browser/session

Powered by Playwright

Request → Response

Examples from schemas.json.

Requestapplication/json
POST /v1/browser/session
Content-Type: application/json

{
  "url": "https://tools402.dev",
  "steps": [
    {
      "type": "click",
      "selector": "button[type=\"submit\"]"
    }
  ],
  "viewport": {
    "width": 0,
    "height": 0
  }
}
Responseapplication/json
HTTP/1.1 200 OK
Content-Type: application/json

// Endpoint-specific body after 402 settlement

Overview

Run a multi-step browser flow (click, fill, wait, scroll, evaluate; max 5 steps) in a persistent session. Powered by Playwright stealth.

Open-source browser automation and testing framework by Microsoft.

Request schema

Body: JSON · application/json

FieldTypeDescription
urlstringrequired—
stepsarrayoptional—
viewportobjectoptional—
IMPLEMENTATION
curl -X POST https://api.tools402.dev/v1/browser/session \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://tools402.dev",
  "steps": [
    {
      "type": "click",
      "selector": "button[type=\"submit\"]"
    }
  ],
  "viewport": {
    "width": 0,
    "height": 0
  }
}'

402 payment flow omitted — see Integrations for settlement.