API documentation

Programmatic access to PharmaCliff. Use it to embed patent intelligence in your internal tools or integrate with your existing R&D pipeline.

Authentication

All requests use Bearer token authentication. Generate a key at /dashboard/api-keys, then include it in every request:

Authorization: Bearer pr_live_<your_secret>

Rate limits

  • 1,000 requests/hour per key by default (will be tier-aware soon)
  • Standard X-RateLimit-* response headers indicate remaining quota
  • Exceeding the limit returns HTTP 429 with a Retry-After header

Endpoints

GET/api/v1/patents

Search and filter patents. Same filter set as the web search page.

Query parameters

  • q — full-text on title + abstract
  • area — therapeutic area slug (see below)
  • jurisdiction — US, EP, IN, JP, KR, CN
  • holder — partial match on assignee name
  • expiry_after, expiry_before — YYYY-MM-DD
  • sort — expiry_asc | expiry_desc | citations_desc
  • limit (max 200, default 50), offset
curl https://pharmacliff.eu/api/v1/patents?area=glp1-diabetes \
  -H "Authorization: Bearer pr_live_..."
GET/api/v1/patents/{id}

Full detail for a single patent — abstract, family, AI relevance scores, FDA Orange Book links, AI analysis cache.

curl https://pharmacliff.eu/api/v1/patents/abc-123 \
  -H "Authorization: Bearer pr_live_..."

Therapeutic-area slugs

28 supported areas. Pass any of these as the area query param.

glp1-diabetesoncologyoncology-biologiccardiovascularcns-neurologymental-healthbiologics-mabbiosimilarsantibioticsantiviralsrespiratorydermatologyophthalmologyimmunologyvaccinesrare-orphanpain-analgesicsanti-infectivehormonalgirenalhematologybone-musculoskeletalwomens-healthurologyallergyanesthesiawound-care