Aapipick
검색 API · 뉴스

AI 에이전트를 위한 뉴스 검색 API

주요 매체를 아우르는 라이브 뉴스 검색에 국가·날짜 필터 내장. 아침 브리핑 봇, 시장 뉴스 에이전트, 답변을 시사에 근거하게 만들어야 하는 모든 RAG 파이프라인을 위해 설계.

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

뉴스 검색 라이브 사용

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/news

Base URL

https://www.apipick.com

Full Endpoint

https://www.apipick.com/api/search/news
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/news" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "query": "artificial intelligence regulation updates",
  "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": "artificial intelligence regulation updates",
  "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
}

자주 묻는 질문

결과는 얼마나 신선한가요?

최근 몇 분 내 인덱싱된 기사도 포함됩니다. start_date / end_date로 특정 윈도우(예: 속보용 최근 24시간, 실적 보도용 최근 분기)에 한정할 수 있습니다.

국가로 필터링할 수 있나요?

네. country_code는 ISO 3166-1 alpha-2 코드(US, GB, JP, DE 등)를 받습니다. 해당 국가 출처에 결과를 편향시킵니다.

/api/search/web와의 차이는?

뉴스 엔드포인트는 발행일이 있는 저널리즘 매체에 맞춰져 있고 시의성이 있는 기사를 선호합니다. /api/search/web는 일반 참조 콘텐츠(문서, 위키 형식, 에버그린 페이지)에 더 적합합니다.

AI 에이전트용 도구 스키마가 있나요?

네. GET /api/search/news/tool-schema가 에이전트 코드에 바로 붙여 넣을 수 있는 OpenAI 함수와 Claude 도구 사용 정의를 반환합니다.