검색 API · 임상

임상 & 약리학 검색 API

ClinicalTrials.gov, FDA 약물 라벨, ChEMBL 생물활성, DrugBank 약리학을 단일 엔드포인트로. 의료 RAG, 약물 재포지셔닝 파이프라인, AI 기반 임상 의사결정 지원을 위한 미리 정형화된 JSON.

30 크레딧 / 호출30 요청 / 분POST /api/search/clinical

임상 검색 라이브 사용

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

API Authentication Required

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

API 키

API 키가 없으신가요?

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

로그인 API 키 관리

API Integration Guide

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

API Overview

ClinicalTrials.gov, FDA 승인 약물 라벨, ChEMBL, DrugBank 전반의 시맨틱 검색. 다운스트림 LLM에 바로 사용 가능한 제목, 요약, 출처 URL 반환.

POST

/api/search/clinical

Base URL

https://www.apipick.com

Full Endpoint

https://www.apipick.com/api/search/clinical

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/clinical" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "query": "CAR-T therapy effectiveness in pediatric leukemia latest studies",
  "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": "CAR-T therapy effectiveness in pediatric leukemia latest studies",
  "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": 30,
  "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

30req / min

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

🔀

Concurrency

3concurrent

Max simultaneous in-flight requests per API key.

Response Headers

X-RateLimit-Limit—Maximum requests allowed per minute

X-RateLimit-Remaining—Requests remaining in the current window

X-RateLimit-Reset—Seconds until the current window resets

Retry-After—Seconds to wait before retrying (only on 429)

429 Too Many Requests

HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12

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

자주 묻는 질문

어떤 출처가 포함되나요?

ClinicalTrials.gov(등록된 연구), FDA 약물 라벨(Structured Product Labeling), ChEMBL(생물활성 데이터), DrugBank(약물 약리학). 네 곳이 병렬 쿼리됩니다.

의학적 조언을 대체할 수 있나요?

아니요. 본 API는 연구·소프트웨어 워크플로를 위해 공개 데이터베이스를 노출합니다. 출력은 의학적 조언이 아니며 자격 있는 사람의 검토 없이 임상적 의사결정에 사용해서는 안 됩니다.

날짜 범위로 제한할 수 있나요?

네. start_date와 end_date를 전달해 시험과 라벨 업데이트를 날짜로 필터링할 수 있습니다.

실패한 호출의 크레딧은?

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

OpenAI / Claude용 도구 스키마는?

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