Authentication
All API endpoints except /health require an API token, sent as
either a bearer header or a query parameter:
Authorization: Bearer <token>
# or
?token=<token>Tokens are managed from the admin UI.
Endpoints
GET /health
Liveness check, no auth. Returns {"status":"ok","version":"…"}.
GET /browsers
Lists available browser profiles and aliases.
GET /metrics
Service metrics: request counts, success/failure, average duration, per-browser usage.
POST /impersonate
Performs an HTTP request impersonating the chosen browser.
| Field | Type | Default | Description |
|---|---|---|---|
url | string | — | Target URL (required) |
browser | string | chrome152 | Profile or alias |
method | string | GET | HTTP method |
headers | object | — | Custom request headers |
query_params | object | — | Query params merged into the URL |
body | string | — | Request body (text) |
body_base64 | string | — | Request body (base64, for binary) |
follow_redirects | bool | true | Follow redirects |
insecure | bool | false | Skip TLS verification |
timeout | int | 30 | Timeout (seconds) |
Example
curl -X POST https://curl-impersonate.16bit.cloud/impersonate \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"browser":"chrome152","url":"https://example.com"}'Success responses always return 200 with a JSON envelope
(success, status_code, headers,
body, timing, …). Network problems return
success:false with an error_type of
network, dns, timeout, ssl or
size.
GET /admin/
Admin dashboard (separate Basic-auth login): manage tokens, CORS and usage logs.
Browsers
Default: chrome152. Aliases:
| Alias | Resolves to |
|---|---|
chrome-latest | chrome152 |
edge-latest | edge101 |
firefox-latest | firefox155 |
safari-latest | safari270 |
tor-latest | tor145 |
All profiles (47)
chrome100chrome101chrome104chrome107chrome110chrome116chrome119chrome120chrome123chrome124chrome131chrome131_androidchrome133achrome136chrome142chrome145chrome146chrome150chrome151chrome151_macoschrome152chrome152_macoschrome99chrome99_androidedge101edge99firefox133firefox135firefox144firefox147firefox153firefox154firefox155safari153safari155safari170safari172_iossafari180safari180_iossafari184safari184_iossafari260safari2601safari260_iossafari270safari270_iostor145