Справка

Лимиты и ошибки

Лимиты экспорта

Параметр	Лимит	Рекомендация
companyIds в одном export	Нет жёсткого	Можно 5k–15k за раз; батчи — по желанию
exclude (домены)	Нет жёсткого	3000+ доменов в одном запросе работает
limit в поиске	Макс. 1000	Для больших выборок — пагинация через skip
Кредиты	Баланс подписки	1 кредит = 1 возвращённая компания

Подробные сценарии — в Экспорт и Примеры.

Rate Limits

Ограничение количества запросов в минуту:

Эндпоинт	Аноним	С API-ключом
GET / POST /v1/companies	30/мин	120/мин
POST /v1/companies/export	—	120/мин
POST /v1/referrals	—	60/мин

Заголовки Rate Limit

Заголовок	Описание
X-RateLimit-Limit	Максимум запросов в окне
X-RateLimit-Remaining	Осталось запросов
Retry-After	Секунд до сброса лимита

Превышение лимита — 429

Code
{"detail": "Слишком много запросов. Попробуйте позже."}

HTTP-коды ответов

Успешные

Код	Смысл
200	Успешный запрос

Ошибки клиента

Код	Смысл	Когда возникает
400	Некорректный ввод	Невалидные данные в теле
401	Ошибка авторизации	Неверный/отозванный key в export
402	Недостаточно кредитов	Нехватка кредитов на export
403	Доступ запрещён	Нет активной подписки
404	Не найдено	Компании не найдены (кредиты не списаны)
422	Ошибка валидации	Пустой key или companyIds; неизвестное поле в columns
429	Слишком много запросов	Превышен rate limit

Ошибки сервера

Код	Смысл
500	Внутренняя ошибка сервера

Доступ по маршрутам

Маршрут	Условия
GET / POST /v1/companies	Без ключа; контакты с маской
POST /v1/companies/export	key и companyIds в теле
POST /v1/referrals	referralCode и email в теле

Рекомендации по обработке ошибок

Экспоненциальная задержка при 429/500

Code
import time
import requests

def api_get(url, max_retries=3):
    for attempt in range(max_retries):
        response = requests.get(url)
        if response.status_code == 200:
            return response.json()
        if response.status_code == 429:
            wait = int(response.headers.get("Retry-After", 2 ** attempt))
            time.sleep(wait)
            continue
        if response.status_code >= 500:
            time.sleep(2 ** attempt)
            continue
        response.raise_for_status()
    raise RuntimeError(f"Failed after {max_retries} retries")

Проверка баланса перед массовым экспортом

Code
# Узнать объём выборки — limit минимум 1, смотрите totalCount в ответе
curl -sS --get "https://app.strokka.com/api/v1/companies" \
  --data-urlencode "search=маркетинговое агентство" \
  --data-urlencode "searchMode=hybrid" \
  --data-urlencode "limit=1"

# Сравните totalCount с creditsRemaining после первого export-запроса