API Documentation

Disease Landscape & Autocomplete API

Two endpoints designed to work together: autocomplete resolves a disease name to a stable CURIE, and the landscape endpoint returns a comprehensive, entity‑resolved report for competitive intelligence.

LLM‑Friendly Summary

Copy a concise, machine‑readable description of both endpoints to paste into your LLM.

Getting Started

Base URLs

https://app.caelrith.com/api/v1/diseases/autocompletehttps://app.caelrith.com/api/v1/analysis/disease-landscape

Authentication

Include your API key in the x-api-key header:

curl -H "x-api-key: YOUR_API_KEY" \
  "https://app.caelrith.com/api/v1/diseases/autocomplete?q=breast"

Rate Limits

Daily call quotas are enforced per tenant. Both endpoints require a Pro workspace (free tier returns 402 Payment Required).

Free Tier

0 calls / day for both the autocomplete and landscape endpoints. Upgrade to Pro.

Pro Tier

10,000 calls / day for autocomplete

1,000 calls / day for landscape reports

Recommended Workflow

The landscape endpoint works best when you provide a stable CURIE. Use the autocomplete to discover the correct CURIE for a disease name, then call the landscape endpoint with that CURIE. This avoids ambiguity and returns the most complete data.

Call GET /diseases/autocomplete?q=breast cancer to get a list of candidate diseases.
Pick the most relevant result, e.g., EFO:0003767.
Call POST /analysis/disease-landscape with body {"efo_id":"EFO:0003767"}.
Receive the full landscape report with trials, grants, regulatory, and Medicare data.

Endpoints

GET/diseases/autocomplete

Disease Autocomplete (Pro)

Search for disease names and retrieve their official CURIE identifiers. Only diseases with clinical trial data are returned. Requires Pro workspace.

Parameter	Type	Required	Description
q	string	Yes	Partial disease name to search (e.g., "breast cancer", "alzheimer").

Example Request

curl -H "x-api-key: YOUR_KEY" \
  "https://app.caelrith.com/api/v1/diseases/autocomplete?q=breast cancer"

Example Response

{
  "data": [
    {
      "name": "breast cancer",
      "efo_id": "EFO:0003767"
    },
    {
      "name": "breast carcinoma",
      "efo_id": "MONDO:0004979"
    },
    ...
  ],
  "meta": {
    "query": "breast cancer",
    "returned": 5
  }
}

POST/analysis/disease-landscape

Disease Landscape Report (Pro)

Generate a comprehensive competitive intelligence report for any disease. The response includes clinical trial snapshots, grant funding, regulatory approvals, Medicare drug spending, and a 0–100 competitiveness index. Requires Pro workspace.

Parameter	Type	Required	Description
disease	string	No	Exact disease name to search. Use only if you don’t have the EFO ID. Less precise than efo_id.
efo_id	string	No	Disease CURIE (e.g. EFO:0003767). Prefer this if you have it – results are guaranteed. One of disease or efo_id must be provided.

Example Request (using EFO ID from autocomplete)

curl -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"efo_id":"EFO:0003767"}' \
  "https://app.caelrith.com/api/v1/analysis/disease-landscape"

Example Response (abbreviated)

Show example JSON response

{
  "data": {
    "disease": "breast cancer",
    "trials": {
      "totalTrials": 13542,
      "byPhase": {
        "Phase 1": 2341,
        "Phase 2": 5678,
        "Phase 3": 4321,
        "Phase 4": 1202
      },
      "medianEnrollment": 72,
      "activeSponsors": [
        "PFIZER INC.",
        "NOVARTIS AG",
        "ROCHE HOLDING AG"
      ],
      "recentStatusChanges": {
        "started": 145,
        "completed": 230,
        "terminated": 18
      }
    },
    "grants": {
      "totalGrants": 2894,
      "totalFundingUsd": 4230765210,
      "topInstitutions": [
        "Harvard University",
        "University of Texas MD Anderson Cancer Center",
        "Memorial Sloan Kettering Cancer Center"
      ]
    },
    "regulatory": {
      "totalApprovals": 47,
      "orphanShare": 0.12,
      "lastApprovalDate": "2025-11-15"
    },
    "medicare": {
      "totalSpendingUsd": 8432000000,
      "topBrandDrugs": ["Ibrance", "Kadcyla", "Perjeta"],
      "brandedShare": 0.89
    },
    "competitivenessIndex": 87
  }
}

Landscape Response Reference

The following fields are returned in the data object.

Field	Type	Description
disease	string	Resolved disease name.
trials.totalTrials	integer	Number of clinical trials linked to this disease.
trials.byPhase	object	Phase distribution (e.g., { "Phase 2": 120, "Phase 3": 45 }).
trials.medianEnrollment	integer\|null	Median trial enrollment.
trials.activeSponsors	string[]	Top active sponsors by trial count.
trials.recentStatusChanges	object	Counts of started, completed, and terminated trials recently.
grants.totalGrants	integer	Number of NIH/EU grants tagged with related topics.
grants.totalFundingUsd	number	Total funding amount in USD.
grants.topInstitutions	string[]	Top institutions by grant count.
regulatory.totalApprovals	integer	Number of distinct drugs with at least one approval for this disease.
regulatory.orphanShare	number	Fraction of approved drugs with orphan designation.
regulatory.lastApprovalDate	string\|null	Latest approval date (YYYY-MM-DD).
medicare.totalSpendingUsd	number	Total Medicare Part D spending on linked drugs.
medicare.topBrandDrugs	string[]	Top branded drugs by spending.
medicare.brandedShare	number	Fraction of spending on branded drugs.
competitivenessIndex	integer	0–100 score indicating competitive pressure (higher = more crowded).

Need an API key?

The Disease APIs are available with your Caelrith Pro account. Upgrade to Pro for full access.

Go to Dashboard