API Букварикса
получение данных в автоматическом режиме
API доступен по следующему основному URL:
http://api.bukvarix.com
У API Букварикса имеется как бесплатная, так и платная версия. Возможности бесплатной версии ограничены, они соответствуют ограничениям бесплатного режима без регистрации, см. Тарифные планы. Через бесплатный API можно запросить ключевые слова как в режиме простого поиска (поиск по одной фразе), так и в режиме расширенного поиска (по спискам до 10 поисковых слов и до 20 слов-исключений), а также ключевые слова для одного домена, отчеты сравнения двух и трех доменов. Ключ для доступа к бесплатному API: free
Примечания:
Значения параметров в запросе, в которых есть буквы русского языка и специальные символы, нужно передавать в виде экранированных последовательностей по правилам percent-encoding. Например, запрос слова "яблоко", перекодированый в соответствии с percent-encoding, будет выглядеть как "%D1%8F%D0%B1%D0%BB%D0%BE%D0%BA%D0%BE". Подробнее: https://ru.wikipedia.org/wiki/URL#Кодирование_URL
Для POST запросов Content-Type должен быть application/x-www-form-urlencoded.
В платной версии API увеличены лимиты запросов, ключи индивидуальны. Для того, чтобы перейти на платный API, свяжитесь с нами и опишите ваши задачи, мы уточним стоимость API для ваших задач.
Отчеты в кодировке UTF-8 доступны в следующих форматах:
- в TXT формате (простой список слов)
- в JSON формате (массивы строк, разделенные запятыми)
- в CSV формате (разделитель полей точка с запятой, текстовые значения заключаются в кавычки)
- в TSV формате (разделитель полей табуляция, текстовые значения не заключаются в кавычки)
В случае успеха сервис возвращает данные и статус 200 (успешный код состояния HTTP).
В случае ошибки возвращается ошибочный статус HTTP и описание ошибки.
Возможные ошибки:
400 - неверный запрос (неправильно указаны параметры при запросе, пропущены обязательные параметры),
401 - ошибка авторизации (не указан ключ API, неверный ключ API, ключ API заблокирован, срок действия ключа API истек),
402 - превышены лимиты (превышено количество запросов, запрашивается больше строк в отчете, чем разрешено),
429 - превышена частота запросов, сделайте паузу и повторите запрос позже,
500 - внутренняя ошибка сервера (в случае ошибки обратитесь в службу поддержки),
503 - на сервере ведутся плановые работы, повторите запрос позже.
Примечание:
Если вы получили ошибку 402, то скорее всего превышено какое-либо ограничение бесплатной версии API. Ограничения бесплатного API соответствуют версии аккаунта без регистрации.
Если вы получаете ошибку 429, то вам нужно сделать паузу и только после этого продолжать запросы (бесплатный API, в отличии от платного, лимитирован по частоте запросов с одного IP).
В начале файла может присутствовать сигнатура UTF-8 (BOM - 3 байта EF BB BF).
Сигнатура нужна в некоторых случаях для правильного определения кодировки. Например, если указана сигнатура UTF-8 то (в большинстве случаев), последние версии MS Excel откроют в верной кодировке отчет Букварикса в формате .csv.
Если необязательный параметр bom не указан, то наличие или отсутствие сигнатуры зависит от формата.
| Формат файла отчета | Наличие сигнатуры UTF-8 по умолчанию |
|---|---|
| txt | да |
| json | нет |
| csv | да |
| tsv | нет |
