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

API Bing Maps Поиск

POST

Состояние API

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

Находите компании на Bing Maps по keyword вокруг центра карты. Получайте ID компании в Bing, адрес, координаты, телефон, сайт, категорию, информацию о том, открыта ли она сейчас, а также рейтинг и число отзывов с таких сайтов, как Yelp или TripAdvisor. До 30 компаний на страницу.

Цена: $0.56 за 1 000 запросов ($0.000556 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.

Промпт для ИИ

Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra Bing Maps Поиск (bing_maps/search).

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: bing_maps и action: search, а параметры передайте в params.
- Обязательные параметры:
  - keyword: Что искать на карте: название компании или категорию, например coffee или pizza.
- Необязательные параметры:
  - language: Двухбуквенный код языка возвращаемых карточек организаций, например en или de.
  - latitude: Широта центра карты, от -90 до 90; задаётся вместе с longitude. Без центра Bing выбирает местоположение сам, и это может оказаться не тот город, который вам нужен.
  - longitude: Долгота центра карты, от -180 до 180; задаётся вместе с latitude.
  - page: Номер страницы с карточками организаций, начиная с 1; на странице limit организаций (не более 20 страниц).
  - limit: Максимальное число записей в этом вызове, целое число от 1 до 30. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. (по умолчанию: 20)
- Возвращает список записей. Основные поля каждой записи: rank, place_id (ID организации в Bing Maps, например YN…), name, url, category, address, lat, lng, phone, website, rating (Рейтинг с сайта отзывов, указанного в r…), rating_scale; всего полей: 17, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=bing_maps.
- Пример тела запроса:
{
  "platform": "bing_maps",
  "action": "search",
  "params": {
    "keyword": "coffee"
  }
}
- Цена: $0.56 за 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Даbing_mapsИдентификатор платформы, фиксированное значение.
actionbodystringДаsearchИдентификатор возможности, фиксированное значение.
keywordbody.paramsstringДа-Что искать на карте: название компании или категорию, например coffee или pizza.
languagebody.paramsstringНет-Двухбуквенный код языка возвращаемых карточек организаций, например en или de.
latitudebody.paramsnumberНет-Широта центра карты, от -90 до 90; задаётся вместе с longitude. Без центра Bing выбирает местоположение сам, и это может оказаться не тот город, который вам нужен.
longitudebody.paramsnumberНет-Долгота центра карты, от -180 до 180; задаётся вместе с latitude.
pagebody.paramsintegerНет-Номер страницы с карточками организаций, начиная с 1; на странице limit организаций (не более 20 страниц).
limitbody.paramsinteger (1–30)Нет20Максимальное число записей в этом вызове, целое число от 1 до 30. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. При значениях выше максимума эндпоинт возвращает ошибку 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": "bing_maps",
  "action": "search",
  "params": {
    "keyword": "coffee"
  }
}'

Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.

Пример ответа

Предпросмотр полей

Для этих параметров пока нет примера ответа. Здесь показаны структура ответа и поля из описания API, а … служит заполнителем; это не результат реального вызова.

json
{
  "id": "req_…",
  "platform": "bing_maps",
  "action": "search",
  "results": [
    {
      "rank": …,
      "place_id": …,
      "name": …,
      "url": …,
      "category": …,
      "address": …,
      "lat": …,
      "lng": …,
      "phone": …,
      "website": …,
      "rating": …,
      "rating_scale": …,
      "review_count": …,
      "rating_source": …,
      "open_state": …,
      "hours_text": …,
      "image_url": …,
      "platform": …
    }
  ],
  "count": …,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

Поля ответа

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

ПолеЗначение
rankТрактуется так же, как на самой платформе
place_idID организации в Bing Maps, например YNF9439D454244F274.
nameНазвание самого объекта для возможностей по аккаунтам, товарам и компаниям.
urlСсылка на запись на платформе.
categoryНазвание категории во внутренней классификации платформы. Категории разных платформ не унифицированы.
addressПолный адрес передаётся как есть.
latТрактуется так же, как на самой платформе
lngТрактуется так же, как на самой платформе
phoneКонтактный номер телефона передаётся без нормализации формата.
websiteВнешний сайт, указанный аккаунтом или компанией.
ratingРейтинг с сайта отзывов, указанного в rating_source, по шкале этого сайта; сам Bing организации не оценивает.
rating_scaleМаксимальное значение rating в той же записи: 5 для пятизвёздочных шкал, 10 для десятибалльных. Поле присутствует, только если у записи есть рейтинг.
review_countЧисло отзывов на сайте, указанном в rating_source.
rating_sourceСайт отзывов, откуда взят рейтинг, например Yelp или TripAdvisor.
open_stateТрактуется так же, как на самой платформе
hours_textПодсказка о часах работы в исходном виде, например Open until 8 PM; отсутствует, если Bing её не показывает.
image_urlСсылка на изображение. Возможности с несколькими изображениями могут возвращать массив image_urls.
platformИдентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok).

Ошибки и оплата

401
Ключ отсутствует или недействителен.
402
Недостаточно средств на балансе. Сначала пополните баланс.
422
Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
429
Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
503
Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
200 (пусто)
Нет данных. Без списания.

Ошибки

Официальные источники

Используются только для проверки объектов и терминов. Они не означают, что платформа разрешила или одобрила работу EveryInfra.

  • Microsoft Learn: Bing Maps Local Search находит компании рядом с заданным местом ↗

    Согласно документации Microsoft, Bing Maps Local Search принимает запрос вместе с местоположением пользователя, ограничивающей рамкой или кругом и возвращает компании вокруг этого места; этот официальный интерфейс больше недоступен для бесплатных аккаунтов и охватывает только компании в США. Источник подтверждает только, что Bing Maps ищет компании по местоположению на карте; `latitude` и `longitude` в этом API задают центр карты, определённый EveryInfra, не относятся к тому официальному интерфейсу, и его региональное ограничение на них не распространяется.

    Проверено 2026-11-01