Aapipick
검색 API · 웹

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

LLM 도구 호출을 위해 제작된 실시간 웹 검색 엔드포인트. 예측 가능한 JSON 출력, 국가·날짜 필터, 호출당 크레딧 청구 — OpenAI 함수 호출, Claude 도구 사용, 어떠한 에이전트 프레임워크에든 연결 가능.

15 크레딧 / 호출60 요청 / 분POST /api/search/web

웹 검색 라이브 사용

API 키를 입력하고 라이브 엔드포인트에 실제 쿼리를 실행하세요.

API Authentication Required
Enter your API key to access this service. All API calls require authentication.

API 키가 없으신가요?

계정에 로그인하여 API 키를 생성하고 관리하세요.

로그인API 키 관리
5개 샘플 쿼리 — 클릭하여 불러오기

API Integration Guide

Learn how to integrate this API into your applications with code examples and detailed documentation.

API Overview
공개 웹을 실시간으로 검색. 가장 관련성 높은 페이지를 정리된 스니펫과 함께 반환하여 다운스트림 LLM에 바로 사용 가능.
POST
/api/search/web

Base URL

https://www.apipick.com

Full Endpoint

https://www.apipick.com/api/search/web
Parameters
Required and optional parameters for this API
query
required
string

Natural-language search query

max_num_results
optional
integer

1–5, default 5

relevance_threshold
optional
number

0.0–1.0 quality filter

country_code
optional
string

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

start_date
optional
string

ISO date YYYY-MM-DD

end_date
optional
string

ISO date YYYY-MM-DD

Code Examples
Copy and paste these examples to quickly integrate the API into your application

cURL Request

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"
}'
Replace YOUR_API_KEY with your actual API key
Response Example
Example response from the API

JSON 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
}
Integration Tips

✓Best Practices

  • • Always include x-api-key header
  • • Always handle errors gracefully
  • • Validate input data before sending
  • • Use HTTPS for secure communication
  • • Cache responses when appropriate

ℹResponse Headers

  • • Content-Type: application/json
  • • x-api-key: Required for authentication
  • • Status codes: 200 (success), 400 (error), 401 (unauthorized)
  • • No rate limiting applied

Rate Limits

⏱️

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
}

자주 묻는 질문

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

응답이 LLM 소비용으로 미리 정형화되어 있습니다: 짧은 스니펫(보일러플레이트 없음), 구조화 JSON, 관련성 점수. 모델에 결과를 넘기기 전에 별도의 스크래핑·정제 단계가 필요 없습니다.

결과는 어떻게 순위가 매겨지나요?

키워드 매칭이 아닌 시맨틱 임베딩으로 순위가 매겨지므로, 표현이 달라도 의미가 비슷한 항목이 가까이 위치합니다. relevance_threshold(0.0–1.0)를 전달해 저품질 결과를 걸러낼 수도 있습니다.

특정 국가나 날짜 범위로 제한할 수 있나요?

네. country_code(ISO 3166-1 alpha-2, 예: US, JP)와/또는 start_date / end_date를 YYYY-MM-DD 형식으로 전달하세요.

실패한 호출의 크레딧은 어떻게 되나요?

검색이 실패하거나(5xx, 잘못된 쿼리) 실패 시 크레딧은 차감되지 않습니다. 성공한 2xx 응답에 대해서만 청구됩니다.

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

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