API Зорко

Данные вашего магазина — те же, что в отчётах кабинета, — в JSON или CSV для своих скриптов, BI-систем и таблиц. Только чтение.

Ключ и авторизация

В кабинете откройте «Настройки магазина» → «API-ключи» → «Создать ключ». Ключ показывается один раз — сохраните его.
Передавайте ключ в заголовке Authorization: Bearer <ключ>. В адресе и параметрах ключ не принимается.
Ключ действует для одного магазина. Отозвать его можно там же, где создали; в базе хранится только хеш ключа.

Пример запроса

curl -H "Authorization: Bearer zk_…" \
  "https://zorko.pro/api/v1/public/sales?from=2026-10-01&to=2026-10-07"

Ответ:

{
  "shop": { "id": "a1b2c3", "name": "Основной магазин", "marketplace": "ozon" },
  "period": { "from": "2026-10-01", "to": "2026-10-07" },
  "title": "Прибыль по дням",
  "rows": [ { "day": "2026-10-01", "revenue": 48200, "expenses": 31100, "profit": 17100, "exp_commission": 15400, "exp_ads": 3200 } ]
}

С format=csv приходит таблица с заголовками на русском, разделитель — запятая, в начале файла BOM (Excel и Google Sheets откроют без настройки). Добавьте excel=1, чтобы получить точку с запятой и запятую в числах.

Методы

sales — Продажи и прибыль по дням
products — Товары: заказы, остаток, юнит-экономика
stocks — Остатки
finance — Начисления по дням
ads — Реклама по кампаниям
returns — Возвраты по товарам
cashflow — Платёжный календарь по неделям

`GET https://zorko.pro/api/v1/public/sales`

Продажи и прибыль по дням. Выручка, расходы по группам и прибыль по дате начисления площадки — как на вкладке «Продажи и прибыль».

Параметры: from — начало периода, ГГГГ-ММ-ДД; to — конец периода, ГГГГ-ММ-ДД (без from/to — последние 28 дней до вчерашнего); format — json (по умолчанию) или csv.

Пример строки в rows:

{
  "day": "2026-10-02",
  "revenue": 1000,
  "expenses": 530,
  "profit": 470,
  "exp_commission": 470,
  "exp_tax": 60
}

`GET https://zorko.pro/api/v1/public/products`

Товары: заказы, остаток, юнит-экономика. Строка на товар: воронка, заказы, остаток, упущенная выручка, себестоимость, прибыль и маржа за период.

Параметры: from — начало периода, ГГГГ-ММ-ДД; to — конец периода, ГГГГ-ММ-ДД (без from/to — последние 28 дней до вчерашнего); q — поиск по артикулу, SKU или названию; sort — поле сортировки (например, orderedRub, profit); dir — asc или desc; limit — сколько строк отдать; offset — сколько строк пропустить; format — json (по умолчанию) или csv.

Пример строки в rows:

{
  "sku": "123456",
  "offer": "W914/2",
  "name": "Фильтр масляный",
  "orderedQty": 12,
  "orderedRub": 5400,
  "stockAll": 30,
  "profit": 1200,
  "margin": 22.2
}

`GET https://zorko.pro/api/v1/public/stocks`

Остатки. Остаток по товарам на последний день, за который загружены склады: FBO, FBS, резерв, стоимость остатка.

Параметры: day — день остатков, ГГГГ-ММ-ДД (по умолчанию — последний загруженный); limit — сколько строк отдать; format — json (по умолчанию) или csv.

Пример строки в rows:

{
  "sku": "123456",
  "offer": "W914/2",
  "free": 24,
  "fbs": 6,
  "reserved": 2,
  "costRub": 9000,
  "retailRub": 13500
}

`GET https://zorko.pro/api/v1/public/finance`

Начисления по дням. Факты финансов площадки по дням: продажи, возвраты, комиссии, услуги, итог начислений, выплаты и остаток на балансе.

Пример строки в rows:

{
  "day": "2026-10-02",
  "sales": 1000,
  "returns": 0,
  "salesFee": -470,
  "returnsFee": 0,
  "services": -120,
  "accrued": 410,
  "payments": 0,
  "closingBalance": 15300
}

`GET https://zorko.pro/api/v1/public/ads`

Реклама по кампаниям. Расход, показы, клики, заказы и ДРР по кампаниям за период.

Пример строки в rows:

{
  "id": "100500",
  "title": "Фильтры",
  "spent": 3200,
  "views": 15000,
  "clicks": 420,
  "orders": 18,
  "ordersMoney": 9800,
  "drr": 32.7
}

`GET https://zorko.pro/api/v1/public/returns`

Возвраты по товарам. Продано и возвращено по каждому товару, доля возвратов, причины — за период.

Параметры: from — начало периода, ГГГГ-ММ-ДД; to — конец периода, ГГГГ-ММ-ДД (без from/to — последние 28 дней до вчерашнего); q — поиск по артикулу, SKU или названию; limit — сколько строк отдать; format — json (по умолчанию) или csv.

Пример строки в rows:

{
  "sku": "123456",
  "offer": "W914/2",
  "soldQty": 40,
  "retQty": 2,
  "retRub": 900,
  "retShare": 4.8
}

`GET https://zorko.pro/api/v1/public/cashflow`

Платёжный календарь по неделям. Ожидаемые выплаты площадки, плановые расходы и остаток денег по неделям вперёд; weeks — от 4 до 16.

Параметры: weeks — горизонт календаря в неделях, 4–16 (по умолчанию 8); format — json (по умолчанию) или csv.

Пример строки в rows:

{
  "index": 1,
  "from": "2026-10-06",
  "to": "2026-10-12",
  "inflow": 48200,
  "outflow": 15000,
  "balanceStart": 20000,
  "balanceEnd": 53200
}

Лимиты

Не больше 60 запросов в минуту на ключ. Остаток лимита — в заголовке X-RateLimit-Remaining; при превышении — ответ 429 и заголовок Retry-After в секундах.
Период — не длиннее 400 дней; у товаров и остатков — до 2 000 и 5 000 строк за запрос (limit, offset).
Данные обновляются обменом с площадкой по расписанию кабинета; «сегодня» у площадок неполное.

Коды ошибок

HTTP	code	Что значит
401	`API_KEY_REQUIRED`	Нет заголовка Authorization: Bearer.
401	`API_KEY_INVALID`	Ключ не найден или отозван.
402	`PAYMENT_REQUIRED`	Подписка владельца магазина закончилась — данные сохранены, API закрыт.
404	`API_METHOD_UNKNOWN`	Такого метода нет; список — в ответе.
405	`METHOD_NOT_ALLOWED`	API принимает только GET.
429	`RATE_LIMITED`	Превышен лимит запросов в минуту.
500	`INTERNAL`	Ошибка сервиса — повторите позже.

Тело ошибки — JSON: { "code": "…", "message": "…" }, текст на русском.

Получить ключ в кабинете