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] и расскажите, что вы создаёте.