| """ClinicalTrials.gov v2 async helper. |
| Docs: https://clinicaltrials.gov/api/gui/ref/api_urls#v2 |
| Provides `search_trials_v2` which returns a list of study dicts. |
| """ |
|
|
| import httpx, asyncio |
| from typing import List, Dict |
|
|
| _BASE = "https://clinicaltrials.gov/api/v2/studies" |
|
|
| async def search_trials_v2(query: str, *, max_n: int = 20) -> List[Dict]: |
| """Search CT.gov v2 endpoint and return list of studies.""" |
| params = { |
| "query": query, |
| "pageSize": max_n, |
| "fields": "nctId,briefTitle,phase,status,startDate,conditions,interventions", |
| } |
| async with httpx.AsyncClient(timeout=15) as client: |
| resp = await client.get(_BASE, params=params) |
| resp.raise_for_status() |
| return resp.json().get("studies", []) |
