ClinicalTrials.gov · Study
clinicaltrials-gov/clinical-trials/studyGet health and medical data with ClinicalTrials.gov · Study from Alexandria through one Spiral API key. You have an NCT number (from search, a pasted clinicaltrials.gov/study URL or elsewhere) and need the full protocol, eligibility, locations, outcomes or posted results. It runs in the background and returns structured JSON. Pay as you go, with no subscription.
Pricing
$0.00873 per call.
Limits
- Runs
- In the background
- Returns
- json
- Longest queue wait
- 1 hour
- Run deadline
- 5 minutes
- Longest run, end to end
- 225 minutes
- Largest inline input
- 1 MB
- Largest input file
- 2 GB
- Largest output
- 5 GB
Input
| Field | Kind | Default | Description |
|---|---|---|---|
url | text | — | A clinicaltrials.gov/study/NCT... or classic ct2/show/NCT... URL. Mutually exclusive with nct_id. Pattern: ^https?://. |
fields | list | — | Field pieces to return (names from /api/v2/studies/metadata, e.g. StatusModule, IdentificationModule, EligibilityModule, ResultsSection). Default: every section except results. |
nct_id | text | — | NCT number, e.g. NCT05159778. Mutually exclusive with url. Pattern: ^[Nn][Cc][Tt][0-9]{8}$. |
include_results | true or false | — | Include resultsSection (posted results; can be megabytes) when fields is not given. |
Same request in code
curl https://api.spiral.ai/v1/runs \
-H "Authorization: Bearer $SPIRAL_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"provider": "alexandria",
"model": "clinicaltrials-gov/clinical-trials/study",
"input": {
"nct_id": "<nct_id>"
}
}'Frequently asked questions
How much does ClinicalTrials.gov · Study cost?
$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.
How do I use ClinicalTrials.gov · Study through an API?
Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "clinicaltrials-gov/clinical-trials/study"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.
Do I need an account with Alexandria to use ClinicalTrials.gov · Study?
No. Spiral runs it on its own Alexandria account and charges your Spiral balance.
Can my AI agent use ClinicalTrials.gov · Study?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.