API Вордстата

API позволяет получать данные Вордстата в формате, удобном для автоматической обработки. В настоящее время поддерживается формат JSON. Взаимодействие с API организовано по протоколу HTTPS. Адрес для отправки запросов к API: https://api.wordstat.yandex.net.

Для доступа к API необходимо:

Получить OAuth-токен.
Зарегистрировать идентификатор ClientId.
Передавать токен с каждым запросом в HTTP-заголовке Authorization: Authorization: Bearer <OAuth-токен>.

Ограничения использования

Доступ к API ограничен квотой. Есть два вида квоты:

общая квота на весь API. В случае если она превышена, вы получите HTTP-ответ с кодом 503 Service unavailable, try again later;
персональная квота, привязанная к OAuth-токену с ограничениями:
- на число запросов в секунду (старайтесь не задавать много запросов одновременно, чтобы не перегружать сервис). По умолчанию — 10 запросов в секунду;
- на число запросов в сутки. По умолчанию — 1 000 запросов в сутки.
В случае превышения квоты вы получите HTTP-ответ с кодом 429 Quota limit exceeded, try again later. Time to refill: N seconds. В ответе будет оценка времени, когда снова можно будет обращаться к API.