API de búsqueda · Clínica

API de búsqueda clínica y farmacología

Un solo endpoint sobre ClinicalTrials.gov, fichas técnicas de la FDA, bioactividad de ChEMBL y farmacología de DrugBank. JSON preformateado para RAG médico, pipelines de reposicionamiento de fármacos y soporte de decisiones clínicas con IA.

30 créditos / llamada30 req / minPOST /api/search/clinical

Prueba la búsqueda clínica en directo

Introduce tu API Key y ejecuta una consulta real contra el endpoint en producción.

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

¿No tienes una clave API?

Inicia sesión en tu cuenta para crear y gestionar tus claves API.

5 consultas de ejemplo — haz clic para cargar

API Integration Guide

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

API Overview
Búsqueda semántica en ClinicalTrials.gov, fichas técnicas aprobadas por la FDA, ChEMBL y DrugBank. Devuelve títulos, resúmenes y URLs fuente listas para LLMs.
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
}

Preguntas frecuentes

¿Qué fuentes están cubiertas?

ClinicalTrials.gov (estudios registrados), fichas técnicas de la FDA (Structured Product Labeling), ChEMBL (datos de bioactividad) y DrugBank (farmacología). Las cuatro se consultan en paralelo.

¿Sustituye al consejo médico?

No. La API expone bases de datos públicas para investigación y flujos de software. La salida no es consejo médico y no debe usarse para decisiones clínicas sin un humano cualificado en el bucle.

¿Puedo restringir por rango de fechas?

Sí. Pasa start_date y end_date para filtrar ensayos y actualizaciones de fichas por fecha.

¿Cómo funcionan los créditos en llamadas fallidas?

Si la búsqueda falla (5xx) o la consulta es inválida (4xx), no se descuentan créditos. Solo se cobra en respuestas 2xx exitosas.

¿Esquema tool para OpenAI / Claude?

GET /api/search/clinical/tool-schema devuelve definiciones listas para pegar de function calling de OpenAI y tool use de Claude.