Отримати API токен
Створіть токен, щоб почати отримувати ціни та розумну ціну для вашого магазину.
Огляд
Цей API дозволяє вашому магазину отримувати актуальну ринкову ціну та значення розумної ціни, згенероване системою.
Кожен токен може мати власний ліміт запитів; перевищення повертає HTTP 429.
Базовий URL
/api/v1
Авторизація
Bearer токен або заголовок X-API-KEY
Аутентифікація
Створюйте токени в Налаштування → API доступ. Токени мають скоупи та ліміти. Зберігайте їх у таємниці.
Потрібний scope для експорту цін: prices:read
Authorization: Bearer <TOKEN>
X-API-KEY: <TOKEN>Ендпоїнти
GET
/api/v1/prices?ids=1,2,3
Повертає ціни для списку ідентифікаторів треків.
curl -H "Authorization: Bearer <TOKEN>" \
"https://your-domain.com/api/v1/prices?ids=12,15,18"
GET
/api/v1/prices/{track_id}
Повертає ціну для одного треку за ID.
curl -H "Authorization: Bearer <TOKEN>" \
"https://your-domain.com/api/v1/prices/12"Поля відповіді
track_id
ID треку в системі.
market_price
Остання ціна, зафіксована на маркетплейсі.
smart_price
Значення розумної ціни, згенероване системою.
last_checked_at
Час останньої успішної перевірки.
price_tracked
True, якщо ціну вдалося розпарсити.
unavailable_reason
Причина недоступності ціни (наприклад, http_404, price_missing, out_of_stock, blocked_by_protection).
Поведінка розумної ціни
- Якщо розумне ціноутворення вимкнене, smart_price дорівнює null.
- Якщо режим auto, smart_price дорівнює останній авто-ціні (user_price), якщо вона є.
- Якщо режим recommend, smart_price дорівнює останній рекомендації.
- API повертає останнє обчислене значення; воно оновлюється під час планових перевірок, а не запитів API.
Приклад відповіді
{
"data": {
"track_id": 12,
"market_price": 1299.99,
"currency": "UAH",
"last_checked_at": "2026-01-27T11:42:19+00:00",
"price_tracked": true,
"unavailable_reason": null,
"unavailable_at": null,
"smart_price": 1259.99,
"smart_pricing": {
"enabled": true,
"mode": "auto",
"percent": -3,
"floor": null,
"last_status": "auto"
}
}
}Помилки
401 Неавторизовано — відсутній або недійсний токен
403 Заборонено — токен не має потрібного scope
404 Не знайдено — трек не знайдено
422 Необроблюваний запит — потрібний параметр ids
429 Забагато запитів — перевищено ліміт запитів