Локальный API

Запускайте профили из своих скриптов и подключайте Playwright или Puppeteer к уже открытому браузеру — с отпечатком, прокси и cookies профиля.

http://127.0.0.1:50380JSONBearer-ключJuggler · CDP

Быстрый старт

API работает внутри десктоп-клиента inoBrowser и слушает только 127.0.0.1. Клиент должен быть открыт, а вы — вошли в аккаунт.

  1. Включите APIВ клиенте: Настройки → Локальный API. Порт по умолчанию 50380, можно задать любой от 1024 до 65535. С версии 0.1.17 порт по умолчанию — 50380 (раньше 50325, он совпадал с Local API AdsPower): после обновления клиент сам переключает старый порт по умолчанию, порт, заданный вручную, не меняется. Если порт занят другой программой, в настройках будет ошибка «Порт N занят другой программой».
  2. Выпустите ключНастройки → API-ключи → «Выпустить ключ» с правами «чтение» и «запуск и остановка». Ключ показывается один раз.
  3. Проверьте связьЗапрос к /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_… в одном из заголовков. Ключ не даёт прав больше, чем у сотрудника, который его выпустил.

ЗаголовокЗначение
AuthorizationBearer ino_live_…
X-API-Keyino_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; профили, открытые из интерфейса, в него не входят
  • Ключ, ограниченный категориями, видит и запускает только профили из них

Проверка связи

GET/health

Отвечает, если локальный API включён и слушает порт. Ключ не нужен.

Ответ200
application/json
{  "ok": true}
Запрос
curl http://127.0.0.1:50380/health

Список профилей

GET/v1/profiles

Профили, к которым есть доступ у владельца ключа. Если ключ ограничен категориями — только профили из них. Право ключа: чтение

ПолеТипОписание
idstringID профиля
namestringНазвание
enginestringfirefox, chromium или android
osstringОС профиля: macos, windows, linux
categoryIdstringID категории
Ответ200
application/json
{  "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…"

Открытые профили

GET/v1/running

Профили, открытые на этом компьютере — из интерфейса и через API. Адрес для подключения отдаётся только у запущенных через API. Право ключа: чтение

ПолеТипОписание
profileIdstringID профиля
namestringНазвание на момент запуска
enginestringДвижок
stagestringСтадия: queued, locking, engine, sync-down, launching, running, stopping, sync-up, stopped, error
sourcestringui или local-api
startedAtstringВремя старта, ISO 8601
automationobjectprotocol и wsEndpoint, только для local-api
Ответ200
application/json
{  "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…"

Запуск профиля

POST/v1/profiles/{id}/start

Берёт профиль, собирает его папку, запускает браузер с отпечатком и прокси профиля и возвращает адрес для Playwright или Puppeteer. Ответ приходит, когда окно уже открыто. Право ключа: запуск

Тело запроса · необязательно
ПолеТипОписание
headlessbooleanЗапуск без окна. По умолчанию false
Ответ
ПолеТипОписание
profileIdstringID профиля
protocolstringjuggler — Firefox, cdp — Chromium, adb — Android
wsEndpointstringАдрес для подключения автоматизации
Ответ200
application/json
{  "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

Остановка профиля

POST/v1/profiles/{id}/stop

Закрывает браузер, загружает изменения папки профиля и снимает блокировку. Слот лимита одновременных запусков освобождается. Право ключа: запуск

Ответ200
application/json
{  "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

Ошибки

Ошибки приходят с HTTP-статусом и телом одного формата. В details — подробности, если они есть.

HTTP 429
{  "error": {    "code": "limit",    "message": "Concurrent launch limit reached (5)"  }}
HTTPcodeКогда
401unauthorizedКлюча нет, он неверный или отозван
403forbiddenУ ключа нет нужного права или профиль вне его категорий
403no-accessУ владельца ключа нет доступа «Запуск» к профилю
403bad_hostЗаголовок Host не 127.0.0.1 и не localhost
403browser_originЗапрос пришёл со страницы в браузере
404not_foundНеизвестный путь
402proxy-expiredАренда прокси профиля истекла
409lockedПрофиль открыт у другого сотрудника
409already-runningПрофиль уже открыт на этом компьютере
409os-mismatchОС профиля не совпадает с ОС компьютера
409busyОперация сейчас невозможна, идёт загрузка
429limitДостигнут лимит одновременных запусков по API
501engine-unavailableДвижок профиля недоступен
503not-signed-inВ клиенте никто не вошёл
500internalПрочие ошибки запуска

Пример: curl

Запуск без окна и остановка из терминала. Ключ — в переменной окружения.

start-stop.sh
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.

firefox.mjs
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 });
chromium.mjs
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.

puppeteer.mjs
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 });

Запустите профиль из своего скрипта

© 2026 inoBrowserinobrowser.run