Локальный API
Запускайте профили из своих скриптов и подключайте Playwright или Puppeteer к уже открытому браузеру — с отпечатком, прокси и cookies профиля.
Разделы
Быстрый старт
API работает внутри десктоп-клиента inoBrowser и слушает только 127.0.0.1. Клиент должен быть открыт, а вы — вошли в аккаунт.
- Включите APIВ клиенте: Настройки → Локальный API. Порт по умолчанию 50380, можно задать любой от 1024 до 65535. С версии 0.1.17 порт по умолчанию — 50380 (раньше 50325, он совпадал с Local API AdsPower): после обновления клиент сам переключает старый порт по умолчанию, порт, заданный вручную, не меняется. Если порт занят другой программой, в настройках будет ошибка «Порт N занят другой программой».
- Выпустите ключНастройки → API-ключи → «Выпустить ключ» с правами «чтение» и «запуск и остановка». Ключ показывается один раз.
- Проверьте связьЗапрос к /health вернёт {"ok": true}.
curl http://127.0.0.1:50380/health curl http://127.0.0.1:50380/v1/profiles \ -H "Authorization: Bearer ino_live_7Qk2…"
Авторизация
Каждый запрос, кроме /health, несёт API-ключ ino_live_… в одном из заголовков. Ключ не даёт прав больше, чем у сотрудника, который его выпустил.
| Заголовок | Значение |
|---|---|
| Authorization | Bearer ino_live_… |
| X-API-Key | ino_live_… |
| Право | В клиенте | Методы |
|---|---|---|
| read | чтение | /v1/profiles, /v1/running |
| launch | запуск и остановка | …/start, …/stop |
Ключ проверяется на сервере inoBrowser, результат хранится минуту — отозванный ключ перестаёт работать в течение минуты.
# Bearercurl http://127.0.0.1:50380/v1/profiles \ -H "Authorization: Bearer ino_live_7Qk2…"# или X-API-Keycurl http://127.0.0.1:50380/v1/profiles \ -H "X-API-Key: ino_live_7Qk2…"
Безопасность и лимиты
- Сервер слушает только 127.0.0.1 — с других компьютеров он недоступен
- Заголовок Host должен быть 127.0.0.1 или localhost
- Запросы со страниц в браузере отклоняются — вызывайте API из скриптов, не из веб-страниц
- Лимит одновременных запусков по API задаётся в настройках, по умолчанию 5; профили, открытые из интерфейса, в него не входят
- Ключ, ограниченный категориями, видит и запускает только профили из них
Проверка связи
Отвечает, если локальный API включён и слушает порт. Ключ не нужен.
{ "ok": true}
curl http://127.0.0.1:50380/health const res = await fetch('http://127.0.0.1:50380/health');console.log(await res.json());// { ok: true }
Список профилей
Профили, к которым есть доступ у владельца ключа. Если ключ ограничен категориями — только профили из них. Право ключа: чтение
| Поле | Тип | Описание |
|---|---|---|
| id | string | ID профиля |
| name | string | Название |
| engine | string | firefox, chromium или android |
| os | string | ОС профиля: macos, windows, linux |
| categoryId | string | ID категории |
{ "profiles": [ { "id": "3f9a2c1e-7b4d-…", "name": "FB UA 014", "engine": "firefox", "os": "windows", "categoryId": "c7e1…" } ]}
curl http://127.0.0.1:50380/v1/profiles \ -H "Authorization: Bearer ino_live_7Qk2…"
const api = 'http://127.0.0.1:50380';const headers = { Authorization: 'Bearer ' + process.env.INO_API_KEY }; const res = await fetch(api + '/v1/profiles', { headers });const { profiles } = await res.json();
Открытые профили
Профили, открытые на этом компьютере — из интерфейса и через API. Адрес для подключения отдаётся только у запущенных через API. Право ключа: чтение
| Поле | Тип | Описание |
|---|---|---|
| profileId | string | ID профиля |
| name | string | Название на момент запуска |
| engine | string | Движок |
| stage | string | Стадия: queued, locking, engine, sync-down, launching, running, stopping, sync-up, stopped, error |
| source | string | ui или local-api |
| startedAt | string | Время старта, ISO 8601 |
| automation | object | protocol и wsEndpoint, только для local-api |
{ "running": [ { "profileId": "3f9a2c1e-7b4d-…", "name": "FB UA 014", "engine": "firefox", "stage": "running", "source": "local-api", "startedAt": "2026-11-18T09:41:07.512Z", "automation": { "protocol": "juggler", "wsEndpoint": "ws://127.0.0.1:41733/0c5e…" } } ]}
curl http://127.0.0.1:50380/v1/running \ -H "Authorization: Bearer ino_live_7Qk2…"
const api = 'http://127.0.0.1:50380';const headers = { Authorization: 'Bearer ' + process.env.INO_API_KEY }; const res = await fetch(api + '/v1/running', { headers });const { running } = await res.json();
Запуск профиля
Берёт профиль, собирает его папку, запускает браузер с отпечатком и прокси профиля и возвращает адрес для Playwright или Puppeteer. Ответ приходит, когда окно уже открыто. Право ключа: запуск
Тело запроса · необязательно| Поле | Тип | Описание |
|---|---|---|
| headless | boolean | Запуск без окна. По умолчанию false |
| Поле | Тип | Описание |
|---|---|---|
| profileId | string | ID профиля |
| protocol | string | juggler — Firefox, cdp — Chromium, adb — Android |
| wsEndpoint | string | Адрес для подключения автоматизации |
{ "profileId": "3f9a2c1e-7b4d-…", "protocol": "juggler", "wsEndpoint": "ws://127.0.0.1:41733/0c5e…"}
ID=3f9a2c1e-7b4d-4e8a-9c21-5d6f0a8b7e14 curl -X POST \ -H "Authorization: Bearer ino_live_7Qk2…" \ -H "Content-Type: application/json" \ -d '{"headless": false}' \ http://127.0.0.1:50380/v1/profiles/$ID/start
import { firefox, chromium } from 'playwright'; const api = 'http://127.0.0.1:50380';const headers = { Authorization: 'Bearer ' + process.env.INO_API_KEY };const id = '3f9a2c1e-7b4d-4e8a-9c21-5d6f0a8b7e14'; const res = await fetch(api + `/v1/profiles/${id}/start`, { method: 'POST', headers });const { protocol, wsEndpoint } = await res.json();const browser = protocol === 'cdp' ? await chromium.connectOverCDP(wsEndpoint) : await firefox.connect(wsEndpoint);
Остановка профиля
Закрывает браузер, загружает изменения папки профиля и снимает блокировку. Слот лимита одновременных запусков освобождается. Право ключа: запуск
{ "profileId": "3f9a2c1e-7b4d-…", "stopped": true}
ID=3f9a2c1e-7b4d-4e8a-9c21-5d6f0a8b7e14 curl -X POST \ -H "Authorization: Bearer ino_live_7Qk2…" \ http://127.0.0.1:50380/v1/profiles/$ID/stop
const api = 'http://127.0.0.1:50380';const headers = { Authorization: 'Bearer ' + process.env.INO_API_KEY };const id = '3f9a2c1e-7b4d-4e8a-9c21-5d6f0a8b7e14'; await fetch(api + `/v1/profiles/${id}/stop`, { method: 'POST', headers });
Ошибки
Ошибки приходят с HTTP-статусом и телом одного формата. В details — подробности, если они есть.
{ "error": { "code": "limit", "message": "Concurrent launch limit reached (5)" }}
| HTTP | code | Когда |
|---|---|---|
| 401 | unauthorized | Ключа нет, он неверный или отозван |
| 403 | forbidden | У ключа нет нужного права или профиль вне его категорий |
| 403 | no-access | У владельца ключа нет доступа «Запуск» к профилю |
| 403 | bad_host | Заголовок Host не 127.0.0.1 и не localhost |
| 403 | browser_origin | Запрос пришёл со страницы в браузере |
| 404 | not_found | Неизвестный путь |
| 402 | proxy-expired | Аренда прокси профиля истекла |
| 409 | locked | Профиль открыт у другого сотрудника |
| 409 | already-running | Профиль уже открыт на этом компьютере |
| 409 | os-mismatch | ОС профиля не совпадает с ОС компьютера |
| 409 | busy | Операция сейчас невозможна, идёт загрузка |
| 429 | limit | Достигнут лимит одновременных запусков по API |
| 501 | engine-unavailable | Движок профиля недоступен |
| 503 | not-signed-in | В клиенте никто не вошёл |
| 500 | internal | Прочие ошибки запуска |
Пример: curl
Запуск без окна и остановка из терминала. Ключ — в переменной окружения.
ID=3f9a2c1e-7b4d-4e8a-9c21-5d6f0a8b7e14# запустить профиль без окнаcurl -X POST \ -H "Authorization: Bearer $INO_API_KEY" \ -H "Content-Type: application/json" \ -d '{"headless": true}' \ http://127.0.0.1:50380/v1/profiles/$ID/start# остановитьcurl -X POST \ -H "Authorization: Bearer $INO_API_KEY" \ http://127.0.0.1:50380/v1/profiles/$ID/stop
Пример: Playwright
Профили Firefox отдают адрес Juggler — подключайтесь через firefox.connect. Профили Chromium отдают CDP — через chromium.connectOverCDP.
import { firefox } from 'playwright'; const api = 'http://127.0.0.1:50380';const headers = { Authorization: 'Bearer ' + process.env.INO_API_KEY };const id = '3f9a2c1e-7b4d-4e8a-9c21-5d6f0a8b7e14'; const res = await fetch(api + `/v1/profiles/${id}/start`, { method: 'POST', headers });const { wsEndpoint } = await res.json(); const browser = await firefox.connect(wsEndpoint);const context = browser.contexts()[0];// контекст профиля: cookies, вкладкиconst page = await context.newPage();await page.goto('https://www.browserscan.net'); await fetch(api + `/v1/profiles/${id}/stop`, { method: 'POST', headers });
import { chromium } from 'playwright'; const browser = await chromium.connectOverCDP(wsEndpoint);const context = browser.contexts()[0];const page = context.pages()[0] ?? await context.newPage();await page.goto('https://pixelscan.net');
Пример: Puppeteer
Для профилей Chromium: protocol в ответе — cdp.
import puppeteer from 'puppeteer-core'; const api = 'http://127.0.0.1:50380';const headers = { Authorization: 'Bearer ' + process.env.INO_API_KEY };const id = '3f9a2c1e-7b4d-4e8a-9c21-5d6f0a8b7e14'; const res = await fetch(api + `/v1/profiles/${id}/start`, { method: 'POST', headers });const { protocol, wsEndpoint } = await res.json();// protocol === 'cdp'const browser = await puppeteer.connect({ browserWSEndpoint: wsEndpoint });const [page] = await browser.pages();await page.goto('https://abrahamjuliot.github.io/creepjs/'); await browser.disconnect();await fetch(api + `/v1/profiles/${id}/stop`, { method: 'POST', headers });