Содержание

Документация по работе с 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 (по умолчанию). Другие домены Яндекса: 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:)

Параметры и методы — API Яндекс :: XMLRiver

    Использование параметров GET

    Кроме установки необходимых настроек запросов в аккаунте, вы можете передавать эти параметры через GET запрос.
    ВАЖНО! Переданные параметры в GET запросе имеют приоритет перед параметрами, установленными в настройках аккаунта!

    Строка запроса

    Наименование

    Обязательно Описание
    query да Параметр определяет строку запроса поиска. Вы можете использовать любые запросы, как если бы Вы делали поиск в Google, кроме символа амперсанда (&), который необходимо заменять на код %26

    groupby

    нет

    Числовое значение, ТОП позиций для сбора. Возможные значения: 10.

    page нет Числовое значение, определяет страницу поисковой выдачи. В Яндексе страницы нумеруются начиная с нуля.
    highlights нет Подсветка ключевых слов.
    При передаче параметра highlights=1 тайтл и сниппет заключаются в контейнер <![CDATA[…]]> и содержат тег <hlword> в который заключены выделенные жирным слова из выдачи, если таковые присутствуют.

     

    Географическое расположение

    Наименование

    Обязательно Описание
    lr нет

    числовое значение (id) местоположения (регион Яндекса)

     

    Локализация

    Наименование

    Обязательно Описание
    lang нет

    Код языка Яндекса: ruuk

    domain нет

    Строка yandex домена. Возможные значения: rucomuacom.trbykz

     

    Параметры XMLRiver

    Наименование

    Обязательно Описание
    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&lr=1&domain=ru&device=desktop

    API поиска Яндекса — доступ к результатам поисковой выдачи Яндекса в режиме реального времени

    Доступ к результатам поиска Яндекса с помощью нашего сверхнадежного, быстрого и доступного API поисковой выдачи Яндекса.

    К сожалению, эта конечная точка больше не поддерживается. Наш API возвращает самые свежие свежие данные со 100% точностью.

    Формат JSON или Raw HTML

    Используйте нашу обычную конечную точку для получения результатов поиска Google в формате JSON или используйте нашу расширенную конечную точку, если вам нужны необработанные данные HTML.

    Результаты для конкретного местоположения

    Доступ к результатам из любой точки мира. Установите требования к местоположению по стране, городу или даже координатам GPS.

    Что говорят клиенты

    Мы использовали множество различных поставщиков API, и SerpsBot является лучшим с точки зрения времени отклика, цены и надежности. Поддержка тоже отличная. Очень приятно работать с командой SerpsBot.

    Jens Brandt

    Founder, Docoloc

    Pricing

    Features

    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 поиска Яндекса | Oxylabs

    Proxy 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.
Автор записи

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *