apipick
[ search · endpoint ]검색 API · 웹

AI 에이전트를 위한 웹 검색 API

LLM 도구 호출을 위해 제작된 실시간 웹 검색 엔드포인트. 예측 가능한 JSON 출력, 국가·날짜 필터, 호출당 크레딧 청구 — OpenAI 함수 호출, 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

Google이나 Bing 검색 API와 무엇이 다른가요?

응답이 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

OpenAI 함수 호출용 도구 스키마가 있나요?

네. GET /api/search/web/tool-schema가 OpenAI 함수와 Claude 도구 사용 정의를 즉시 붙여 넣을 수 있는 형태로 반환합니다.