API EverySearch Семантический поиск

POST

Состояние API

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

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

Норма

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

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

Семантический поиск: опишите, что ищете, одним предложением на естественном языке вместо набора ключевых слов. Он находит неочевидные источники, в заголовках которых нет слов из запроса. mode=deep ищет глубже, но медленнее и дороже

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

Промпт для ИИ

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

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

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

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

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

Примеры кода

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": "semantic",
  "params": {
    "q": "coffee",
    "num": 3
  }
}'

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

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

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

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

json

{
  "id": "req_…",
  "tool": "semantic",
  "results": [
    {
      "title": "Best Coffee Near Me - October 2026: Find Nearby Coffee Reviews - Yelp",
      "url": "https://www.yelp.com/nearme/coffee",
      "snippet": "Best Coffee Near Me - October 2026: Find Nearby Coffee Reviews - Yelp\n\n# Best Coffee Near Me\n\nThere's nothing like a freshly brewed cup of coffee to start your day, or to give you a much-needed pick-me-up in the afternoon. Whether you’re looking for a plain cup of joe, an elegant…"
    },
    {
      "title": "Coffee",
      "url": "https://www.fairtrade.net/en/products/Fairtrade_products/coffee.html",
      "snippet": "Coffee\n\nSorry, no match found!\n\n# Coffee\n\nOver a billion people drink coffee every day — but many of the farmers who grow it can’t earn a decent living. Coffee is one of the world’s most traded commodities, yet millions of small-scale farmers live in poverty due to low and unpred…"
    }
  ],
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

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

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

Ошибки