Наша собственная статистика посещений включена всегда. Google Analytics помогает нам понять, как пользуются нашими публичными страницами (но не вашим рабочим пространством после входа), и включается только с вашего разрешения. См. нашу политику конфиденциальности.

API Yandex Поиск

POST

Состояние API

Состояние за 24 ч
Норма
Среднее время за 24 ч
—
  • Стабильно / норма
  • Доступно
  • Ограничено
  • Почти недоступно
Норма

Находите организации и места на Яндекс Картах по ключевому слову в городе. Получите адрес, телефон, сайт, категории, рейтинг, число отзывов, координаты и признак «открыто сейчас». По умолчанию 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 время и повторите попытку.

Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.

Параметры запроса

ИмяРасположениеТипОбязательныйПо умолчаниюОписание
AuthorizationheaderstringДа-Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
platformbodystringДаyandexИдентификатор платформы, фиксированное значение.
actionbodystringДаsearchИдентификатор возможности, фиксированное значение.
keywordbody.paramsstringДа-Поисковый запрос для действий Яндекса: в search ищет места на карте, в market ищет товары. Поиск по карте и по каталогу товаров идёт по разным наборам данных.
categorybody.paramsstring (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
langbody.paramsstring (enum)Нет-Язык ответа для действия search в Яндексе; принимает ru, en, kk, tr или uk. Определяет локаль интерфейса поиска и не гарантирует перевод пользовательских отзывов.Допустимые значенияenkkrutruk
languagebody.paramsstringНет-Резервный язык интерфейса для действий Яндекса: по умолчанию ru для search и en для reviews. Явно переданный lang в действии search переопределяет этот параметр.
locationbody.paramsstringНет-Целевой город для действия search в Яндексе, по умолчанию Москва. Принимает названия городов; это не числовые ID регионов Яндекс Маркета.
max_pricebody.paramsnumberНет-Верхняя граница цены для соответствующего действия Яндекса при использовании вместе с min_price. Это не фильтр по максимальному пользовательскому рейтингу. Фильтрация использует целые числа: дробные значения округляются вверх (145.98 становится 146).
min_pricebody.paramsnumberНет-Нижняя граница цены для действий Яндекса: в market это цена товара, а в search — ценовая категория места. Значения отражают цены на целевой платформе, а не стоимость использования API. Фильтрация использует целые числа: дробные значения округляются вниз (39.81 становится 39).
sortbody.paramsstring (enum)Нет-Порядок сортировки зависит от действия Яндекса. Для search: relevance или distance; для market: popular или top_rated; для reviews: newest (по умолчанию), relevance, top_rated или lowest_rated. Значения одного действия нельзя использовать в другом.Допустимые значенияdistancerelevance
limitbody.paramsinteger (1–100)Нет20Максимальное число записей в этом вызове, целое число от 1 до 100. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. При значениях выше максимума эндпоинт возвращает ошибку 422 до списания средств.

Примеры кода

bash
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 меняются при каждом вызове, поэтому показана только их структура.

json
{
  "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