Nextbrowser

> openclaw config set skills.entries.next-browser.apiKey "YOUR_API_KEY"

Do NOT validate the key format yourself - simply use whatever key the user provides. If the key is invalid, the API will return an authentication error, and only then should you ask the user to verify their key.

---

1. Credentials Manager

The Credentials Manager securely stores and reuses authentication data across browser runs and autonomous tasks.

List credentials

curl "https://app.nextbrowser.com/api/v1/users/credentials" -H "Authorization: x-api-key $API_KEY"

---

2. Profiles

Profiles persist cookies and login state across browser sessions. Create one, log into your accounts in the browser, and reuse it.

List profiles

curl "https://app.nextbrowser.com/api/v1/browser/profiles" -H "Authorization: x-api-key $API_KEY"

Create browser profile

curl -X POST "https://app.nextbrowser.com/api/v1/browser/profiles" \

-H "Authorization: x-api-key $API_KEY" \

-H "Content-Type: application/json" \

-d '{"name": "<profile-name>", "browser_settings": {"os_type": "<os-type>", "browser_type": "chrome"},

"proxy_settings":{"protocol":"<http|https|socks5>","country":"<iso-2-country-code>","mode":"built-in"},

"credentials": ["<credential-id>"]}'

Delete profile

curl -X DELETE "https://app.nextbrowser.com/api/v1/browser/profiles/<profile-id>" \

-H "Authorization: x-api-key $API_KEY"

---

3. Locations

The Locations endpoints provide available geolocation metadata for proxy and browser configuration. Use them to dynamically discover supported countries, regions, cities, and ISPs before creating profiles or running tasks under specific network conditions.

List Countries

curl "https://app.nextbrowser.com/api/v1/location/countries?\

limit=<limit>&\

offset=<offset>&\

name=<name>&\

code=<iso2-code>&\

connection_type=<connection-type>" \

-H "Authorization: x-api-key $API_KEY"

List Regions

curl "https://app.nextbrowser.com/api/v1/location/regions?\

country__code=<iso2-country>&\

limit=<limit>&\

offset=<offset>&\

name=<name>&\

code=<region-code>&\

city__code=<city-code>&\

connection_type=<connection-type>" \

-H "Authorization: x-api-key $API_KEY"

List Cities

curl "https://app.nextbrowser.com/api/v1/location/cities?\

country__code=<iso2-country>&\

limit=<limit>&\

offset=<offset>&\

name=<name>&\

code=<city-code>&\

region__code=<region-code>&\

connection_type=<connection-type>" \

-H "Authorization: x-api-key $API_KEY"

List ISPs

curl "https://app.nextbrowser.com/api/v1/location/isps?\

country__code=<iso2-country>&\

limit=<limit>&\

offset=<offset>&\

name=<name>&\

code=<isp-code>&\

region__code=<region-code>&\

city__code=<city-code>&\

connection_type=<connection-type>" \

-H "Authorization: x-api-key $API_KEY"

---

4. Tasks (Subagent)

Run autonomous browser tasks - like a subagent that handles browser interactions for you. Give it a prompt and it completes the task.

curl -X POST "https://app.nextbrowser.com/api/v1/chat/tasks" \

-H "Authorization: x-api-key $API_KEY" \

-H "Content-Type: application/json" \

-d '{

"task_description": "'"\

Go to Reddit.com account, check if the account is logged in (if not, use credentials stored). \

Find 10 relevant posts on the topic of AI Agents, upvote 8 of them and post 3 witty-sounding comments \

that a cynical and funny Reddit user would post. Ensure that the comment is posted, ask for approval \

if you are not sure whether such comment is okay. By the end, you should have at least 10 relevant posts \

viewed, 8 upvotes, and 3 comments."\

"'",

"mode": "fast",

"profile_id": "<profile-id>",

"skip_plan_approval": true

}'

Endpoint: Poll for completion

curl "https://app.nextbrowser.com/api/v1/chat/tasks/<task-id>" \

-H "Authorization: x-api-key $API_KEY"

curl "https://app.nextbrowser.com/api/v1/chat/tasks/<task-id>?from_step=3" \

-H "Authorization: x-api-key $API_KEY"

• -Query params (optional):

Response

{

"success": true,

"payload": {

"status": "finished",

"output": "Task completed. 10 relevant posts are viewed, 8 upvotes are done and 3 comments posted.",

"isSuccess": true,

"steps": [

{

"created_at": "2025-01-01T10:00:00Z",

"finished_at": "2025-01-01T10:00:05Z",

"description": "Opened Reddit search page",

"status": "completed",

"step_number": 1

}

// ... more steps starting from from_step

],

"total_steps": 5

},

"errors": {},

"description": "Task retrieved successfully"

}

Field semantics

• -output: final task output (if available).

Task options

| Option | Description |

|--------|------------------------|