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

API DuckDuckGo Maps Поиск

POST

Состояние API

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

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

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

Промпт для ИИ

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

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: duckduckgo_maps и action: search, а параметры передайте в params.
- Обязательные параметры:
  - keyword: Что искать на карте: название места или категорию, например coffee или museum.
  - latitude: Широта центра карты, от -90 до 90. Обязательный параметр; в результаты попадают места примерно в пределах одного экрана вокруг этой точки.
  - longitude: Долгота центра карты, от -180 до 180. Обязательный параметр.
- Необязательные параметры:
  - limit: Максимальное число записей в этом вызове, целое число от 1 до 50. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. (по умолчанию: 20)
- Возвращает список записей. Основные поля каждой записи: rank, name, apple_maps_id (Числовой ID места в Apple Maps), yelp_id (Алиас организации на Yelp), category, address, city, country_code, timezone, lat, lng, phone; всего полей: 23, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=duckduckgo_maps.
- Пример тела запроса:
{
  "platform": "duckduckgo_maps",
  "action": "search",
  "params": {
    "keyword": "coffee",
    "latitude": 40.7128,
    "longitude": -74.006
  }
}
- Цена: $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Даduckduckgo_mapsИдентификатор платформы, фиксированное значение.
actionbodystringДаsearchИдентификатор возможности, фиксированное значение.
keywordbody.paramsstringДа-Что искать на карте: название места или категорию, например coffee или museum.
latitudebody.paramsnumberДа-Широта центра карты, от -90 до 90. Обязательный параметр; в результаты попадают места примерно в пределах одного экрана вокруг этой точки.
longitudebody.paramsnumberДа-Долгота центра карты, от -180 до 180. Обязательный параметр.
limitbody.paramsinteger (1–50)Нет20Максимальное число записей в этом вызове, целое число от 1 до 50. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. При значениях выше максимума эндпоинт возвращает ошибку 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": "duckduckgo_maps",
  "action": "search",
  "params": {
    "keyword": "coffee",
    "latitude": 40.7128,
    "longitude": -74.006
  }
}'

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

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

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

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

json
{
  "id": "req_…",
  "platform": "duckduckgo_maps",
  "action": "search",
  "results": [
    {
      "rank": …,
      "name": …,
      "apple_maps_id": …,
      "yelp_id": …,
      "category": …,
      "address": …,
      "city": …,
      "country_code": …,
      "timezone": …,
      "lat": …,
      "lng": …,
      "phone": …,
      "website": …,
      "url": …,
      "menu_url": …,
      "rating": …,
      "rating_scale": …,
      "review_count": …,
      "price": …,
      "open_state": …,
      "opening_hours": …,
      "image_url": …,
      "top_reviews": …,
      "platform": …
    }
  ],
  "count": …,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

Поля ответа

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

ПолеЗначение
rankТрактуется так же, как на самой платформе
nameНазвание самого объекта для возможностей по аккаунтам, товарам и компаниям.
apple_maps_idЧисловой ID места в Apple Maps; передайте его в place_ids действия places Apple Maps, чтобы получить полные данные.
yelp_idАлиас организации на Yelp; есть у мест, размещённых на Yelp, в основном в США.
categoryНазвание категории во внутренней классификации платформы. Категории разных платформ не унифицированы.
addressПолный адрес передаётся как есть.
cityНазвание города на языке платформы в исходном виде.
country_codeТрактуется так же, как на самой платформе
timezoneТрактуется так же, как на самой платформе
latТрактуется так же, как на самой платформе
lngТрактуется так же, как на самой платформе
phoneКонтактный номер телефона передаётся без нормализации формата.
websiteВнешний сайт, указанный аккаунтом или компанией.
urlСсылка на запись на платформе.
menu_urlТрактуется так же, как на самой платформе
ratingРейтинг Yelp от 1 до 5.
rating_scaleМаксимальное значение rating в той же записи: 5 для пятизвёздочных шкал, 10 для десятибалльных. Поле присутствует, только если у записи есть рейтинг.
review_countКоличество отзывов для возможностей по товарам и компаниям. null означает, что значение не раскрыто, а не 0.
priceУровень цен в виде знаков $ (от $ до $$$$); отсутствует, если не указан.
open_stateТрактуется так же, как на самой платформе
opening_hoursЧасы работы на неделю: ключами служат дни недели (от monday до sunday), а значения задаются текстом в формате start - end; дни без указанных часов не включаются.
image_urlСсылка на изображение. Возможности с несколькими изображениями могут возвращать массив image_urls.
top_reviewsНесколько фрагментов отзывов с rating, text и date (YYYY-MM-DD), без данных об авторах.
platformИдентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok).

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

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

Ошибки

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

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

  • Справка DuckDuckGo: карты основаны на данных Apple ↗

    На странице справки DuckDuckGo сказано, что для поиска сервис использует несколько источников информации, а карты получает от Apple. Источник подтверждает только, что DuckDuckGo Maps использует картографические данные Apple, поэтому в записях есть Apple Maps ID; `keyword` в этом API ищет названия или категории мест вокруг заданного центра карты, а о количестве результатов, источниках рейтингов или полях с часами работы источник ничего не говорит.

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