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