API overview
The SDK is the recommended way to use Solari from Node. Every method has a plain HTTP endpoint underneath, useful from Python, Go, Rust, or curl.
Base URL
https://api.solaribrowser.comAuthentication
Bearer token in the Authorization header:
curl https://api.solaribrowser.com/sessions \
-H "Authorization: Bearer sb_live_…"Keys are minted in the console and shown once at creation time. Rotating a key invalidates the previous one.
Content type
Request and response bodies are JSON. Set Content-Type: application/json on POST and DELETE with a body.
Endpoints
Stealth, proxies, captcha solving, and recording are flags on POST /sessions rather than separate resources. Recording is read back through GET /sessions/:id/replay-url.
| Method + path | Purpose |
|---|---|
POST /sessions | Allocate a browser and return its endpoints. |
GET /sessions/:id | Look up a session's status. |
DELETE /sessions/:id | Release the session. |
GET /sessions/:id/replay-url | Presigned URL for the rrweb recording. |
POST /profiles | Create a profile. |
GET /profiles | List profiles. |
DELETE /profiles/:id | Delete a profile. |
POST /profiles/:id/save | Save the storageState. |
GET /proxy/countries | List supported residential countries. |
Errors
Conventional HTTP status codes plus a JSON body with error and optional message. The SDK wraps these as SolariError with status and cause fields. See Errors.