API EverySearch Веб-поиск

POST

Состояние API

Состояние за 24 ч: 100%
Среднее время за 24 ч: 2.10 s

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

Работает стабильно

Последние 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 значение web, а параметры передайте в params.
- Обязательные параметры:
- q: Поисковый запрос.
- Необязательные параметры:
- site: Искать только на этом сайте (домене); то же самое, что добавить `site:` перед запросом.
- location: Регион: название страны или двухбуквенный код страны; если указан город, используется соответствующая страна.
- after: Только результаты после этой даты.
- before: Только результаты до этой даты.
- page: Номер страницы результатов (нумерация начинается с 1).
- num: Число результатов на странице, не более 10 (при большем значении возвращается 10); чтобы получить больше результатов, используйте page.
- Пример тела запроса:
{
"tool": "web",
"params": {
"q": "coffee",
"num": 3
}
}
- Оплата: Цена: $0.69 за 1 000 запросов ($0.000694 за вызов). Неудачные вызовы и пустые результаты не оплачиваются.
- При ошибке 422 исправьте параметры по подсказкам и допустимым значениям из ошибки. При 429 или 503 дождитесь истечения Retry-After и повторите попытку.

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

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

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

Примеры кода

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": "web",
  "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": "web",
  "results": [
    {
      "title": "Coffee",
      "url": "https://en.wikipedia.org/wiki/Coffee",
      "snippet": "Coffee is a beverage brewed from roasted, ground coffee beans. Dark-colored and bitter, coffee has a stimulating effect on humans due to its caffeine content; ..."
    },
    {
      "title": "Coffee - The Nutrition Source",
      "url": "https://nutritionsource.hsph.harvard.edu/food-features/coffee/",
      "snippet": "Various polyphenols in coffee have been shown to prevent cancer cell growth in animal studies. Coffee has also been associated with decreased estrogen levels, a ..."
    }
  ],
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

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

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

Ошибки