Документация по работе с API Яндекс, Google и Bing
Коды ошибок
Если запрос 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 (по умолчанию).![]() |
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 и т.![]() |
result_cnt |
[Необязательно] Укажите количество результатов (по умолчанию: 10 – показывает 10 обычных результатов, MAX – 100 (10, 50, 100)) |
hl |
[Необязательно] Укажите язык, который будет использоваться для вашего запроса (по умолчанию: en для английского). Скачать список всех поддерживаемых языков languages.csv |
gl |
[Необязательно] Укажите код страны, который будет использоваться для вашего запроса (по умолчанию: en для English). Скачать список поддерживаемых двухбуквенных кодов стран countries.csv |
location |
[Необязательно] Укажите географическое местоположение для вашего запроса, который будет обрабатываться с использованием произвольного текста в формате Google (который автоматически преобразуется в строку UULE).![]() |
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 для английского).![]() |
country |
[Необязательно] Укажите код страны, который будет использоваться для вашего запроса (по умолчанию: en для English). Скачать список поддерживаемых двухбуквенных кодов стран markets.csv |
device |
[Необязательно] Укажите, какое устройство использовать: desktop (по умолчанию) или mobile |
Параметры ответа
Параметр |
Описание |
---|---|
position |
Возвращает позицию текущего результата органического поиска во всем списке результатов |
link |
Возвращает фактический URL органического результата поиска |
title |
Возвращает заголовок органического результата поиска |
snippet |
Возвращает описание органического результата поиска |
res_found |
Возвращает число найденных результатов в поисковых системах Яндекс и Google (также можно получить число страниц сайта в индексе по оператору site:) |
Параметры и методы — API Яндекс :: XMLRiver
Кроме установки необходимых настроек запросов в аккаунте, вы можете передавать эти параметры через GET запрос.
ВАЖНО! Переданные параметры в GET запросе имеют приоритет перед параметрами, установленными в настройках аккаунта!
Наименование |
Обязательно | Описание |
---|---|---|
query | да | Параметр определяет строку запроса поиска. Вы можете использовать любые запросы, как если бы Вы делали поиск в Google, кроме символа амперсанда (&), который необходимо заменять на код %26 |
groupby |
нет |
Числовое значение, ТОП позиций для сбора. Возможные значения: 10. |
page | нет | Числовое значение, определяет страницу поисковой выдачи. В Яндексе страницы нумеруются начиная с нуля. |
highlights | нет | Подсветка ключевых слов.![]() При передаче параметра highlights=1 тайтл и сниппет заключаются в контейнер <![CDATA[…]]> и содержат тег <hlword> в который заключены выделенные жирным слова из выдачи, если таковые присутствуют. |
Наименование |
Обязательно | Описание |
---|---|---|
lr | нет |
числовое значение (id) местоположения (регион Яндекса) |
Наименование |
Обязательно | Описание |
---|---|---|
lang | нет |
Код языка Яндекса: ru, uk… |
domain | нет |
Строка yandex домена. |
Наименование |
Обязательно | Описание |
---|---|---|
device | нет |
Устройство, на котором выполняется поиск: desktop, tablet, mobile |
raw | нет | При передаче параметра raw=page мы возвращаем полный html код страницы яндекса. При передаче этого значения, параметр delayed игнорируется. Т.е. получать полный html код страницы яндекса в режиме отложенного ответа нельзя. |
Пример:
http://xmlriver.com/search_yandex/xml?user=[user_id]&key=[key]&groupby=10&lang=ru
API поиска Яндекса — доступ к результатам поисковой выдачи Яндекса в режиме реального времени
Доступ к результатам поиска Яндекса с помощью нашего сверхнадежного, быстрого и доступного API поисковой выдачи Яндекса.
К сожалению, эта конечная точка больше не поддерживается. Наш API возвращает самые свежие свежие данные со 100% точностью.
Формат JSON или Raw HTML
Используйте нашу обычную конечную точку для получения результатов поиска Google в формате JSON или используйте нашу расширенную конечную точку, если вам нужны необработанные данные HTML.
Результаты для конкретного местоположения
Доступ к результатам из любой точки мира. Установите требования к местоположению по стране, городу или даже координатам GPS.
Что говорят клиенты
Мы использовали множество различных поставщиков API, и SerpsBot является лучшим с точки зрения времени отклика, цены и надежности. Поддержка тоже отличная. Очень приятно работать с командой SerpsBot.
Jens Brandt
Founder, Docoloc
PricingFeatures | Yandex Endpoint |
---|---|
Real-time results | Yes |
Время отклика | Менее 3 секунд |
Количество результатов на запрос | 100 |
Multiple page requests | Yes |
Result formats | JSON or Raw HTML |
Concurrency (default) * | 500 requests per second |
Стоимость ** | 0,002 долл. 2 долл. США за 1000 запросов |
9 16 0064 К сожалению, эта конечная точка больше не поддерживается. |
* Уровень параллелизма можно настроить, если требуется большее количество запросов в секунду.
** Собираетесь ли вы делать большие объемы вызовов API (более 250 000 в месяц)? Мы можем предложить вам индивидуальную цену, свяжитесь с нами.
Что включено
Быстрая интеграция
Наш API прост в дизайне и совместим с большинством основных языков программирования.
Простая документация
Начните использовать наш API за считанные минуты с нашей простой документацией.
Служба технической поддержки
Наша служба технической поддержки работает каждый день, чтобы помочь ответить на любые вопросы или решить проблемы.
JSON или Raw HTML
Запросы отправляются с использованием HTTP GET, ответы доставляются в облегченном формате JSON или Raw HTML.
Любое местоположение/устройство
Собирайте данные из любого города, региона или страны по всему миру, используя любое устройство (настольный компьютер, мобильный телефон, планшет).
Все функции поиска
Получите все функции поисковой выдачи одним нажатием, люди также спрашивают, избранные фрагменты и многое другое.
faqВ каких форматах вы предоставляете результаты Яндекса?
Наш расширенный эндпоинт Яндекса возвращает данные в формате JSON или необработанный HTML.
Наш API использует параметр параллелизма по умолчанию, равный 500 запросам в секунду. Если вам нужно делать больше запросов в секунду, мы можем настроить вашу настройку.
Предоставляете ли вы данные в режиме реального времени?Да. Наш поисковый API Яндекса предоставляет данные в режиме реального времени. Данные зависят от устройства определения местоположения и языка, который вы укажете.
Какую поддержку клиентов вы предоставляете?Мы доступны с понедельника по пятницу с 08:00 до 19:00 по Гринвичу. Наша служба технической поддержки также доступна в выходные дни; однако ответы могут быть медленнее.
Существует ли верхний предел для вызовов API? Нет, верхнего предела нет. Мы можем и поддерживаем корпоративное использование (несколько миллионов звонков в месяц). Наш API поиска Яндекса работает на инфраструктуре автоматического масштабирования. Если вам нужно совершать большие объемы звонков, пожалуйста, свяжитесь с нами для получения индивидуальных ценовых вариантов.
Мы предлагаем простую оплату по мере использования как для наших обычных, так и для расширенных конечных точек API. Ознакомьтесь с нашими тарифными планами, чтобы получить представление о том, сколько будет стоить наша услуга для вашего объема использования. Если вы планируете делать большие объемы запросов (например, более 250 000 звонков в месяц), мы можем предложить индивидуальные цены.
Вы предлагаете бесплатную пробную версию? Да. Зарегистрируйтесь и добавьте карту в свой аккаунт. Затем наша система применит тестовые кредиты, чтобы вы могли опробовать наш поисковый API Яндекса, прежде чем брать на себя какие-либо обязательства.
Если наш Yandex SERP API не подходит для вашего случая использования, сообщите нам об этом, и мы вернем вам деньги за любой неиспользованный остаток.
Как работает выставление счетов?Баланс расходуется только в том случае, если вызов API возвращает результаты. Вызовы API для получения сведений об учетной записи и вызовы API с пустыми результатами не расходуют баланс.
Какие другие поисковые системы вы поддерживаете?API поиска Яндекса | Oxylabs
API поиска Яндекса | OxylabsProxy locations
United States of America
United Kingdom
Japan
Canada
Germany
See all locations
Network statusCareers
products
Scraper APIs
serp
yandex
With Yandex Scraper API, собирать результаты поиска Яндекса не составляет труда. Вы можете без проблем собирать надежные и локализованные поисковые данные.
Доступ к данным результатов поиска в режиме реального времени
Получить точность на уровне координат
Платить только за успешно доставленные результаты
секунд
Укажите URL
Источник ‘yandex’ позволяет получать контент с различных страниц Яндекса. Просто предоставьте нам полный URL страницы Яндекса, и мы вернем результаты без изменения исходных параметров вашего запроса.
Найдите примеры кода ввода в документации ниже и пример вывода справа.
См. документацию
{ "Результаты": [ { "content":"\n\n ... \n\n", "created_at": "2023-01-16 09:36:39", "updated_at": "2023-01-16 09:36:42", "Страница 1, "url": "https://yandex.com/search/?text=nike&", "job_id": "7020685239269769217", "код_статуса": 200 } ] }
С тех пор, как мы начали сотрудничество с Oxylabs, большинство наших проблем было решено. Помимо качества своих услуг, Oxylabs очень заботится об обслуживании клиентов. Это основные моменты, которые заставляют нас рекомендовать Oxylabs нашим партнерам.
Бруно К.
ИТ-менеджер
Исключительная поддержка клиентов
Мы вкладываем все наши ресурсы в поддержку пользователей на всем пути к успеху. Наша опытная команда поддержки клиентов готова помочь вам на каждом этапе пути, гарантируя, что у вас есть руководство и ресурсы, которые вам нужны.
Прочитать отзывы
Круглосуточная поддержка и удобные функции
Подробные учебные пособия
Мы предоставляем подробную документацию для обеспечения плавного запуска.
Управление прокси-серверами
Получите доступ к нашему 102M+ пулу прокси-серверов и сосредоточьтесь на своих операциях, предоставив нам управление прокси-серверами.
Массовая очистка
Одновременная очистка нескольких страниц с использованием до 1000 URL-адресов в пакете.
Несколько вариантов доставки
Получайте результаты через API или в корзину облачного хранилища (AWS S3 или GCS).
Автоматизированные задания
Экономьте время, планируя повторяющуюся очистку с помощью Планировщика.
Круглосуточная служба поддержки
Будьте уверены, что наша дружная команда поддержки будет рядом с вами, когда бы вы ни нуждались в них.
Цены на Yandex Scraper API
Собирайте данные с Яндекса без особых усилий
Платите только за успешные результаты
Собирайте высоколокализованные данные
Получайте ноу-хау парсинга
Результаты
8 90 0030
3
526 000
10 миллионов+
Предел ставки
5 Запрос / S
15 запросов / S
50 запросов / S
100 Запросы / S
Unlimited
Доступ к панели управления
Выделенный менеджер по работе с клиентами
Скидка 10%
Скидка на годовые планы
Для всех наших планов при ежегодной оплате. Свяжитесь со службой поддержки, чтобы узнать больше.
Мы принимаем следующие способы оплаты:
Доступные парсеры
Часто задаваемые вопросы
Как быстро Yandex Search API выдает результаты?
Поскольку API предоставляет данные в режиме реального времени, получение результатов обычно занимает менее 10 секунд. Однако, если вы хотите узнать больше о спецификациях API поиска Яндекса, свяжитесь с нами по адресу [email protected] или в чате.
Каковы распространенные варианты использования API поиска Яндекса?
Наиболее распространенные варианты использования API поиска Яндекса включают SEO-исследования. SERP содержат огромное количество общедоступной информации, такой как расширенные фрагменты, мета-заголовок, мета-описание, позиция на веб-сайте и т. д.
Существует множество способов использования этих данных. Например, вы можете захотеть собрать свежие данные по любому ключевому слову из результатов поиска Яндекса и использовать их для улучшения позиции вашего сайта в поисковой системе.
Для получения более подробной информации о случаях использования API-интерфейсов SERP Scraper вы можете прочитать этот пост в блоге.
Доступны ли разные варианты локализации домена для API поиска Яндекса?
Доступны различные варианты локализации домена. Например, вы можете указать предпочтения своего домена при передаче параметров через специально созданный источник данных — Поиск. Дополнительные сведения см. в нашей документации.
Законно ли парсить Яндекс?
Перед парсингом Яндекса убедитесь, что вы не нарушаете никаких законов, касающихся цели парсинга или самих данных. Мы также написали полезную статью о законности парсинга веб-страниц.
Наконец, мы настоятельно рекомендуем вам проконсультироваться с юрисконсультом, прежде чем приступать к любой деятельности по извлечению данных.
Нужен индивидуальный парсер веб-сайтов?
СВЯЗАТЬСЯ С НАМИ
Общий:
hello@oxylabs.