API

API повертає ваші власні дані й більше нічого: картки продуктів на вашому обліковому записі, їхню ефективність, відгуки, які люди на них залишили, та конкурентів, за якими ви стежите. Це API лише для читання. Усе, що змінює дані, робиться в особистому кабінеті, тож викрадений ключ дозволить скопіювати ваші цифри, але не дозволить редагувати картку, витрачати гроші чи зачепити чужий обліковий запис.

Воно безкоштовне, як і все інше тут. Кожен обліковий запис може видати ключ в особистому кабінеті.

Ключ

Створіть ключ в особистому кабінеті, на вкладці Інструменти для карток, у блоці «Експорт і доступ до API». Він виглядає як sl_, за яким ідуть 48 шістнадцяткових символів, а в кабінеті показано дату його видачі.

Один ключ на обліковий запис. Натискання кнопки «Новий ключ» видає свіжий, а попередній ключ у ту ж мить перестає працювати. Перехідного періоду немає, і другого ключа паралельно теж немає, тож змінюйте ключ тоді, коли готові оновити все, що ним користується.

Замініть ключ, якщо він потрапив у публічний репозиторій, спільний документ, браузер або сервіс, яким ви більше не користуєтеся. Заміна триває одне натискання й нічого не коштує.

Відкличте ключ, видаливши його в тому самому блоці. Обліковий запис продовжить працювати, зупиниться лише доступ до API.

Ставтеся до ключа як до пароля. Зберігайте його на сервері, у змінній середовища або сховищі секретів, але ніколи у фронтенд-коді: усе, що є в браузері, може прочитати кожен, хто відкриє сторінку. Заголовків CORS на цих кінцевих точках ми навмисно не надсилаємо, тому сторінка в браузері на іншому домені не зможе викликати їх із вашим ключем.

Як викликати

Кожен запит передає ключ у заголовку Authorization. Базова адреса: https://saasledge.com/api/v1.

curl -H "Authorization: Bearer sl_your_key" \
  https://saasledge.com/api/v1/me

Відповіді мають формат JSON із "ok": true. Помилки мають таку саму структуру з "ok": false і коротким машиночитним кодом.

Ліміт становить 120 запитів на хвилину на ключ. Для нічного експорту цього з запасом, а для циклу, який забув зупинитися, замало.

GET /api/v1/me

Обліковий запис, якому належить ключ, і ліміти, за якими рахується все інше. Використовуйте це як перевірку працездатності.

{
  "ok": true,
  "account": {
    "email": "[email protected]",
    "products": 3,
    "since": "2026-08-13"
  },
  "key": { "issued_at": "2026-08-14 09:12:33" },
  "limits": {
    "products": 25,
    "watches": 25
  },
  "rate": { "limit": 120, "per": "minute" }
}

GET /api/v1/products

Ваші картки з усім, що на них опубліковано: стан, категорія, модель оплати, тарифи, кількість знімків екрана, кількість відгуків і середня оцінка. Кожен елемент містить url_on_saasledge, публічну адресу картки.

curl -H "Authorization: Bearer sl_your_key" \
  https://saasledge.com/api/v1/products

GET /api/v1/stats

Перегляди ваших карток і кліки на ваш сайт, згруповані за днями.

Дні без подій не повертаються. Підсумки вже пораховано в totals, зокрема коефіцієнт кліків у відсотках.

curl -H "Authorization: Bearer sl_your_key" \
  "https://saasledge.com/api/v1/stats?days=90&format=csv" -o stats.csv

GET /api/v1/reviews

Опубліковані відгуки на ваші картки з вашими відповідями та датами. Поле without_reply показує кількість тих, що досі чекають на відповідь, і саме на це число варто налаштувати сповіщення.

Електронні адреси авторів відгуків не повертаються ніколи. Їх збирають, щоб ми могли перевірити відгук, а не щоб на них писали.

GET /api/v1/watches

Конкуренти зі списку, за яким ви стежите: початкова ціна зараз і до останньої зміни, кількість тарифів, прапорці безкоштовного тарифу та пробного періоду, рейтинг, кількість відгуків і історія цін у межах вікна. Та сама відповідь містить mine: початкову ціну та кількість тарифів ваших власних опублікованих карток, тож для порівняння потрібен один запит, а не два.

Чого API не робитиме

Воно не покаже приватних даних іншого постачальника, нічого не запише й не експортує весь каталог. Масове копіювання каталогу ми не продаємо, і ключ його не відкриває.

Запитання або сценарій, якому потрібне поле, яке ми ще не повертаємо: пишіть на [email protected] і розкажіть, що ви створюєте.