Aapipick
API поиска · Клинический

API клинического и фармакологического поиска

Один эндпоинт над ClinicalTrials.gov, инструкциями FDA, биоактивностью ChEMBL и фармакологией DrugBank. Заранее подготовленный JSON для медицинского RAG, пайплайнов перепрофилирования и AI-поддержки клинических решений.

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-ключами
5 примеров запросов — нажмите для подстановки

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. Возвращает заголовки, аннотации и URL источников, готовые для последующих LLM.
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-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: 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 function и tool use Claude.