Каждый тарифный план сервиса API Search предусматривает два обязательных лимита, которые не могут быть превышены в течение отчетного периода продолжительностью 30 дней:
- лимит на количество ключевых слов, по которым вы можете произвести поиск
- лимит на общее количество запросов, доступных для выполнения
Под термином "количество ключевых слов" следует понимать количество уникальных поисковых выражений, которые вы передаете в параметре q.
Ниже приведены примеры уникальных поисковых выражений:
лисалиса | волклиса | заяц | слон | жираф
При выполнении запроса на поиск публикаций с уникальным поисковым выражением расходуется квота на количество ключевых слов.
Повторные запросы
При повторных запросах по поисковым выражениям, которые уже были использованы ранее в отчетном периоде - квота на количество ключевых слов не расходуется.
Рассмотрим пример:
Вы последовательно выполняете запросы на поиск публикаций со следующими значениями параметра q:
лисалиса | волклиса | заяц | слон | жирафлисалиса | волк
В данном примере будет израсходовано 3 ключевых слова (т.к. в четвертом и пятом запросе передаются поисковые выражения, которые уже были использованы ранее) и 5 запросов (запросы расходуются при каждом обращении к API, независимо от того повторные они или уникальные).
Как следить за расходованием квоты?
Для отслеживания расходования квоты предусмотрен метод usage/stat, если вы хотите отслеживать лимиты программным путем:
Аналогичная статистика также доступна для просмотра в ручном режиме в вашем личном кабинете:
При исчерпании лимита на количество ключевых слов API вернёт ошибку quota_keywords_reached.
При исчерпании лимита на общее количество запросов API вернет ошибку quota_requests_reached.
Как увеличить лимиты?
Увеличение лимитов в рамках действующей подписки невозможно. Вам необходимо перейти на тариф с подходящими под ваши задачи лимитами.