Permissions for the job
A key is shown once and stored as a hash. Reissuing keeps the old key alive for 24 hours.
A member issues the key, and it never gets more rights than they have.
In Settings → API: permissions, categories, expiry and IP allowlist.
POST /v1/profiles/{id}/start on 127.0.0.1:50380 with the key in the Authorization header.
The response contains protocol and wsEndpoint: cdp for Chromium, juggler for Firefox, adb for Android.
Playwright or Puppeteer connects to the running profile. To stop: POST /v1/profiles/{id}/stop.
The profile starts with its fingerprint, proxy and sync — your script gets a ready browser.
curl -X POST \ -H "Authorization: Bearer ino_live_7Qk2…" \ http://127.0.0.1:50380/v1/profiles/$ID/start { "profileId": "3f9a2c1e-7b4d-…", "protocol": "cdp", "wsEndpoint": "ws://127.0.0.1:41733/devtools/browser/0c5e…"}
import { chromium } from 'playwright'; const api = 'http://127.0.0.1:50380';const headers = { Authorization: 'Bearer ' + process.env.INO_API_KEY }; const res = await fetch(api + `/v1/profiles/${id}/start`, { method: 'POST', headers });const { wsEndpoint } = await res.json();const browser = await chromium.connectOverCDP(wsEndpoint);const page = await browser.contexts()[0].newPage();await page.goto('https://www.browserscan.net');
/v1/profiles/v1/profiles/{id}/start/v1/profiles/{id}/stopA key is shown once and stored as a hash. Reissuing keeps the old key alive for 24 hours.
A key can be limited by categories, expiry and IP allowlist.
Our Chromium runs in an isolated world without Runtime.enable and launches without the Playwright flags that disable storage partitioning.
Playwright and Puppeteer: Chromium exposes a CDP endpoint, Firefox exposes Juggler. You can also send requests with curl.
Locally: http://127.0.0.1:50380. The default port is 50380 and can be changed in settings.
Yes: permissions, categories, expiry and IP allowlist. A key never grants more rights than its owner has.
Up to 5 concurrent API launches by default. The limit is configurable.