Коды ошибок

Если запрос API завершается неудачно, API-интерфейс возвращает объект JSON, содержащий сведения об ошибке. Ниже приведены примеры ошибок, которые возвращаются, если был достигнут максимально допустимый предел запросов API.

Код
Описание
100
Пользователь не предоставил ключ API.
101
Пользователь предоставил неверный ключ API.
102
Пользователь исчерпал баланс на аккаунте.
103
Пользователь исчерпал ежемесячное разрешение на подписку.
104
Аккаунт пользователя неактивен или заблокирован.
105
Пользователь не указал обязательное значение в параметре [query].
106
Пользователь не указал обязательное значение в параметре [system].
300
Ошибка при получении результатов поиска.
301
Ошибка при получении результатов поиска с HTTP-кодом.
302
Ошибка при получении результатов поиска с кодом ошибки Яндекс API.
399
Запрос API не выполнен из-за неизвестной ошибки. Пожалуйста, обратитесь в службу поддержки и сообщите об ошибке.

API поиска Яндекс

Параметры HTTP GET запроса

Параметр
Описание
api_key
[Обязательно] Ваш ключ доступа к API, доступный на панели инструментов вашего аккаунта
query
[Обязательно] Укажите любой запрос для поиска (поддерживаются расширенные операторы, такие как site:)
system
[Обязательно] Укажите любую поисковую систему google, yandex, bing (по умолчанию: google)
domain
[Необязательно] Укажите, какой домен поисковой системы использовать: ru (по умолчанию). Другие домены Яндекса: ua, by, kz, com, com.tr
result_cnt
[Необязательно] Укажите количество результатов (по умолчанию: 10 – показывает 10 обычных результатов, MAX – 100)
lr
[Необязательно] Укажите географическое местоположение для вашего запроса, который будет обрабатываться с использованием идентификатора локального региона в формате Яндекса (по умолчанию: 213 (Москва)). Список поддерживаемых местоположений lr.csv
source
[Необязательно] Источник данных: Яндекс XML (по умолчанию) либо "живая" выдача Яндекса. Значения параметра: yandex_xml / yandex_live
output_format
[Необязательно] Представление результатов выдачи Яндекса: JSON (по умолчанию) / XML. Значения параметра: json / xml

API поиска Google

Параметры HTTP GET запроса

Параметр
Описание
api_key
[Обязательно] Ваш ключ доступа к API, доступный на панели инструментов вашего аккаунта
query
[Обязательно] Укажите любой запрос для поиска (поддерживаются расширенные операторы, такие как intext:)
system
[Обязательно] Укажите любую поисковую систему google, yandex, bing (по умолчанию: google)
domain
[Необязательно] Укажите, какой домен поисковой системы использовать: com, de, fr и т.д. (по умолчанию: com). Скачать список всех поддерживаемых доменов domains.csv
result_cnt
[Необязательно] Укажите количество результатов (по умолчанию: 10 – показывает 10 обычных результатов, MAX – 100 (10, 50, 100))
hl
[Необязательно] Укажите язык, который будет использоваться для вашего запроса (по умолчанию: en для английского). Скачать список всех поддерживаемых языков languages.csv
gl
[Необязательно] Укажите код страны, который будет использоваться для вашего запроса (по умолчанию: en для English). Скачать список поддерживаемых двухбуквенных кодов стран countries.csv
location
[Необязательно] Укажите географическое местоположение для вашего запроса, который будет обрабатываться с использованием произвольного текста в формате Google (который автоматически преобразуется в строку UULE). Скачать список поддерживаемых местоположений locations.csv
device
[Необязательно] Укажите, какое устройство использовать: desktop (по умолчанию) или mobile
output_format
[Необязательно] Представление результатов выдачи Google: JSON (по умолчанию) / XML. Значения параметра: json / xml

API поиска Bing

Параметры HTTP GET запроса

Параметр
Описание
api_key
[Обязательно] Ваш ключ доступа к API, доступный на панели инструментов вашего аккаунта
query
[Обязательно] Укажите любой запрос для поиска (поддерживаются расширенные операторы, такие как intext:)
system
[Обязательно] Укажите любую поисковую систему google, yandex, bing (по умолчанию: google)
result_cnt
[Необязательно] Укажите количество результатов (по умолчанию: 10 – показывает 10 обычных результатов, MAX – 100 (10, 50, 100))
lang
[Необязательно] Укажите язык, который будет использоваться для вашего запроса (по умолчанию: en для английского). Скачать список всех поддерживаемых языков languages.csv
country
[Необязательно] Укажите код страны, который будет использоваться для вашего запроса (по умолчанию: en для English). Скачать список поддерживаемых двухбуквенных кодов стран markets.csv
device
[Необязательно] Укажите, какое устройство использовать: desktop (по умолчанию) или mobile

Параметры ответа

Параметр
Описание
position
Возвращает позицию текущего результата органического поиска во всем списке результатов
link
Возвращает фактический URL органического результата поиска
title
Возвращает заголовок органического результата поиска
snippet
Возвращает описание органического результата поиска
res_found
Возвращает число найденных результатов в поисковых системах Яндекс и Google (также можно получить число страниц сайта в индексе по оператору site:)