# Browser Forest API

**Canonical:** https://apis.io/apis/browserforest-com/browserforest-com-api/  
**Provider:** Browser Forest — https://apis.io/providers/browserforest-com/  
**Documentation:** https://browserforest.com/api/docs

Browser Forest API is one of 2 APIs that [Browser Forest](https://apis.io/providers/browserforest-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Browser Forest API as documented publicly: 64 operations. Contract generated from the documentation by API Evangelist (2026-11-03); not the provider's own document.

## Operations (60 of 64)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/contexts` | POST /api/v1/contexts |
| PUT | `/api/v1/contexts/ctx_xxxx/cookies` | PUT /api/v1/contexts/ctx_xxxx/cookies |
| PUT | `/api/v1/contexts/ctx_xxxxxxxx/cookies` | Write cookies to a Context for persistence |
| POST | `/api/v1/scrape` | POST /api/v1/scrape |
| POST | `/api/v1/sessions` | POST /api/v1/sessions |
| DELETE | `/api/v1/sessions/ses_xxxx` | DELETE /api/v1/sessions/ses_xxxx |
| PUT | `/api/v1/sessions/ses_xxxx/cookies` | PUT /api/v1/sessions/ses_xxxx/cookies |
| DELETE | `/api/v1/sessions/ses_xxxxxxxx` | DELETE /api/v1/sessions/ses_xxxxxxxx |
| PUT | `/api/v1/sessions/ses_xxxxxxxx/cookies` | PUT /api/v1/sessions/ses_xxxxxxxx/cookies |
| GET | `/health` | Health check |
| GET | `/mcp` | Get MCP information. |
| POST | `/mcp` | Create or update MCP data. |
| DELETE | `/mcp/bf` | Delete a BF MCP entry. |
| GET | `/mcp/bf` | Retrieve BF MCP details. |
| POST | `/mcp/bf` | Create or modify BF MCP entry. |
| POST | `/v1/admin/impersonate` | Impersonate another user as admin. |
| POST | `/v1/admin/impersonate/exit` | Exit admin impersonation mode. |
| GET | `/v1/auth/api-keys` | List API keys |
| POST | `/v1/auth/api-keys` | Create an API key |
| DELETE | `/v1/auth/api-keys/{id}` | Delete an API key |
| GET | `/v1/auth/config` | GET |
| POST | `/v1/auth/login` | POST |
| POST | `/v1/auth/logout` | Logout |
| GET | `/v1/auth/me` | Get current user info |
| GET | `/v1/auth/oauth/github` | Start GitHub OAuth flow |
| GET | `/v1/auth/oauth/github/callback` | GitHub OAuth callback |
| GET | `/v1/auth/oauth/google` | Start Google OAuth flow |
| GET | `/v1/auth/oauth/google/callback` | Google OAuth callback |
| GET | `/v1/billing/balance` | Get historical usage aggregated by day, week, or month |
| POST | `/v1/billing/cancel-subscription` | Get historical usage aggregated by day, week, or month |
| POST | `/v1/billing/change-plan` | Get historical usage aggregated by day, week, or month |
| POST | `/v1/billing/change-plan/preview` | Get historical usage aggregated by day, week, or month |
| POST | `/v1/billing/checkout` | Get historical usage aggregated by day, week, or month |
| GET | `/v1/billing/credit-packages` | Get historical usage aggregated by day, week, or month |
| GET | `/v1/billing/payment-history` | Get historical usage aggregated by day, week, or month |
| POST | `/v1/billing/portal` | Get historical usage aggregated by day, week, or month |
| POST | `/v1/billing/reactivate-subscription` | Get historical usage aggregated by day, week, or month |
| POST | `/v1/billing/topup` | Get historical usage aggregated by day, week, or month |
| GET | `/v1/billing/transactions` | Get historical usage aggregated by day, week, or month |
| POST | `/v1/billing/upgrade` | Get historical usage aggregated by day, week, or month |
| POST | `/v1/captcha/solve` | Solve a captcha via CapSolver REST API |
| POST | `/v1/captcha/solve-interact` | Complete an in-page checkbox captcha (worker-driven) |
| GET | `/v1/contexts` | List all contexts |
| POST | `/v1/contexts` | Create a browser context |
| PATCH | `/v1/contexts/{id}` | Update context captcha configuration |
| GET | `/v1/proxies` | List all proxies |
| POST | `/v1/proxies` | Add a proxy |
| GET | `/v1/proxies/{id}` | Get proxy details |
| GET | `/v1/recordings` | List recordings |
| DELETE | `/v1/recordings/{recordingid}` | Delete a recording |
| GET | `/v1/recordings/{recordingid}` | Get recording details |
| POST | `/v1/recordings/{recordingid}/replay` | Replay a recording onto a session |
| POST | `/v1/scrape` | Scrape a URL in one shot |
| GET | `/v1/sessions` | List sessions |
| POST | `/v1/sessions` | Create a browser session |
| GET | `/v1/sessions/share/info` | Resolve a Live View share token (session id + expiry) |
| GET | `/v1/sessions/{id}/debug` | Debug a session |
| POST | `/v1/sessions/{id}/input` | Send an interaction to a session (BG behavior engine, falls back to CDP) |
| DELETE | `/v1/sessions/{id}/share` | Revoke Live View share links for a session |
| POST | `/v1/sessions/{id}/share` | Create a share link for Live View (signed token, read-only by default) |

…and 4 more operations. They are listed in full on the page.

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/browserforest-com/openapi/_ae-authored/browserforest-com-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/browserforest-com/json-schema/browserforest-com-put-api-v1-sessions-ses-xxxxxxxx-cookies-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/browserforest-com/json-schema/browserforest-com-post-api-v1-scrape-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/browserforest-com/json-schema/browserforest-com-put-api-v1-sessions-ses-xxxx-cookies-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/browserforest-com/json-schema/browserforest-com-post-v1-captcha-solve-interact-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/browserforest-com/json-schema/browserforest-com-post-v1-auth-login-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/browserforest-com/json-schema/browserforest-com-post-v1-captcha-solve-request-schema.json

## Other Browser Forest APIs (1)

- [Browser Forest API](https://apis.io/apis/browserforest-com/browser-forest-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/browserforest-com/browserforest-com-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/browserforest-com/.
