Browser Automation API for the Afina Antidetect Browser

Afina exposes a local HTTP API on 127.0.0.1:50778 that controls everything the desktop app does — profiles, sessions, proxies, cookies, RPA scripts, modules and task groups. Calls are authenticated with an x-api-key header and only accepted from localhost origins. Your own code drives the antidetect browser directly instead of scraping the UI.

The server starts automatically when Afina launches. Base URL is http://127.0.0.1:50778 (the desktop app tries the next ports if 50778 is busy). You generate the API key in Settings → General → API key inside Afina and pass it on every request as x-api-key: YOUR_KEY. Without the key the connection is silently closed; CORS only allows http://localhost, http://127.0.0.1 and tauri:// origins.

Yes. POST /api/profiles/start returns a wsEndpoint like ws://127.0.0.1:9223/devtools/browser/... — feed it into puppeteer.connect({ browserWSEndpoint }) or chromium.connectOverCDP() and you have full DevTools Protocol control over a real, isolated antidetect profile with the right fingerprint and proxy.

POST /api/scripts/run with { profileId, scriptId } starts the script and returns a task uuid immediately. Stream the live text log with GET /api/scripts/run-logs?uuid=… while the script runs. For scheduled, repeatable batches use task groups (POST /api/task-groups/create) and tasks — Afina handles the queue, parallelism limit, time-window scheduling and retries.

POST /api/profiles/one-time creates a fresh profile with a unique fingerprint, starts the browser and returns a wsEndpoint — and as soon as the browser stops (manually, via stop endpoint or browser.close from Puppeteer) Afina hard-deletes the profile, files and remote record automatically. Ideal for web scraping, isolated checks and throw-away accounts you don't want to maintain.

Both work. Afina ships a visual flow canvas where you chain clicks, navigations, waits, conditionals and data steps with drag-and-drop — so analysts and ops engineers can ship automations without writing code. When you need raw power, drop into the built-in scripts engine and write JavaScript or call Node.js modules via executeModule.

Yes. Task groups schedule and execute tasks on hundreds of profiles concurrently with explicit limits (activeSession, timeout, time-window, repeatCount). Profiles can be grouped by use case or client and queried via GET /api/profiles/list filters. Live logs and per-task status (waiting / working / finished / error / stop) make a batch run observable end-to-end.

Puppeteer and Playwright drive an off-the-shelf Chromium — no isolated profiles, no real device fingerprints, no multi-account session management, no built-in proxy and cookie store. Afina ships those primitives natively and exposes them through one API plus a CDP WebSocket, so you keep your favourite tooling while every account looks like a separate real device.