# Browser Session

> Create and manage persistent headless browser sessions — 6 credits per session.

Source: http://localhost:3000/docs/endpoints/browser

## Browser Sessions: `POST /v1/browser/sessions`

Durable headless sessions: navigate, read content, cookies, evaluate. Cost: 3 credits.

```bash
curl -X POST https://api.hushsearch.io/v1/browser/sessions \
  -H "X-API-Key: hs_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "ttl_seconds": 600
}'
```

**POST** `/v1/browser` — **6 credits per call**
**DELETE** `/v1/browser/{session_id}` — close a session (no charge)

Create a persistent headless Chromium session. Sessions auto-expire after 5 minutes of inactivity. Use [Browser Execute](http://localhost:3000/docs/endpoints/browser-execute) to interact with pages.

## Create session

```bash
curl -X POST https://api.hushsearch.io/v1/browser \
  -H "X-API-Key: YOUR_API_KEY"
```

### Response

```json
{
  "session_id": "550e8400-e29b-41d4-a716-446655440000",
  "expires_at": "2026-05-18T12:05:00Z",
  "credits_used": 6,
  "credits_remaining": 94,
  "response_time_ms": 1240
}
```

## Close session

```bash
curl -X DELETE https://api.hushsearch.io/v1/browser/550e8400-e29b-41d4-a716-446655440000 \
  -H "X-API-Key: YOUR_API_KEY"
```

## Notes

- SSRF protection is enforced — private/internal IPs are blocked.
- Maximum 10 concurrent sessions (returns 503 if exceeded).
- Sessions are not shared between API keys.
