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