API EverySearch Места

POST

Состояние API

Состояние за 24 ч: Норма
Среднее время за 24 ч: —

Стабильно / норма
Доступно
Ограничено
Почти недоступно

Норма

Последние 24 часа

Последние 30 дней

Поиск мест и местных компаний

Цена: $0.69 за 1 000 запросов ($0.000694 за вызов). Неудачные вызовы и пустые результаты не оплачиваются.

Промпт для ИИ

Помогите мне написать скрипт, который вызывает API EveryInfra «Места».

Контракт API:
- Запрос: POST https://api.everyinfra.com/api/v1/search с заголовком Authorization: Bearer <API Key>. Берите ключ из переменной окружения EVERYINFRA_API_KEY, не указывайте его в коде.
- В теле запроса задайте для tool значение places, а параметры передайте в params.
- Обязательные параметры:
- q: Поисковый запрос.
- Необязательные параметры:
- location: Место, например город или район; используется в поиске вместе с запросом.
- num: Число мест, не более 20; при большем значении возвращается 20.
- Пример тела запроса:
{
"tool": "places",
"params": {
"q": "coffee",
"location": "New York",
"num": 3
}
}
- Оплата: Цена: $0.69 за 1 000 запросов ($0.000694 за вызов). Неудачные вызовы и пустые результаты не оплачиваются.
- При ошибке 422 исправьте параметры по подсказкам и допустимым значениям из ошибки. При 429 или 503 дождитесь истечения Retry-After и повторите попытку.

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

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

Имя	Расположение	Тип	Обязательный	По умолчанию	Описание
`Authorization`	header	`string`	Да	-	Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
`tool`	body	`string`	Да	`places`	Название инструмента, фиксированное значение.
`q`	body.params	`string`	Да	-	Поисковый запрос.
`location`	body.params	`string`	Нет	-	Место, например город или район; используется в поиске вместе с запросом.
`num`	body.params	`integer (1–20)`	Нет	`10`	Число мест, не более 20; при большем значении возвращается 20.

Примеры кода

bash

curl -X POST 'https://api.everyinfra.com/api/v1/search' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "tool": "places",
  "params": {
    "q": "coffee",
    "location": "New York",
    "num": 3
  }
}'

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

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

Реальный ответ

Получено October 24, 2026 at 22:01 (UTC) вызовом этого API с параметрами из примера кода выше. results и count — реальный ответ этого вызова, из которого удалены персональные данные (имена, никнеймы, аватары, ссылки на профили, контакты); в списке оставлены первые 2. id, billing и quota меняются при каждом вызове, поэтому показана только их структура.

json

{
  "id": "req_…",
  "tool": "places",
  "results": [
    {
      "title": "Dam Roast House & Browder Bookstore",
      "address": "554 Nevada Way, Boulder City, NV 89005",
      "latitude": 35.9771895,
      "longitude": -114.838469,
      "rating": 4.8,
      "rating_count": 561,
      "category": "Coffee shop",
      "categories": [
        "Coffee shop",
        "Book store"
      ],
      "phone": "•••",
      "website": "http://www.damroasthousebc.com/",
      "opening_hours": {
        "Saturday": "6 AM–5 PM",
        "Sunday": "6 AM–5 PM",
        "Monday": "6 AM–5 PM",
        "Tuesday": "6 AM–5 PM",
        "Wednesday": "6 AM–5 PM",
        "Thursday": "6 AM–5 PM",
        "Friday": "6 AM–5 PM"
      },
      "thumbnail_url": "https://lh3.googleusercontent.com/grass-cs/AABkmLf4-cpUw7kELwRhr17jbq5mKywqGj6YQcgRTRCjzyrp1IwiTyzk9E5y9cqSHfEc-gOK7eaWAMR1ahVoIM-rJ8Jfq50GDUFqSlYvRjJ9SXzrafaOW42dbzfD3_ex1ZfWf2Pw5YpJqad8nn7C",
      "place_id": "ChIJu5l4IRYryYARDeIpoXxvZEs"
    },
    {
      "title": "The Coffee Cup Cafe",
      "address": "512 Nevada Way, Boulder City, NV 89005",
      "latitude": 35.9776607,
      "longitude": -114.8379609,
      "rating": 4.8,
      "rating_count": 3948,
      "category": "Coffee shop",
      "categories": [
        "Coffee shop",
        "Bar",
        "Cafe"
      ],
      "phone": "•••",
      "website": "http://worldfamouscoffeecup.com/",
      "opening_hours": {
        "Saturday": "6 AM–2 PM",
        "Sunday": "6 AM–2 PM",
        "Monday": "6 AM–2 PM",
        "Tuesday": "6 AM–2 PM",
        "Wednesday": "6 AM–2 PM",
        "Thursday": "6 AM–2 PM",
        "Friday": "6 AM–2 PM"
      },
      "thumbnail_url": "https://lh3.googleusercontent.com/grass-cs/AABkmLeandCndjsMrUCyaMWX17I-LspQ9FviwQnndWDPuRWDs3PT8wAG99vD5KHNvjIafGiRp3A7rEUaZuNkxHXdOabApOI1onpOxhYZKMqNseQeiO3w-0IMKZvyMrIR4PjR9L_ayKY",
      "place_id": "ChIJ_92jHDQryYARn-GaGEjl2fw"
    }
  ],
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

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

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

Ошибки