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

API Apple Maps Сведения о месте

POST

Состояние API

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

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

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

Промпт для ИИ

Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra Apple Maps Сведения о месте (apple_maps/places).

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: apple_maps и action: places, а параметры передайте в params.
- Обязательные параметры:
  - place_ids: Список из 1–50 числовых ID мест Apple Maps, например ["12971322601039101590"], из поля apple_maps_id записей DuckDuckGo Maps или параметра auid в ссылке Apple Maps. Вызов стоит одинаково для одного ID и для пятидесяти.
- Необязательные параметры:
  - language: Язык возвращаемых сведений о месте, например en-US, zh-CN или ja-JP; подойдёт и двухбуквенный код вроде en. По умолчанию en-US.
  - limit: Максимальное число записей в этом вызове, целое число не меньше 1. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей.
- Возвращает список записей. Основные поля каждой записи: place_id (Числовой ID места в Apple Maps, совпада…), name, url, category, categories, address, city, state, postal_code, country_code, lat, lng; всего полей: 26, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=apple_maps.
- Пример тела запроса:
{
  "platform": "apple_maps",
  "action": "places",
  "params": {
    "place_ids": [
      "12971322601039101590"
    ]
  }
}
- Цена: $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Даapple_mapsИдентификатор платформы, фиксированное значение.
actionbodystringДаplacesИдентификатор возможности, фиксированное значение.
place_idsbody.paramsarrayДа-Список из 1–50 числовых ID мест Apple Maps, например ["12971322601039101590"], из поля apple_maps_id записей DuckDuckGo Maps или параметра auid в ссылке Apple Maps. Вызов стоит одинаково для одного ID и для пятидесяти; ID, состоящие не только из цифр, отклоняются до списания средств.
languagebody.paramsstringНет-Язык возвращаемых сведений о месте, например en-US, zh-CN или ja-JP; подойдёт и двухбуквенный код вроде en. По умолчанию en-US.
limitbody.paramsinteger (1–)Нет-Максимальное число записей в этом вызове, целое число не меньше 1. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей.

Примеры кода

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": "apple_maps",
  "action": "places",
  "params": {
    "place_ids": [
      "12971322601039101590"
    ]
  }
}'

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

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

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

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

json
{
  "id": "req_…",
  "platform": "apple_maps",
  "action": "places",
  "results": [
    {
      "place_id": …,
      "name": …,
      "url": …,
      "category": …,
      "categories": …,
      "address": …,
      "city": …,
      "state": …,
      "postal_code": …,
      "country_code": …,
      "lat": …,
      "lng": …,
      "timezone": …,
      "phone": …,
      "website": …,
      "rating": …,
      "rating_scale": …,
      "review_count": …,
      "rating_source": …,
      "price": …,
      "open_state": …,
      "opening_hours": …,
      "amenities": …,
      "image_urls": …,
      "top_reviews": …,
      "is_claimed": …,
      "platform": …
    }
  ],
  "count": …,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

Поля ответа

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

ПолеЗначение
place_idЧисловой ID места в Apple Maps, совпадающий с ID, переданным в place_ids.
nameНазвание самого объекта для возможностей по аккаунтам, товарам и компаниям.
urlСсылка на запись на платформе.
categoryНазвание категории во внутренней классификации платформы. Категории разных платформ не унифицированы.
categoriesТрактуется так же, как на самой платформе
addressПолный адрес передаётся как есть.
cityНазвание города на языке платформы в исходном виде.
stateТрактуется так же, как на самой платформе
postal_codeТрактуется так же, как на самой платформе
country_codeТрактуется так же, как на самой платформе
latТрактуется так же, как на самой платформе
lngТрактуется так же, как на самой платформе
timezoneТрактуется так же, как на самой платформе
phoneКонтактный номер телефона передаётся без нормализации формата.
websiteВнешний сайт, указанный аккаунтом или компанией.
ratingРейтинг по шкале сайта, указанного в rating_source (от 1 до 5 для Yelp).
rating_scaleМаксимальное значение rating в той же записи: 5 для пятизвёздочных шкал, 10 для десятибалльных. Поле присутствует, только если у записи есть рейтинг.
review_countКоличество отзывов для возможностей по товарам и компаниям. null означает, что значение не раскрыто, а не 0.
rating_sourceСайт, с которого взяты рейтинг и число отзывов; Apple Maps часто показывает рейтинги партнёров, например Yelp или Tripadvisor.
priceЦена числом без символа валюты; см. currency.
open_stateТрактуется так же, как на самой платформе
opening_hoursЧасы работы на неделю по дням (от monday до sunday); для каждого дня указан список временных интервалов в исходном виде. Дни без указанных часов опускаются.
amenitiesТрактуется так же, как на самой платформе
image_urlsМассив ссылок на изображения в порядке показа на платформе; поле отсутствует, если изображений нет.
top_reviewsНесколько характерных отзывов с rating, text, posted_at и url, без данных об авторах.
is_claimedЗаявила ли компания права на это место в Apple Business Connect.
platformИдентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok).

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

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

Ошибки

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

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

  • Apple Developer Documentation: как определять уникальные места с помощью Place ID ↗

    В документации Apple для разработчиков сказано, что Place ID на протяжении всего своего существования указывает на одну и ту же точку интереса и позволяет получить информацию об этом месте. Источник подтверждает только, что у мест в Apple Maps есть стабильные уникальные идентификаторы; `place_ids` в этом API — это числовые ID мест (auid) из ссылок Apple Maps, которые записываются иначе, чем буквенно-цифровые Place ID в MapKit, и не взаимозаменяемы с ними. Часы работы, удобства и поля рейтинга в источнике не описаны.

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