API Reference

Documentation

REST API for patent search, analysis, and intelligence. All endpoints return JSON. Base URL: https://api.patentnexus.net

01 / Quick Start

Up and running in two requests

Step 1 — Get an API keyPOST /v1/signup
curl -X POST https://api.patentnexus.net/v1/signup \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}'
Step 2 — Search patentsGET /v1/search
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.patentnexus.net/v1/search?q=machine+learning"

Signup is free and instantly returns your API key with $1 in free credits — no credit card required.

02 / Authentication

Bearer token

Include your API key in every request as an HTTP header. Keys are prefixed pn_live_ and shown only once at signup.

Header
Authorization: Bearer pn_live_...

Get a key

POST /v1/signup with {"email": "you@example.com"} — returns your key immediately with $1 free credits. No authentication required.

03 / Pricing

Pay per request

TierCostEndpoints
Core$0.002 / reqPatent lookup, claims, citations, inventor search, assignee search, inventor detail, assignee detail
Search$0.01 / reqFull-text search, claims search, semantic search, classification browse, forgotten innovations
Intelligence$0.05 / reqSimilar patents, summary, technologies
Analysis$0.10 / reqPrior art search
Free$0 / reqHealth, signup, account balance

No subscriptions · No minimums · Credits never expire

04 / Account

Account endpoints

POST/v1/signup

Create API key. Public — no auth required. Returns key + $1 free credits.

free
GET/v1/account/balance

Check remaining credit balance.

free
POST/v1/account/credits

Purchase credits via Stripe. Body: {"package": "starter|builder|scale"}. Returns a checkout URL.

free
POST/v1/reset-key

Rotate API key. Public — no auth required. One key per email. Old key revoked immediately. Balance transferred to new key. No free credits on reset.

free
Signup — RequestPOST /v1/signup
curl -X POST https://api.patentnexus.net/v1/signup \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}'
Signup — Response200 OK
{
  "api_key": "pn_live_...",
  "message": "API key created with $1.00 free credits. Save this key — it won't be shown again."
}
Balance — Response200 OK
{
  "balance_micro_cents": 950000,
  "balance_dollars": 0.95
}
Purchase — RequestPOST /v1/account/credits
curl -X POST https://api.patentnexus.net/v1/account/credits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"package": "starter"}'
Purchase — Response200 OK
{
  "checkout_url": "https://checkout.stripe.com/c/pay/..."
}
Reset Key — RequestPOST /v1/reset-key
curl -X POST https://api.patentnexus.net/v1/reset-key \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}'
Reset Key — Response200 OK
{
  "api_key": "pn_live_...",
  "message": "New key generated. Old key revoked. Balance transferred."
}

Reset key notes

One key per email — the old key is revoked immediately.

Your credit balance is preserved on reset.

No free credits are granted on reset (only on first signup).

Credit packages

starter — $10

builder — $50

scale — $200

06 / Patents

Patent endpoints

$0.002 / request

GET/v1/patents/{patent_id}

Full patent record with inventors, assignees, classifications, citation counts, enrichment, and embedding status.

GET/v1/patents/{patent_id}/claims

Structured claim list with independent/dependent relationships.

GET/v1/patents/{patent_id}/citations

Forward citations (who cites this) and backward citations (what this cites).

GET/v1/inventors/{uuid}

Inventor profile with full list of associated patents. Requires UUID (from search results).

GET/v1/assignees/{uuid}

Assignee profile (company or individual) with patent portfolio. Requires UUID (from search results).

RequestGET /v1/patents/{patent_id}
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.patentnexus.net/v1/patents/US10985407B2
Response200 OK
{
  "id": "a1b2c3d4-...",
  "patent_id": "US10985407B2",
  "title": "Solid electrolyte for lithium-ion batteries",
  "abstract_text": "A solid electrolyte composition...",
  "filing_date": "2019-03-12",
  "grant_date": "2021-04-20",
  "status": "granted",
  "patent_type": "utility",
  "inventors": [
    { "id": "uuid-...", "name": "Jagdeep Singh", "location": "San Jose, CA" }
  ],
  "assignees": [
    { "id": "uuid-...", "name": "QuantumScape Corporation", "assignee_type": "company" }
  ],
  "classifications": [
    { "system": "CPC", "code": "H01M10/0562" }
  ],
  "citation_count_forward": 24,
  "citation_count_backward": 8,
  "enrichment": {
    "summary": "Describes a ceramic solid electrolyte...",
    "technologies": ["solid-state electrolyte", "lithium-ion"]
  },
  "has_embedding": true,
  "created_at": "2025-01-15T10:30:00Z",
  "updated_at": "2025-01-15T10:30:00Z"
}
Claims — Response200 OK
{
  "patent_id": "US10985407B2",
  "claims": [
    {
      "id": "uuid-...",
      "claim_number": 1,
      "claim_text": "A solid electrolyte comprising...",
      "is_independent": true,
      "depends_on": null
    },
    {
      "id": "uuid-...",
      "claim_number": 2,
      "claim_text": "The solid electrolyte of claim 1, wherein...",
      "is_independent": false,
      "depends_on": 1
    }
  ]
}
Citations — Response200 OK
{
  "patent_id": "US10985407B2",
  "backward": ["US9362546B2", "US8697291B2"],
  "forward": ["US11158880B2", "US11271248B1"]
}

07 / Intelligence

Intelligence endpoints

$0.05 / request

GET/v1/patents/{patent_id}/similar

Semantically similar patents ranked by embedding distance.

GET/v1/patents/{patent_id}/summary

AI-generated plain-English summary of the patent.

GET/v1/patents/{patent_id}/technologies

Structured list of technologies extracted from the patent text.

Summary — RequestGET /v1/patents/{id}/summary
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.patentnexus.net/v1/patents/US10985407B2/summary
Summary — Response200 OK
{
  "patent_id": "US10985407B2",
  "summary": "Describes a ceramic solid electrolyte for use in
    lithium-ion batteries that improves ionic conductivity
    while preventing dendrite formation...",
  "model_version": "gemini-2.5-flash-lite"
}
Technologies — Response200 OK
{
  "patent_id": "US10985407B2",
  "technologies": ["solid-state electrolyte", "lithium-ion battery",
    "ceramic composite", "dendrite suppression"],
  "model_version": "gemini-2.5-flash-lite"
}
Similar — Response200 OK
{
  "patent_id": "US10985407B2",
  "similar": [
    {
      "patent_id": "US11158880B2",
      "title": "Garnet-type solid electrolyte membrane",
      "similarity_score": 0.91
    }
  ]
}

08 / Analysis

Analysis endpoints

Pricing varies — see per-endpoint notes

POST/v1/prior-art

Prior art search. Body: {"description": "...", "classifications": ["H01M"], "limit": 20}

$0.10
POST/v1/discover/forgotten

Forgotten innovations. Body: {"query": "...", "filed_before": 2010, "min_citations": 5, "classification": "H01M"}

$0.01
Prior art — RequestPOST /v1/prior-art
curl -X POST https://api.patentnexus.net/v1/prior-art \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "solid-state lithium battery with ceramic electrolyte",
    "classifications": ["H01M"],
    "limit": 10
  }'
Prior art — Response200 OK
{
  "query": "solid-state lithium battery with ceramic electrolyte",
  "results": [
    {
      "patent_id": "US10985407B2",
      "title": "Solid electrolyte for lithium-ion batteries",
      "abstract_text": "A solid electrolyte composition...",
      "filing_date": "2019-03-12",
      "grant_date": "2021-04-20",
      "status": "granted",
      "relevance_score": 0.94,
      "relevance_explanation": "Directly relevant — ceramic electrolyte
        composition matches described approach",
      "classifications": ["H01M10/0562", "H01M10/0585"],
      "citation_count": 24,
      "claim_count": 15
    }
  ],
  "total_found": 1
}
Forgotten innovations — RequestPOST /v1/discover/forgotten
curl -X POST https://api.patentnexus.net/v1/discover/forgotten \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "piezoelectric energy harvesting wearables",
    "filed_before": 2010,
    "min_citations": 5
  }'
Forgotten innovations — Response200 OK
{
  "query": "piezoelectric energy harvesting wearables",
  "filed_before": 2010,
  "results": [
    {
      "patent_id": "US7439657B2",
      "title": "Piezoelectric generator for body motion",
      "abstract_text": "An energy harvesting device...",
      "filing_date": "2006-11-03",
      "grant_date": "2008-10-21",
      "estimated_expiry": "2026-10-28",
      "likely_expired": false,
      "relevance_score": 0.89,
      "citation_count": 12,
      "claim_count": 8,
      "classifications": ["H02N2/18", "H10N30/30"]
    }
  ],
  "total_found": 1
}

09 / System

System endpoints

GET/v1/health

API status, database/Redis health, patent counts, and version. No auth required.

free
POST/v1/webhooks/stripe

Internal Stripe webhook endpoint — not for public use.

internal
RequestGET /v1/health
curl https://api.patentnexus.net/v1/health
Response200 OK
{
  "status": "healthy",
  "database": "ok",
  "redis": "ok",
  "patent_count": 400241,
  "embedding_count": 182034,
  "version": "1.0.0"
}

Status values

healthy — database and Redis both operational

operational — database ok, Redis unavailable

degraded — database unreachable

10 / Responses

Response format

All responses are JSON with Content-Type: application/json. Successful responses include the resource at the top level. Errors return a consistent shape:

Error response
{"error_code": "NOT_FOUND", "message": "Patent not found"}
StatusError codeMeaning
400BAD_REQUESTInvalid parameters or body
401UNAUTHORIZEDMissing or invalid API key
402INSUFFICIENT_CREDITSAccount balance too low
404NOT_FOUNDResource does not exist
429RATE_LIMITEDToo many requests
500INTERNAL_ERRORServer-side error

11 / Rate Limits

Rate limits

100requests / minute / key

Exceeded limits return a 429 Too Many Requests response.

429 Response429
{
  "error_code": "RATE_LIMITED",
  "message": "100 requests per minute limit exceeded"
}