Nextbrowser

Nextbrowser provides cloud browsers and autonomous browser automation via API.

Docs:

• Cloud API: https://docs.nextbrowser.com/getting-started

Setup

API Key is read from openclaw config at skills.entries.next-browser.apiKey.

If not configured, tell the user:

To use Nextbrowser, you need an API key. Get one at https://app.nextbrowser.com/user-settings (new signups get 2000 free credits). Then configure it:

```

openclaw config set skills.entries.next-browser.apiKey "nb_your_key_here"

```

Base URL: https://app.nextbrowser.com/api/v1

All requests need header: Authorization: x-api-key

---

1. Profiles

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

```bash

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": "", "browser_settings": {"os_type": "", "browser_type": "chrome"},

"proxy_settings":{"protocol":"","country":"","mode":"built-in"}}'

Delete profile

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

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

```

---

2. Credentials Manager

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

```bash

List credentials

curl "https://app.nextbrowser.com/api/v1/users/credentials" -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.

```bash

List Countries

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

limit=&\

offset=&\

name=&\

code=&\

connection_type=" \

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

```

```bash

List Regions

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

country__code=&\

limit=&\

offset=&\

name=&\

code=&\

city__code=&\

connection_type=" \

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

```

```bash

List Cities

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

country__code=&\

limit=&\

offset=&\

name=&\

code=&\

region__code=&\

connection_type=" \

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

```

```bash

List ISPs

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

country__code=&\

limit=&\

offset=&\

name=&\

code=&\

region__code=&\

city__code=&\

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.

Always use fast mode - optimized for browser tasks, 3-5x faster than other models.

Always use true for skip_plan_approval - optimized for automated tasks, skips the approval and improve performance.

```bash

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": "",

"credentials": [""],

"skip_plan_approval": true

}'

```

Poll for completion

```bash

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

```

Response:

```json

{

"success": true,

"payload": {

"status": "finished",

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

"isSuccess": true

},

"errors": {},

"description": "Task retrieved successfully"

}

```

Status values: processing, finished, failed

Task options

| Option | Description |

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

| task_description | Your prompt (required) |

| mode | Always use fast |

| profile_id | Use a profile for auth |

| credentials | List of credential IDs for login |

| skip_plan_approval | Always use true|

---

Full API Reference

See references/api.md for all endpoints including Sessions, Files, Skills, and Skills Marketplace.