Developer API
A free, public REST API over our continuously-updated oncology dataset: research papers, news, blog posts, FDA approvals, and clinical trials.
All endpoints are read-only and return JSON. The API is free to use — you just need a free API key, which you can generate from your account.
Get your free API key → (sign in required). Base URL: https://curecancerwithai.com
Authentication
Pass your key in the Authorization header as a Bearer token (an x-api-key header is also accepted). Requests without a valid key receive 401 Unauthorized.
curl "https://curecancerwithai.com/api/v1/research?limit=1" \
-H "Authorization: Bearer ccw_live_YOUR_KEY"Rate limits
The free tier allows 100 requests per hour, per key (rolling window). Every response includes these headers:
X-RateLimit-Limit— your hourly limit (100).X-RateLimit-Remaining— requests left in the current window.X-RateLimit-Reset— ISO timestamp when the window resets.
Exceeding the limit returns 429 Too Many Requests with a Retry-After header.
Response shape
List endpoints return a data array plus pagination metadata:
{
"data": [ { /* record */ }, ... ],
"pagination": {
"total": 1280,
"limit": 20,
"offset": 0,
"page": 1,
"totalPages": 64
}
}Errors use a consistent shape:
{ "error": "Invalid or revoked API key." }Endpoints
GET/api/v1/research
Research papers
Peer-reviewed oncology research papers ingested from PubMed, including abstracts, authors, journal, and plain-language summaries.
Query parameters
cancerType— Filter by cancer type, e.g. "lung".treatmentType— Filter by treatment type.search— Keyword search across title and abstract.from / to— Filter by publication date (ISO, e.g. 2024-01-01).limit— Results per page (1–100, default 20).offset— Number of results to skip (default 0).
Example
curl "https://curecancerwithai.com/api/v1/research?cancerType=lung&limit=10" \
-H "Authorization: Bearer ccw_live_YOUR_KEY"GET/api/v1/research/{idOrPubmedId}
Single research paper
Fetch one paper by its internal id or PubMed id.
Example
curl "https://curecancerwithai.com/api/v1/research/38123456" \
-H "Authorization: Bearer ccw_live_YOUR_KEY"GET/api/v1/news
News
Curated cancer news articles aggregated from trusted sources.
Query parameters
cancerType— Filter by cancer type.search— Keyword search across title, summary, and content.from / to— Filter by published date.limit— Results per page (1–100, default 20).offset— Number of results to skip (default 0).
Example
curl "https://curecancerwithai.com/api/v1/news?cancerType=breast&limit=5" \
-H "Authorization: Bearer ccw_live_YOUR_KEY"GET/api/v1/blog
Blog posts
Editorial blog articles. Returns excerpts; fetch a single post by slug for full content.
Query parameters
category— Filter by primary category.cancerType— Filter by cancer-type tag.search— Keyword search across title, excerpt, and content.limit— Results per page (1–100, default 20).offset— Number of results to skip (default 0).
Example
curl "https://curecancerwithai.com/api/v1/blog?limit=10" \
-H "Authorization: Bearer ccw_live_YOUR_KEY"GET/api/v1/blog/{slug}
Single blog post
Fetch one blog post by slug, including the full article content.
Example
curl "https://curecancerwithai.com/api/v1/blog/immunotherapy-breakthroughs" \
-H "Authorization: Bearer ccw_live_YOUR_KEY"GET/api/v1/fda-approvals
FDA approvals
FDA-approved oncology drugs with indication, company, approval date, and label links.
Query parameters
cancerType— Filter by associated cancer type.search— Keyword search across drug name, generic name, and indication.from / to— Filter by approval date.limit— Results per page (1–100, default 20).offset— Number of results to skip (default 0).
Example
curl "https://curecancerwithai.com/api/v1/fda-approvals?limit=5" \
-H "Authorization: Bearer ccw_live_YOUR_KEY"GET/api/v1/clinical-trials
Clinical trials
Clinical trials ingested from registries, including conditions, status, and intervention type.
Query parameters
condition— Filter by condition.status— Filter by trial status, e.g. "RECRUITING".search— Keyword search across title and description.limit— Results per page (1–100, default 20).offset— Number of results to skip (default 0).
Example
curl "https://curecancerwithai.com/api/v1/clinical-trials?status=RECRUITING&limit=10" \
-H "Authorization: Bearer ccw_live_YOUR_KEY"GET/api/v1/clinical-trials/{nctId}
Single clinical trial
Fetch one trial by NCT id, including eligibility criteria and locations.
Example
curl "https://curecancerwithai.com/api/v1/clinical-trials/NCT01234567" \
-H "Authorization: Bearer ccw_live_YOUR_KEY"GET/api/v1/search
MASS search
Search a keyword across every dataset at once — research, news, blog, FDA approvals, and clinical trials — with results grouped by type.
Query parameters
q— Required. The keyword to search for.types— Optional comma-list to narrow datasets: research,news,blog,fdaApprovals,clinicalTrials.cancerType— Optional cancer-type filter applied to every dataset.limit— Max results per dataset (1–100, default 5).
Example
curl "https://curecancerwithai.com/api/v1/search?q=osimertinib&types=research,fdaApprovals" \
-H "Authorization: Bearer ccw_live_YOUR_KEY"Ready to build?
Get your free API key