Аутентификация и API-ключи
Все запросы к Parser API должны быть аутентифицированы с помощью API-ключа.
API-ключ
Найдите ваш API-ключ в личном кабинете в разделе API Keys.
Передайте ключ в заголовке запроса Authorization.
Никогда не раскрывайте ваш API-ключ в клиентском коде или публичных репозиториях.
Область действия и ограничения ключей
API-ключи можно ограничить доступом к URL Парсеру, Google SERP Парсеру, Yandex SERP Парсеру, Google News Парсеру, Google Trends Парсеру, Galaxy Store Reviews Парсеру, MSN Парсеру или Opera News Парсеру. Также можно задать лимит на количество разрешённых запросов в день и в месяц.
Ротация ключей
Вы можете сгенерировать новый API-ключ в любой момент через личный кабинет. При ротации ключа старый немедленно аннулируется.
Лимиты запросов
При превышении лимита API возвращает 429 Too Many Requests. Для работы с ограничениями используйте следующие заголовки ответа:
| Заголовок | Пример | Значение |
|---|---|---|
| X-Ratelimit-Limit | 100 | Количество разрешённых запросов в минуту |
| X-Ratelimit-Remaining | 60 | Оставшееся количество разрешённых запросов в текущем окне |
| X-Ratelimit-Reset | 2026-01-01T00:00:00.000Z | Время сброса окна ограничения |
| Retry-After | 2026-01-01T00:00:00.000Z | Ожидайте до этого времени перед повторным запросом |
Ошибки
Все ошибки аутентификации возвращают 401 Unauthorized
Следующие шаги
- Тарифы — как кредиты списываются за каждый запрос
- URL Парсер — создайте первую задачу парсинга URL
- Google SERP Парсер — создайте задачу Google SERP