apipick
[ search · endpoint ]API поиска · Веб

API веб-поиска для AI-агентов

Эндпоинт веб-поиска в реальном времени, созданный для tool-calling LLM. Предсказуемый JSON-вывод, фильтры по стране и дате, оплата кредитами за вызов — подключайте к function calling OpenAI, tool use Claude или любому фреймворку агентов.

●15 кредитов / вызов●60 запр./минPOST /api/search/web
[ 01 · live ]

Попробуйте веб-поиск вживую

Введите свой API-ключ и выполните настоящий запрос к рабочему эндпоинту.

auth · x-api-key

Нет API-ключа?

Войдите в аккаунт, чтобы создавать и управлять API-ключами.

ВойтиУправлять API-ключами
5 примеров запросов — нажмите для подстановки
[ 02 · integrate ]

Integration guide

Copy a snippet, replace your API key, run. Works in any HTTP client — examples below in cURL, JavaScript, and Python.

spec
POST/api/search/web
base
https://www.apipick.com

Поиск по публичному вебу в реальном времени. Возвращает наиболее релевантные страницы с очищенными сниппетами, готовыми для последующих LLM.

parameters
querystringrequired

Natural-language search query

max_num_resultsintegeroptional

1–5, default 5

relevance_thresholdnumberoptional

0.0–1.0 quality filter

country_codestringoptional

ISO country code (e.g. US, GB)

start_datestringoptional

ISO date YYYY-MM-DD

end_datestringoptional

ISO date YYYY-MM-DD

curl -X POST "https://www.apipick.com/api/search/web" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "query": "latest developments in quantum computing",
  "max_num_results": 5,
  "country_code": "US",
  "start_date": "2026-01-01"
}'
● 200 · response
{
  "query": "latest developments in quantum computing",
  "results": [
    {
      "title": "Example result",
      "url": "https://example.com/article",
      "snippet": "Short excerpt of the page content…",
      "source_type": "web",
      "published_at": "2026-04-15",
      "score": 0.92
    }
  ],
  "result_count": 1,
  "credits_used": 15,
  "remaining_credits": 99
}
[ 03 · limits ]

Rate limits

Throttling is per API key, sliding 60-second window. Hit the limit and you get a clean 429 with a Retry-After header.

request rate

60req/min

Per API key, per endpoint. Sliding 60-second window.

concurrency

3concurrent

Max simultaneous in-flight requests per API key.

response headers
X-RateLimit-LimitMaximum requests allowed per minute
X-RateLimit-RemainingRequests remaining in the current window
X-RateLimit-ResetSeconds until the current window resets
Retry-AfterSeconds to wait before retrying (only on 429)
● 429 · too many requests
HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded: 60 requests/minute per API key. Retry after 12s.",
  "retry_after": 12
}
[ faq ]

Часто задаваемые вопросы

01

Чем отличается от API поиска Google или Bing?

Ответы заранее подготовлены под потребление LLM: короткие сниппеты (без шаблонов), структурированный JSON и оценка релевантности. Не нужен отдельный шаг скрапинга и очистки перед передачей результатов модели.

02

Как ранжируются результаты?

Результаты ранжируются по семантическим эмбеддингам, а не по совпадению ключевых слов, поэтому близкие по смыслу элементы оказываются рядом, даже если формулировки разные. Также можно передать relevance_threshold (0.0–1.0), чтобы отбросить низкокачественные результаты.

03

Можно ли ограничить страну или диапазон дат?

Да. Передайте country_code (ISO 3166-1 alpha-2, например US, JP) и/или start_date / end_date в формате YYYY-MM-DD.

04

Как работают кредиты при неудачных вызовах?

Если поиск не удался (5xx или некорректный запрос), кредиты не списываются. Оплата только за успешные ответы 2xx.

05

Есть ли схема инструмента для function calling OpenAI?

Да. GET /api/search/web/tool-schema возвращает готовые к вставке определения OpenAI function и tool use Claude.