HushSearchDocs

Browser Session

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

Browsers

POST/v1/browser/sessions3 credits

Request
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 to interact with pages.

Create session

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

Response

{
  "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

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.