API Yandex Поиск
Состояние API
- Состояние за 24 ч
- Норма
- Среднее время за 24 ч
- —
- Стабильно / норма
- Доступно
- Ограничено
- Почти недоступно
Последние 24 часа
Последние 30 дней
Находите организации и места на Яндекс Картах по ключевому слову в городе. Получите адрес, телефон, сайт, категории, рейтинг, число отзывов, координаты и признак «открыто сейчас». По умолчанию location — Москва, а category сужает тип места. Рейтинги не подтверждают доступность или качество.
Возможность Yandex Search ищет организации и места на Яндекс Картах по keyword, например «музеи в Санкт-Петербурге» или «кофейни в Москве», и возвращает по одной записи на каждое место: название, описание, адрес, город, телефон, сайт, категории организации, рейтинг с числом отзывов, координаты и признак того, открыто ли место прямо сейчас. Отделы продаж, франчайзи и аналитики рынка используют её, чтобы составить карту местного бизнеса в городе, собрать списки лидов из магазинов и клиник или сравнить рейтинги филиалов сети с соседними организациями.
Это поиск по карте, а не веб-поиск, поэтому в keyword указывайте тип организации или конкретное место. Город задаётся в location (по умолчанию Москва), а тип организации — в category. city и address передаются ровно так, как их пишет Яндекс, поэтому приведите написание к единому виду, прежде чем группировать записи по городу. Значение null в review_count означает, что Яндекс не показывает число отзывов, а не что отзывов нет, а is_open_now относится к моменту вызова.
Цена: $1.39 за 1 000 запросов ($0.001389 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.
Промпт для ИИ
Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra Yandex Поиск (yandex/search).
Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: yandex и action: search, а параметры передайте в params.
- Обязательные параметры:
- keyword: Поисковый запрос для действий Яндекса: в search ищет места на карте, в market ищет товары. Поиск по карте и по каталогу товаров идёт по разным наборам данных.
- Необязательные параметры:
- category: Фильтрует категории мест для действия search в Яндексе (например, restaurants, cafes, coffee_shops, hotels или none для сброса). (допустимые значения: atms / auto_repair / banks / bars_pubs / beauty_salons / burgers / cafes / car_wash)
- lang: Язык ответа для действия search в Яндексе; принимает ru, en, kk, tr или uk. Определяет локаль интерфейса поиска и не гарантирует перевод пользовательских отзывов. (допустимые значения: en / kk / ru / tr / uk)
- language: Резервный язык интерфейса для действий Яндекса: по умолчанию ru для search и en для reviews. Явно переданный lang в действии search переопределяет этот параметр.
- location: Целевой город для действия search в Яндексе, по умолчанию Москва. Принимает названия городов; это не числовые ID регионов Яндекс Маркета.
- max_price: Верхняя граница цены для соответствующего действия Яндекса при использовании вместе с min_price. Это не фильтр по максимальному пользовательскому рейтингу.
- min_price: Нижняя граница цены для действий Яндекса: в market это цена товара, а в search — ценовая категория места. Значения отражают цены на целевой платформе, а не стоимость использования API.
- sort: Порядок сортировки зависит от действия Яндекса. Для search: relevance или distance; для market: popular или top_rated; для reviews: newest (по умолчанию), relevance, top_rated или lowest_rated. (допустимые значения: distance / relevance)
- limit: Максимальное число записей в этом вызове, целое число от 1 до 100. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. (по умолчанию: 20)
- Возвращает список записей. Основные поля каждой записи: id, url, name, text, address, city, country, categories, rating, rating_scale, review_count, phone; всего полей: 16, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=yandex.
- Пример тела запроса:
{
"platform": "yandex",
"action": "search",
"params": {
"keyword": "музей Санкт-Петербург"
}
}
- Цена: $1.39 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Для десятков или сотен целей добавьте в тело запроса "mode": "async": вы сразу получите job_id и сможете опрашивать GET https://api.everyinfra.com/api/v1/jobs/{job_id}, чтобы получить результат.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.
Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.Параметры запроса
| Имя | Расположение | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|---|
Authorization | header | string | Да | - | Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода. |
platform | body | string | Да | yandex | Идентификатор платформы, фиксированное значение. |
action | body | string | Да | search | Идентификатор возможности, фиксированное значение. |
keyword | body.params | string | Да | - | Поисковый запрос для действий Яндекса: в search ищет места на карте, в market ищет товары. Поиск по карте и по каталогу товаров идёт по разным наборам данных. |
category | body.params | string (enum) | Нет | - | Фильтрует категории мест для действия 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 |
lang | body.params | string (enum) | Нет | - | Язык ответа для действия search в Яндексе; принимает ru, en, kk, tr или uk. Определяет локаль интерфейса поиска и не гарантирует перевод пользовательских отзывов.Допустимые значенияenkkrutruk |
language | body.params | string | Нет | - | Резервный язык интерфейса для действий Яндекса: по умолчанию ru для search и en для reviews. Явно переданный lang в действии search переопределяет этот параметр. |
location | body.params | string | Нет | - | Целевой город для действия search в Яндексе, по умолчанию Москва. Принимает названия городов; это не числовые ID регионов Яндекс Маркета. |
max_price | body.params | number | Нет | - | Верхняя граница цены для соответствующего действия Яндекса при использовании вместе с min_price. Это не фильтр по максимальному пользовательскому рейтингу. Фильтрация использует целые числа: дробные значения округляются вверх (145.98 становится 146). |
min_price | body.params | number | Нет | - | Нижняя граница цены для действий Яндекса: в market это цена товара, а в search — ценовая категория места. Значения отражают цены на целевой платформе, а не стоимость использования API. Фильтрация использует целые числа: дробные значения округляются вниз (39.81 становится 39). |
sort | body.params | string (enum) | Нет | - | Порядок сортировки зависит от действия Яндекса. Для search: relevance или distance; для market: popular или top_rated; для reviews: newest (по умолчанию), relevance, top_rated или lowest_rated. Значения одного действия нельзя использовать в другом.Допустимые значенияdistancerelevance |
limit | body.params | integer (1–100) | Нет | 20 | Максимальное число записей в этом вызове, целое число от 1 до 100. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. При значениях выше максимума эндпоинт возвращает ошибку 422 до списания средств. |
Примеры кода
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "yandex",
"action": "search",
"params": {
"keyword": "музей Санкт-Петербург"
}
}'Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.
Пример ответа
Получено October 24, 2026 at 18:28 (UTC) вызовом этого API с параметрами из примера кода выше. results и count — реальный ответ этого вызова, из которого удалены персональные данные (имена, никнеймы, аватары, ссылки на профили, контакты); в списке оставлены первые 2. id, billing и quota меняются при каждом вызове, поэтому показана только их структура.
{
"id": "req_…",
"platform": "yandex",
"action": "search",
"results": [
{
"id": "•••",
"url": "https://yandex.com/maps/org/yusupovskiy_dvorets_na_moyke/1484458665/",
"name": "Юсуповский дворец на Мойке",
"text": "наб. реки Мойки, 94, Санкт-Петербург",
"address": "Санкт-Петербург, набережная реки Мойки, 94",
"city": "Санкт-Петербург",
"country": "Россия",
"categories": [
"Музей",
"достопримечательность",
"культурный центр"
],
"rating": 5,
"review_count": 20295,
"phone": [
"•••"
],
"website": "https://yusupov-palace.ru/ru?yclid=1047539603321651199",
"lat": 59.929384,
"lng": 30.29887,
"is_open_now": false,
"platform": "yandex",
"rating_scale": 5
},
{
"id": "•••",
"url": "https://yandex.com/maps/org/muzey_yantarya_solnechnogo_kamnya/198760504469/",
"name": "Музей Янтаря - Солнечного камня",
"text": "Невский просп., 51, Санкт-Петербург",
"address": "Санкт-Петербург, Невский проспект, 51",
"city": "Санкт-Петербург",
"country": "Россия",
"categories": [
"Музей",
"магазин парфюмерии и косметики",
"магазин бижутерии"
],
"rating": 4.599999904632568,
"review_count": 97,
"phone": [
"•••"
],
"website": "http://www.jantarspb.ru/?yclid=14418971870541905919",
"lat": 59.931873,
"lng": 30.34891,
"is_open_now": false,
"platform": "yandex",
"rating_scale": 5
}
],
"count": 10,
"billing": {
"charged": …,
"charged_usd": …,
"balance_after_usd": …,
…
},
"quota": { … }
}Поля ответа
Бизнес-данные находятся в results. В таблице перечислены поля, которые может содержать запись; значения, которые платформа не показывает, никогда не выдумываются.
| Поле | Значение |
|---|---|
id | Уникальный ID записи на платформе. Уникален только в пределах одной платформы; на разных платформах ID могут повторяться. |
url | Ссылка на запись на платформе. |
name | Название самого объекта для возможностей по аккаунтам, товарам и компаниям. |
text | Основной текст без HTML возвращается полностью и никогда не обрезается (на нескольких платформах результаты списковых запросов содержат только фрагмент; это указано в примечаниях к полям платформы). |
address | Полный адрес передаётся как есть. |
city | Название города на языке платформы в исходном виде. |
country | Страна или регион: полное название либо код ISO в зависимости от платформы. Значение передаётся без нормализации. |
categories | Трактуется так же, как на самой платформе |
rating | Рейтинг. Шкала зависит от платформы: rating_scale в той же записи задаёт максимум (обычно 5; у Booking, Douban, iQIYI и NAVER — 10). Перед сравнением между платформами пересчитайте значения с учётом rating_scale, иначе результат сравнения может оказаться обратным. |
rating_scale | Максимальное значение rating в той же записи: 5 для пятизвёздочных шкал, 10 для десятибалльных. Поле присутствует, только если у записи есть рейтинг. |
review_count | Количество отзывов для возможностей по товарам и компаниям. null означает, что значение не раскрыто, а не 0. |
phone | Контактный номер телефона передаётся без нормализации формата. |
website | Внешний сайт, указанный аккаунтом или компанией. |
lat | Трактуется так же, как на самой платформе |
lng | Трактуется так же, как на самой платформе |
is_open_now | Трактуется так же, как на самой платформе |
platform | Идентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok). |
FAQ
Это API веб-поиска Яндекса?
Нет. Yandex Search ищет места на Яндекс Картах, как если бы вы искали на карте музеи или банки в городе, и возвращает записи о местах с адресами, телефонами, рейтингами и координатами, а не веб-страницы. Карточки товаров с Яндекс Маркета — отдельный набор данных, для него есть возможность Yandex Market.
Какие параметры задают город и язык?
location задаёт город поиска, по умолчанию Москва; указывайте название города, а не числовой код региона. lang задаёт язык интерфейса (ru, en, kk, tr или uk) и имеет приоритет над language, если переданы оба; language здесь по умолчанию равен ru. Ни один из них не гарантирует, что текст в результатах вернётся переведённым.
Как category и фильтры по цене сужают поиск?
category ограничивает результаты одним типом организаций, например restaurants, cafes, pharmacies, museums или banks, а none отключает фильтр по категории; выбирайте категорию, которая соответствует ключевому слову и городу. min_price и max_price задают ценовой фильтр карты для организаций: это не то же самое, что цена товара на Яндекс Маркете, и не стоимость вызова. sort сортирует по relevance или distance.
Ошибки и оплата
- 401
- Ключ отсутствует или недействителен.
- 402
- Недостаточно средств на балансе. Сначала пополните баланс.
- 422
- Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
- 429
- Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
- 503
- Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
- 200 (пусто)
- Нет данных. Без списания.
Официальные источники
Используются только для проверки объектов и терминов. Они не означают, что платформа разрешила или одобрила работу EveryInfra.
- Яндекс Карты: карточки организаций, категории и рейтинги ↗
Официальная документация по карточкам организаций описывает категорию, адрес, рейтинг, число отзывов и сведения о режиме работы. Это поясняет объекты на карте; наличие кнопок в карточке не означает, что этот API позволяет бронировать или редактировать карту.
Проверено 2026-09-05