Доступность платформы
- Состояние за 24 ч
- 99%
За последние 30 дней
Доступные возможности
Все действия Yandex: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Находите организации и места на Яндекс Картах по ключевому слову в городе. | $1.39 за 1 000 запросов | Норма |
Рынокmarket | Сравнивайте товары на Яндекс Маркете по поисковому запросу. | $1.39 за 1 000 запросов | Работает стабильно · состояние 99% |
Отзывыreviews | Собирайте отзывы об организации на Яндекс Картах. | $1.39 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Yandex?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Находите организации и места на Яндекс Картах по ключевому слову в городе. Получите адрес, телефон, сайт, категории, рейтинг, число отзывов, координаты и признак «открыто сейчас». По умолчанию | keyword | category, lang, language, location, max_price, min_price, sort | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · name · text · address · city · country · categories · rating · rating_scale · review_count · phone · website · lat · lng · is_open_now · platform |
marketРынок Сравнивайте товары на Яндекс Маркете по поисковому запросу. Получите цену, рейтинг, число отзывов и покупок, название и рейтинг магазина, а также наличие. Задайте город с помощью | keyword | city, max_price, min_price, region, sort | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · title · price · currency · rating · rating_scale · rating_count · review_count · purchase_count · category · shop_name · shop_rating · stock · is_available · image_url · platform |
reviewsОтзывы Собирайте отзывы об организации на Яндекс Картах. За один вызов возвращается до 200 отзывов. Для каждого отзыва возвращаются текст, оценка, дата, лайки и дизлайки, а также ответ владельца. Передайте ссылку на место на карте или ID организации, а не ссылку на товар Маркета. С помощью | url | language, sort | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · text · rating · rating_scale · posted_at · language · like_count · dislike_count · comment_count · author_name · owner_reply · business_id · business_name · business_rating · business_review_count · platform |
Что означают параметры действия search в API Yandex?
Находите организации и места на Яндекс Картах по ключевому слову в городе. Получите адрес, телефон, сайт, категории, рейтинг, число отзывов, координаты и признак «открыто сейчас». По умолчанию location — Москва, а category сужает тип места. Рейтинги не подтверждают доступность или качество.
keywordОбязательный- Поисковый запрос для действий Яндекса: в search ищет места на карте, в market ищет товары. Поиск по карте и по каталогу товаров идёт по разным наборам данных.
categoryНеобязательный- Фильтрует категории мест для действия search в Яндексе (например, restaurants, cafes, coffee_shops, hotels или none для сброса). Параметр не относится к категориям товаров Яндекс Маркета и должен соответствовать указанному значению keyword и выбранному городу.Допустимые значения:
atmsauto_repairbanksbars_pubsbeauty_salonsburgerscafescar_washcinemascoffee_shopsdentistsdry_cleaningfast_foodfitness_clubsgas_stationsgovernment_servicesgrocery_storeshookah_barshospitalshotelskindergartensmuseumsnonepharmaciespizzarestaurantsschoolsshopping_mallssports_facilitiessushi_rollsveterinary_clinicsЯндекс Карты: карточки организаций, категории и рейтинги — Официальная документация по карточкам организаций описывает категорию, адрес, рейтинг, число отзывов и сведения о режиме работы. Это поясняет объекты на карте; наличие кнопок в карточке не означает, что этот API позволяет бронировать или редактировать карту. · Проверено langНеобязательный- Язык ответа для действия search в Яндексе; принимает ru, en, kk, tr или uk. Определяет локаль интерфейса поиска и не гарантирует перевод пользовательских отзывов.Допустимые значения:
enkkrutruk languageНеобязательный- Резервный язык интерфейса для действий Яндекса: по умолчанию ru для search и en для reviews. Явно переданный lang в действии search переопределяет этот параметр.
locationНеобязательный- Целевой город для действия search в Яндексе, по умолчанию Москва. Принимает названия городов; это не числовые ID регионов Яндекс Маркета.
max_priceНеобязательный- Верхняя граница цены для соответствующего действия Яндекса при использовании вместе с min_price. Это не фильтр по максимальному пользовательскому рейтингу. Фильтрация использует целые числа: дробные значения округляются вверх (145.98 становится 146).
min_priceНеобязательный- Нижняя граница цены для действий Яндекса: в market это цена товара, а в search — ценовая категория места. Значения отражают цены на целевой платформе, а не стоимость использования API. Фильтрация использует целые числа: дробные значения округляются вниз (39.81 становится 39).
sortНеобязательный- Порядок сортировки зависит от действия Яндекса. Для search: relevance или distance; для market: popular или top_rated; для reviews: newest (по умолчанию), relevance, top_rated или lowest_rated. Значения одного действия нельзя использовать в другом.Допустимые значения:
distancerelevance
Что означают параметры действия market в API Yandex?
Сравнивайте товары на Яндекс Маркете по поисковому запросу. Получите цену, рейтинг, число отзывов и покупок, название и рейтинг магазина, а также наличие. Задайте город с помощью city или числового кода region. По умолчанию используется Москва. Заказы не оформляются, а наличие не гарантируется.
keywordОбязательный- Поисковый запрос для действий Яндекса: в search ищет места на карте, в market ищет товары. Поиск по карте и по каталогу товаров идёт по разным наборам данных.
cityНеобязательный- Слаг целевого города (например, moscow, saint_petersburg) для действия market в Яндексе. Значение должно входить в список допустимых значений и не может использоваться вместо location при поиске по карте.Допустимые значения:
chelyabinskkazankrasnodarkrasnoyarskmoscownizhny_novgorodnovosibirskomskpermrostov_on_donsaint_petersburgsamaraufavolgogradvoronezhyekaterinburgЯндекс Маркет: условия доставки зависят от города и товара — Официальные условия доставки Яндекс Маркета привязывают способы, сроки и стоимость доставки к городу и конкретному товару, а точные условия указаны на странице товара и при оформлении заказа. Поэтому цены в результатах поиска товаров не являются гарантированной итоговой суммой с доставкой и не означают обязательства по доставке. · Проверено max_priceНеобязательный- Верхняя граница цены для соответствующего действия Яндекса при использовании вместе с min_price. Это не фильтр по максимальному пользовательскому рейтингу. Фильтрация использует целые числа: дробные значения округляются вверх (145.98 становится 146).
min_priceНеобязательный- Нижняя граница цены для действий Яндекса: в market это цена товара, а в search — ценовая категория места. Значения отражают цены на целевой платформе, а не стоимость использования API. Фильтрация использует целые числа: дробные значения округляются вниз (39.81 становится 39).
regionНеобязательный- Числовой региональный код города для действия market в Яндексе; по умолчанию — 213 (Москва). Это внутренний идентификатор региона, а не код страны RU. Явно указанный параметр city переопределяет это значение.
sortНеобязательный- Порядок сортировки зависит от действия Яндекса. Для search: relevance или distance; для market: popular или top_rated; для reviews: newest (по умолчанию), relevance, top_rated или lowest_rated. Значения одного действия нельзя использовать в другом.Допустимые значения:
populartop_rated
Что означают параметры действия reviews в API Yandex?
Собирайте отзывы об организации на Яндекс Картах. За один вызов возвращается до 200 отзывов. Для каждого отзыва возвращаются текст, оценка, дата, лайки и дизлайки, а также ответ владельца. Передайте ссылку на место на карте или ID организации, а не ссылку на товар Маркета. С помощью sort можно вывести первыми жалобы с низкой оценкой (lowest_rated).
urlОбязательный- Полный URL места на Яндекс Картах или строка businessId для действия reviews. Ссылки на товары Яндекс Маркета не принимаются.
languageНеобязательный- Резервный язык интерфейса для действий Яндекса: по умолчанию ru для search и en для reviews. Явно переданный lang в действии search переопределяет этот параметр.Яндекс Карты: исходные отзывы и перевод в интерфейсе — Официальная документация Яндекса указывает, что отзывы на языке, отличном от языка интерфейса, могут показываться в переводе с возможностью переключиться на исходный текст. Поэтому параметр языка в этом API нельзя считать прямым фильтром по языку, на котором написан отзыв, или гарантией перевода. · Проверено
sortНеобязательный- Порядок сортировки зависит от действия Яндекса. Для search: relevance или distance; для market: popular или top_rated; для reviews: newest (по умолчанию), relevance, top_rated или lowest_rated. Значения одного действия нельзя использовать в другом.Допустимые значения:
lowest_ratednewestrelevancetop_rated
Как использовать API Yandex
- 01Выберите действие платформы в публичном каталоге.
- 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
- 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
- 04Сохраните поля ответа, которые нужны вашему приложению.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"yandex","action":"search","params":{"keyword":"<keyword>"}}'
Вопросы об API Yandex
Какие данные можно получить через API Yandex?
Укажите в platform значение yandex. В текущем каталоге: поиск, рынок и отзывы. Эти названия действий соответствуют разным объектам или представлениям Yandex; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе Yandex?
Поисковый запрос для действий Яндекса: в search ищет места на карте, в market ищет товары. Поиск по карте и по каталогу товаров идёт по разным наборам данных. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе Yandex?
Объявленная схема включает name, text, address и city. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Yandex возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.