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
curl -X POST https://api.patentnexus.net/v1/signup \
-H "Content-Type: application/json" \
-d '{"email": "you@example.com"}'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.
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
No subscriptions · No minimums · Credits never expire
04 / Account
Account endpoints
/v1/signupCreate API key. Public — no auth required. Returns key + $1 free credits.
free/v1/account/balanceCheck remaining credit balance.
free/v1/account/creditsPurchase credits via Stripe. Body: {"package": "starter|builder|scale"}. Returns a checkout URL.
free/v1/reset-keyRotate API key. Public — no auth required. One key per email. Old key revoked immediately. Balance transferred to new key. No free credits on reset.
freecurl -X POST https://api.patentnexus.net/v1/signup \
-H "Content-Type: application/json" \
-d '{"email": "you@example.com"}'{
"api_key": "pn_live_...",
"message": "API key created with $1.00 free credits. Save this key — it won't be shown again."
}{
"balance_micro_cents": 950000,
"balance_dollars": 0.95
}curl -X POST https://api.patentnexus.net/v1/account/credits \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"package": "starter"}'{
"checkout_url": "https://checkout.stripe.com/c/pay/..."
}curl -X POST https://api.patentnexus.net/v1/reset-key \
-H "Content-Type: application/json" \
-d '{"email": "you@example.com"}'{
"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
05 / Search
Search endpoints
Pricing varies — see per-endpoint notes
/v1/search?q={query}&limit=20Full-text patent search across titles, abstracts, and claims. Supports optional filters: filing_date_from, filing_date_to, assignee, status.
$0.01/v1/search/claims?q={query}Search specifically within patent claim text.
$0.01/v1/search/semanticSemantic vector search. Body: {"query": "...", "limit": 20}
$0.01/v1/search/inventors?q={name}Fuzzy search for inventors by name.
$0.002/v1/search/assignees?q={name}Fuzzy search for assignees (companies / individuals) by name.
$0.002/v1/classifications/{code}/patentsBrowse patents by CPC or IPC classification code.
$0.01Full-text search filters
filing_date_from — YYYY-MM-DD, include patents filed on or after this date
filing_date_to — YYYY-MM-DD, include patents filed on or before this date
assignee — filter by assignee name (case-insensitive substring match)
status — filter by patent status (e.g. "granted", "pending")
limit — max results, 1-100, default 20
curl -X POST https://api.patentnexus.net/v1/search/semantic \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "solid state battery ceramic electrolyte", "limit": 5}'{
"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",
"relevance_score": 0.94
}
],
"total_estimate": 1,
"next_cursor": null
}06 / Patents
Patent endpoints
$0.002 / request
/v1/patents/{patent_id}Full patent record with inventors, assignees, classifications, citation counts, enrichment, and embedding status.
/v1/patents/{patent_id}/claimsStructured claim list with independent/dependent relationships.
/v1/patents/{patent_id}/citationsForward citations (who cites this) and backward citations (what this cites).
/v1/inventors/{uuid}Inventor profile with full list of associated patents. Requires UUID (from search results).
/v1/assignees/{uuid}Assignee profile (company or individual) with patent portfolio. Requires UUID (from search results).
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://api.patentnexus.net/v1/patents/US10985407B2{
"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"
}{
"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
}
]
}{
"patent_id": "US10985407B2",
"backward": ["US9362546B2", "US8697291B2"],
"forward": ["US11158880B2", "US11271248B1"]
}07 / Intelligence
Intelligence endpoints
$0.05 / request
/v1/patents/{patent_id}/similarSemantically similar patents ranked by embedding distance.
/v1/patents/{patent_id}/summaryAI-generated plain-English summary of the patent.
/v1/patents/{patent_id}/technologiesStructured list of technologies extracted from the patent text.
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://api.patentnexus.net/v1/patents/US10985407B2/summary{
"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"
}{
"patent_id": "US10985407B2",
"technologies": ["solid-state electrolyte", "lithium-ion battery",
"ceramic composite", "dendrite suppression"],
"model_version": "gemini-2.5-flash-lite"
}{
"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
/v1/prior-artPrior art search. Body: {"description": "...", "classifications": ["H01M"], "limit": 20}
$0.10/v1/discover/forgottenForgotten innovations. Body: {"query": "...", "filed_before": 2010, "min_citations": 5, "classification": "H01M"}
$0.01curl -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
}'{
"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
}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
}'{
"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
/v1/healthAPI status, database/Redis health, patent counts, and version. No auth required.
free/v1/webhooks/stripeInternal Stripe webhook endpoint — not for public use.
internalcurl https://api.patentnexus.net/v1/health{
"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_code": "NOT_FOUND", "message": "Patent not found"}BAD_REQUESTInvalid parameters or bodyUNAUTHORIZEDMissing or invalid API keyINSUFFICIENT_CREDITSAccount balance too lowNOT_FOUNDResource does not existRATE_LIMITEDToo many requestsINTERNAL_ERRORServer-side error11 / Rate Limits
Rate limits
Exceeded limits return a 429 Too Many Requests response.
{
"error_code": "RATE_LIMITED",
"message": "100 requests per minute limit exceeded"
}