{"uid":"cap_xkMrj1THQNNiNt7pYuA3O","slug":"browser-use-cloud-api-session-creation-x402-5d07b71e","name":"Browser Use Cloud API - Session Creation (x402)","description":"Browser Use: AI browser automation agents in the cloud. POST a natural-language task and an agent navigates websites, fills forms, clicks buttons, extracts structured data, and completes multi-step workflows just like a human. Stealth-enabled remote browsers with CAPTCHA solving, residential proxies, live session view, and optional structured output. Payments top up your balance; managing your session is free — you only pay to open a new browser. Docs: https://docs.browser-use.com","url":"https://x402.api.browser-use.com/api/v3/sessions","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["task"],"properties":{"task":{"type":"string","description":"Natural-language instructions for the agent to execute in a remote browser."},"model":{"type":"string","description":"LLM powering the agent: \"gemini-3-flash\" (fast/cheap), \"claude-sonnet-5\" (balanced), \"claude-opus-4.7\" (most capable, default), \"claude-opus-4.8\" (newest Opus tier)."},"keepAlive":{"type":"boolean","description":"Keep the session idle after the task completes so follow-up tasks reuse browser state."},"sessionId":{"type":"string","description":"Dispatch the task to an existing idle session instead of creating a new one."},"maxCostUsd":{"type":"number","description":"Maximum total cost in USD for this session; the task stops when reached."},"outputSchema":{"type":"object","description":"JSON Schema the agent's final output must conform to; enables structured output."},"enableRecording":{"type":"boolean","description":"Record a video of the browser session, returned as recordingUrls."},"proxyCountryCode":{"type":"string","description":"Country code for the browser proxy (e.g. \"US\", \"DE\", \"JP\"). Defaults to \"US\"."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["id","status"],"properties":{"id":{"type":"string","description":"Session id — poll GET /api/v3/sessions/{session_id} for progress."},"output":{"description":"Agent's final result: free-form text, or structured data when outputSchema was requested."},"status":{"enum":["created","idle","running","stopped","timed_out","error"],"type":"string"},"liveUrl":{"type":"string","description":"Watch the browser session live."},"stepCount":{"type":"integer"},"recordingUrls":{"type":"array","items":{"type":"string"},"description":"Video recordings of the session when enableRecording was set."},"isTaskSuccessful":{"type":"boolean","description":"Agent self-assessment of whether the task succeeded."}}}}}}},"responseSchema":{"type":"json","example":{"id":"3f6f2f64-3bfa-4643-a723-000000000000","output":"Example Domain","status":"stopped","liveUrl":"https://cloud.browser-use.com/live/...","stepCount":3,"isTaskSuccessful":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":1,"rating":{"score":"1.00","successRate":"1.00","reviews":1,"stars":"5.0","state":"rated"},"availabilityStatus":"healthy","priceObserved":{"p10Cents":"100.0000","medianCents":"100.0000","p90Cents":"100.0000","minCents":"100.0000","maxCents":"100.0000","p95Cents":"100.0000","sampleCount":1,"varies":false,"failureChargeRate":null},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_FS3JDv5zqnPQosCUaWXec","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Creates a new browser automation session via Browser Use Cloud, billed pay-per-use in USDC through the x402 payment protocol.","exampleAgentPrompt":"Start a Browser Use cloud session to log into my dashboard at example.com, navigate to the reports page, and download the latest CSV — use the GPT-4o model for agent steps and top up $5 in credits via x402.","exampleUseCases":null,"resultDescription":"Returns a newly created browser session object including session ID, status, and associated project credit balance. The session can then be used to execute agent steps (billed at $0.002–$0.10 per step depending on model), with unused credits carrying over to future requests.","failureModes":["Insufficient USDC balance — payment of $5 (or $1 minimum) required via x402 before session creation","Invalid session configuration parameters — returns 400 with validation error","Payment processing failure — x402 payment header missing or malformed","Session quota exceeded for project — returns 429 or quota error","Model not available — selected LLM model unavailable, returns 400 or 503","Network timeout during session initialization — returns 503 or timeout error"],"whenToPreferThis":"Choose this endpoint when you need to programmatically create cloud-hosted browser automation sessions with AI agent capabilities, especially when paying per-use in USDC via x402 is acceptable or preferred over a subscription model. Ideal for agents that need to browse the web, interact with web UIs, extract data from sites requiring JavaScript rendering, or execute multi-step web tasks without managing browser infrastructure. Prefer over self-hosted browser automation when you want zero infrastructure overhead and pay-only-for-what-you-use pricing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-09-02T17:51:03.541Z","lastSuccessfullyRanAt":"2026-09-02T17:51:03.541Z","lastHealthCheckAt":"2026-09-16T12:07:23.496Z","isFirstParty":false}