Яндекс XMLProxy
Cервис Яндекс XMLProxy полностью повторяет функционал xml.yandex.ru, все передаваемые параметры можно посмотреть в документации Яндекс.XML
Для начала работы просто скопируйте уникальный URL для совершения запросов в свой софт или скрипт. Работает со всеми программами и сервисами, которые поддерживают Яндекс.XML
Пример GET запроса
Где:
&user=USER_ID - Ваш ID в нашей системе.
&key=API_KEY - Ваш секретный ключ в нашей системе.
&query=окна - Тект поискового запроса.
&lr=213 - Идентификатор страны или региона поиска. Полный список регионов можно скачать здесь.
&groupby=attr%3D%22%22.mode%3Dflat.groups-on-page%3D100.docs-in-group%3D1 - Группировки результатов (100 результатов на страницу)
В данном примере вы получите 100 результатов поиска по запросу "Окна" в регионе "Москва"
Для изменения доменной зоны Яндекса вы можете передавать GET-параметр &ydomain=ua
Поддерживаются такие зоны как: BY,UA,KZ. По умолчанию всегда используется зона RU.
Вы также можете отправлять запросы методом POST. Инструкция по POST запросам находится тут.
Ограничения по инструменту
Существуют базовые ограничения сервиса Яндекс.XML по количеству запросов в час и RPS (количество запросов в секунду), которое достаточно большое для наших аккаунтов. С нашей стороны как таковых ограничений нет. Скорость получения результатов зависит от нагрузки на сервис и количества одновременных пользователей.
Рекомендуемые настройки сбора: не более 10 одновременных потоков, до 15 запросов в секунду с одного IP адреса.
Коды возможных ошибок
Основные коды ошибок, возникающие при обработке поисковых запросов, описаны в документации Яндекс.XML.
В таблице ниже приведены коды и описания дополнительных ошибок, не указанных в основной таблице.
При этом HTTP-Code сервера = 200
| Код ошибки | Описание ошибки |
|---|---|
| 32 | Наш лимит запросов исчерпан, попробуйте в следующем часе. |
| 101 | Сервис сбора данных Yandex XML временно отключен. Ведутся технические работы, попробуйте позже. |
| -10, 55 | В данный момент сервис сильно перегружен. Попробуйте повторить запрос еще раз. Данная ошибка может возникать из-за превышения RPS со стороны Яндекс.XML |
| -32 | На вашем счету закончились деньги. Для дальнейшей работы пополните баланс в системе XMLstock.com |
| -34 | Не корректный ID пользователя или ключ |
| -37 | Задан пустой поисковый запрос (в элементе query передано пустое значение). |
| -10001 | Задан слишком длинный поисковый запрос. Длина запроса не должна превышать 400 символов. |
Деньги за запросы, с ошибками не списываются, за исключением кода 15. За данный запрос деньги будут списаны, т.к. запрос обработан корректно, а резльтатов поиска в поисковой выдаче по данному запросу не нашлось.
Ошибки сервера
Также может возникнуть ситуация, когда возникает ошибка сервера. При этом он возвращает HTTP-Code, отличный от 200-го. Это означает, что запрос не обработан и что-то пошло не так. Деньги за такие запросы не списываются.
| HTTP-код ошибки сервера | Описание ошибки |
|---|---|
| 500-502 | Внутренняя ошибка сервера. Необходимо сделать перезапрос. |
| 503 | Превышено максимально допустимое количество запросов в секунду/минуту. |
