API Reference

Documentation

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

01 / Authentication

API keys

All requests require an API key passed as a Bearer token in the Authorization header. Get your key from the account dashboard.

Authentication header

Authorization: Bearer pn_live_your_key_here

Quick start

curl -H "Authorization: Bearer pn_live_..." \
  "https://api.patentnexus.net/v1/search?q=battery+cathode"

02 / Search

Patent search endpoints

GET/v1/search

Full-text keyword search across title, abstract, and claims.

1 credit

GET/v1/search/semantic

Vector similarity search — finds patents by meaning, not just keywords.

3 credits

GET/v1/search/combined

Hybrid search: keyword + semantic, merged and reranked.

4 credits

GET/v1/search/assignee

Search patents by assignee (company or individual).

1 credit

GET/v1/search/inventor

Search patents by inventor name.

1 credit

GET/v1/search/cpc

Search patents by CPC classification code.

1 credit

Example: keyword searchGET /v1/search

curl "https://api.patentnexus.net/v1/search?q=battery+cathode&limit=10" \
  -H "Authorization: Bearer pn_live_..."

03 / Patent Lookup

Patent details

GET/v1/patents/:number

Full patent details: title, abstract, claims, inventors, assignees, CPC codes, citations.

1 credit

GET/v1/patents/:number/citations

Patents cited by and citing this patent.

1 credit

GET/v1/patents/:number/similar

Semantically similar patents.

3 credits

Example: patent lookupGET /v1/patents/:number

curl "https://api.patentnexus.net/v1/patents/US10000000B2" \
  -H "Authorization: Bearer pn_live_..."

04 / Analysis

AI analysis endpoints

POST/v1/analyze/patentability

Full patentability analysis: prior art, novelty assessment, claim gaps, recommendations.

20–50 credits

POST/v1/analyze/classify

Classify invention into CPC codes and technology domains.

3 credits

GET/v1/landscape

Patent landscape: filing trends, top assignees, geographic distribution.

10 credits

GET/v1/stats/assignee

Patent statistics for a specific assignee.

2 credits

Example: patentability analysisPOST /v1/analyze/patentability

curl -X POST "https://api.patentnexus.net/v1/analyze/patentability" \
  -H "Authorization: Bearer pn_live_..." \
  -H "Content-Type: application/json" \
  -d '{"description": "A battery with a solid-state electrolyte...", "depth": "standard"}'

05 / Errors

Error responses

All errors return a consistent JSON shape with an error_code and message.

Error format

{"error_code": "NOT_FOUND", "message": "Patent not found"}

StatusError codeMeaning

400BAD_REQUESTInvalid parameters

401UNAUTHORIZEDMissing or invalid API key

402INSUFFICIENT_CREDITSBalance too low

404NOT_FOUNDResource not found

429RATE_LIMITEDToo many requests

500INTERNAL_ERRORServer error

06 / Rate Limits

Rate limits

100requests / minute / key

Exceeded limits return a 429 RATE_LIMITED response.

Get API Key API Status