Перейти к основному содержимому

Лимиты и ограничения

Rate Limiting API​

Жёсткий лимит

Не чаще 1 запроса в 5 секунд на один аккаунт. Это касается всех эндпоинтов API без исключения.

# Обязательная задержка между запросами
import time

def api_request(endpoint, data):
    time.sleep(5)  # ОБЯЗАТЕЛЬНО!
    response = httpx.post(endpoint, json=data, headers=headers)
    return response.json()

Последствия превышения​

  • Запросы будут отклонены (HTTP 429)
  • При систематическом нарушении возможна временная блокировка
  • Рекомендуется экспоненциальный backoff при ошибках

Рекомендации по оптимизации​

  1. Кешируйте результаты локально — сохраняйте данные в SQLite и обновляйте по расписанию
  2. Распределяйте запросы — не делайте все запросы в одну минуту, распределите по часам
  3. Используйте пагинацию эффективно — запрашивайте максимум записей за один вызов (take: 500)
  4. Мониторьте потребление — логируйте каждый запрос для анализа

Дневные лимиты запросов (веб-интерфейс)​

ТарифЗапросов в день
FreeОграничено (небольшая квота)
Start600
Business2 000
Pro5 000
Как считаются запросы

Каждое обращение к данным SalesFinder (поиск товара, анализ ниши, проверка позиции) считается одним запросом.

Мониторинг позиций​

ТарифЗапросов мониторинга
Start100
Business200
Pro500

Подключение магазинов​

ТарифМагазинов
Start2
Business4
Pro8

Пользователи аккаунта​

ТарифПользователейAPI-доступ
Start1Нет
Business2Нет
Pro5Только основной
подсказка

На тарифе Pro API-доступ имеет только основной аккаунт. Суб-пользователи работают через веб-интерфейс.

Хранение данных​

ТарифГлубина аналитики
Start30 дней
Business60 дней
ProБез ограничений
Потеря данных

При переходе с Pro на более низкий тариф исторические данные за пределами нового срока могут стать недоступны. Экспортируйте данные перед сменой тарифа.

Проекты отслеживания изменений​

ТарифПроектов
Start3
Business10
Pro20

Сводная таблица всех лимитов​

ПараметрFreeStartBusinessPro
Запросов/день~506002 0005 000
Мониторинг позиций-100200500
Магазинов-248
Пользователей1125
Глубина данных7 дней30 дней60 днейБез ограничений
Проекты отслеживания-31020
Мониторинг РРЦ/день--1 0005 000
Автоотзывы (сценариев)-2520
Репрайсер (товаров)--100500
Частота репрайсера--3 часа1 час
Рекламных кампаний--100500
Внешняя реклама/день--100500
Доступ к APIНетНетНетДа
API rate limit---1 запрос / 5 сек
JWT токен---3 ч (refresh +1 ч)
МаркетплейсыТолько WBТолько WBWB + OzonWB + Ozon
Цена/мес0 ₽5 000 ₽9 000 ₽20 000 ₽
Цена/мес (годовая)0 ₽3 500 ₽6 300 ₽14 000 ₽

API-специфичные ограничения​

Авторизация​

ПараметрЗначение
Тип токенаJWT (Bearer)
Срок жизни3 часа
Refresh+1 час
Метод логинаemail + password
ФорматAuthorization: Bearer {token}

Версионирование​

API использует версионирование в URL: /api/2025_09/...

При обновлении версии старые эндпоинты могут быть отключены. Следите за обновлениями документации на api.salesfinder.ru/docs.

Количество эндпоинтов​

ГруппаЭндпоинтов
Авторизация3
Управление магазинами4
Репрайсер (сценарии)5
Репрайсер (товары)4
Внешняя аналитика (категории)6
Внешняя аналитика (товары)6
Итого28

Расчёт пропускной способности API​

При rate limit 1 запрос / 5 секунд:

ПериодМаксимум запросов
1 минута12
1 час720
24 часа17 280
За 3 часа (жизнь токена)2 160
Практический расчёт

Для синхронизации 1000 товаров с данными по ключевым словам:

  • product/info × 1000 = 5 000 сек (~83 мин)
  • product/keywords × 1000 = 5 000 сек (~83 мин)
  • Итого: ~166 минут = ~2.8 часа

При таком объёме потребуется refresh токена или повторная авторизация.

Рекомендации для интеграции с Platrum Spider​

  1. Token refresh: встроить автоматическое обновление токена за 15 мин до истечения
  2. Локальное кеширование: хранить данные SF в SQLite (таблица salesfinder_*)
  3. Расписание синхронизации: раз в 6 часов (достаточно для аналитики, не перегружает API)
  4. Retry с backoff: при 429 ответе — ждать 10 секунд, затем 20, 40 (экспоненциально)
  5. Логирование: записывать каждый API-вызов в write_audit_log