API Вордстата^β

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

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

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

Как подключиться к API Вордстата

Шаг 1. Авторизуйтесь с Яндекс ID

1. Если у вас нет логина на Яндексе — зарегистрируйте аккаунт Яндекс ID.
2. Авторизуйтесь с Яндекс ID.

Шаг 2. Получите OAuth-токен

На странице приложений создайте приложение и получите токен:

1. В блоке Redirect URI выберите Подставить URL для отладки.

   

2. Выберите доступ по крайней мере к одному типу данных.

   

Шаг 3. Зарегистрируйте идентификатор

На странице созданного приложения найдите идентификатор ClientId.

Шаг 4. Подайте заявку на доступ к API

Для подключения к API обратитесь в поддержку Яндекс Директа и сообщите свой логин и идентификатор ClientId.

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

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

• общая квота на весь API. В случае если она превышена, вы получите HTTP-ответ с кодом 503 Service unavailable, try again later;

• персональная квота, привязанная к OAuth-токену с ограничениями:

  • на число запросов в секунду (старайтесь не задавать много запросов одновременно, чтобы не перегружать сервис);
  • на число запросов в сутки.

  В случае превышения квоты вы получите HTTP-ответ с кодом 429 Quota limit exceeded, try again later. Time to refill: N seconds. В ответе будет оценка времени, когда снова можно будет обращаться к API.