▣ DATA EXTRACTION

US Patent Search & Records API

What it does

US Patent Intelligence gives you a complete working surface over PatentsView-disambiguated US patent grant data — search, full record detail, related entities, full-text sections, and portfolio-level analytics — all in one API.

Start with search: /patents/search handles simple keyword + year lookups against title and abstract, while /patents/advanced-search adds multi-constraint filtering by patent type, WIPO kind, CPC section, assignee name, inventor name, and an explicit year range with pagination via limit/offset. Both return patent_id, patent_title, patent_date, patent_type, wipo_kind, and num_claims for each hit.

Once you have a patent_id, /patents/{patent_id} returns the full technical envelope: core grant metadata and abstract, disambiguated assignee records, disambiguated inventor records, active CPC classifications, and an aggregate citation count. If you only need one slice of that envelope, dedicated endpoints are available for /assignees, /inventors, /classifications, and /citations (the latter supporting backward or forward direction to trace prior art or later filings that cite the patent).

For full-text work, /patent-text/search runs relevance-ranked search across indexed patent sections (claims, abstract, description, summary) with optional section_type and year-range filters, and /patent-text/{patent_id} retrieves all indexed text sections for a specific patent in order.

Three analytics endpoints round out the API for reporting and dashboards: /patents/analytics/yearly-trend (granted volume and average claims by year), /patents/analytics/cpc-breakdown (top classification combinations by volume), and /patent-text/analytics/section-breakdown (document counts by section type).

Use US Patent Intelligence for prior-art review, competitive research, patent discovery tools, or any workflow that needs both patent metadata and searchable patent text without building an index from scratch. Every response includes attribution data for source and license tracking.

▣ ENDPOINT 01 / 12

GET

Search US Patents

https://api.eu.apyhub.com/dosvak/search-uspto-patents/api/v1/uspto/patents/search

QUICKSTART

GUIDE

Quickstart

Search US patents with the required query term and optional year/limit filters.

curl -X GET "https://api.eu.apyhub.com/dosvak/search-uspto-patents/api/v1/uspto/patents/search?query=wireless%20charging&year=2024&limit=25" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with year (integer or null), count (integer), query (string), results (array of patent summary objects), and attribution (array of attribution objects).

{
  "year": 2024,
  "count": 1,
  "query": "wireless charging",
  "results": [],
  "attribution": []
}

TRY ITLIVE · 100 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Searches US patents using a query string, with optional year filtering and a configurable result limit. Returns a JSON object containing the echoed search criteria, a total count, a results array of patent summary records, and attribution entries.

Query Parameter(s)

Attribute	Type	Mandatory	Description
year	String	No	Optional year filter. Accepts an integer value from 1976 to 2100, or `null`.
limit	Integer	No	Maximum number of results to return. Default: `20`. Minimum: `1`. Maximum: `200`.
query	String	Yes	Search query text. Minimum length: `2`.

Response

Returns a JSON object with year, count, and query fields, plus results and attribution arrays. year is an integer or null; count is an integer; query is a string; results contains patent summary objects; and attribution contains attribution items. Success response is returned on 200.

Attribute	Type	Mandatory	Description
year	Integer	No	The year filter echoed in the response, or `null`.
count	Integer	No	Total number of matching results.
query	String	No	The search query echoed in the response.
results	Object Array	No	Patent summary records. Each item includes `patent_id`, `wipo_kind`, `num_claims`, `patent_date`, `patent_type`, `patent_title`, and `patent_abstract`.
attribution	Object Array	No	Attribution records. Each item includes `url`, `notice`, `source`, `dataset`, and `license`.

Query parameters

Name

Type

Description

yearOPTIONAL

string

—

limitOPTIONAL

integer

—

DEFAULT 20

queryREQUIRED

string

—

▣ ENDPOINT 02 / 12

GET

Search US Patents (Advanced)

https://api.eu.apyhub.com/dosvak/search-uspto-patents/api/v1/uspto/patents/advanced-search

QUICKSTART

GUIDE

Quickstart

Search U.S. patents with a simple query and the default limit.

curl -X GET "https://api.eu.apyhub.com/dosvak/search-uspto-patents/api/v1/uspto/patents/advanced-search?query=charging&limit=25" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with count as an integer, query as a string or null, filters as an object, results as an array of patent summary objects, and attribution as an array of attribution objects.

{
  "count": 0,
  "query": "charging",
  "filters": {
    "limit": 25,
    "offset": 0,
    "year_to": null,
    "wipo_kind": null,
    "year_from": null,
    "cpc_section": null,
    "patent_type": null,
    "assignee_contains": null,
    "inventor_contains": null
  },
  "results": [],
  "attribution": []
}

TRY ITLIVE · 100 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Searches US patents using the advanced query filters provided in the request query string and returns a paginated JSON object with the matching patent summaries, the applied filters, and attribution information.

Query Parameter(s)

Attribute	Type	Mandatory	Description
limit	Integer	No	Maximum number of results to return. Default: `25`. Minimum: `1`. Maximum: `200`.
query	String	No	Search text. Must be at least 2 characters when provided.
offset	Integer	No	Zero-based result offset for pagination. Default: `0`. Minimum: `0`. Maximum: `100000`.
year_to	String	No	Upper bound for the patent year filter. The schema constrains this to an integer value when provided; examples use `2024`.
wipo_kind	String	No	WIPO kind filter.
year_from	String	No	Lower bound for the patent year filter. The schema constrains this to an integer value when provided; examples use `2020`.
cpc_section	String	No	CPC section filter. Must be exactly 1 character when provided.
patent_type	String	No	Patent type filter.
assignee_contains	String	No	Matches patents whose assignee contains the provided text. Must be at least 2 characters when provided.
inventor_contains	String	No	Matches patents whose inventor contains the provided text. Must be at least 2 characters when provided.

Response

Returns a JSON object with count as an integer, query as a string or null, filters as an object, results as an array of patent summary objects, and attribution as an array of attribution objects.

Parameter	Type	Mandatory	Description
count	Integer	Yes	Total number of matching results.
query	String	Yes	The query value echoed in the response; nullable.
filters	Object	Yes	The applied filter values. Includes `limit` and `offset`, plus optional filter fields that may be null: `year_to`, `wipo_kind`, `year_from`, `cpc_section`, `patent_type`, `assignee_contains`, and `inventor_contains`.
results	Object Array	Yes	Array of patent summary rows. Each item contains `patent_id`, `wipo_kind`, `num_claims`, `patent_date` (date string), `patent_type`, and `patent_title`.
attribution	Object Array	Yes	Array of attribution items. Each item contains `url` (URI string), `notice`, `source`, `dataset`, and `license`.

Query parameters

Name

Type

Description

limitOPTIONAL

integer

—

DEFAULT 25

queryOPTIONAL

string

—

offsetOPTIONAL

integer

—

DEFAULT 0

year_toOPTIONAL

string

—

wipo_kindOPTIONAL

string

—

year_fromOPTIONAL

string

—

cpc_sectionOPTIONAL

string

—

patent_typeOPTIONAL

string

—

assignee_containsOPTIONAL

string

—

inventor_containsOPTIONAL

string

—

▣ ENDPOINT 03 / 12

GET

Get US Patent Details

https://api.eu.apyhub.com/dosvak/search-uspto-patents/api/v1/uspto/patents/:patent_id

QUICKSTART

GUIDE

Quickstart

Fetch patent details by providing the patent ID in the path.

curl -X GET "https://api.eu.apyhub.com/dosvak/search-uspto-patents/api/v1/uspto/patents/:patent_id" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with top-level fields such as patent (an object), assignees (an array), inventors (an array), attribution (an array), cpc_current (an array), and citation_count (an integer), as declared by the response schema.

{
  "patent": {
    "patent_id": "12508435",
    "wipo_kind": "A1",
    "withdrawn": "0",
    "num_claims": "20",
    "patent_date": "2024-03-12",
    "patent_type": "utility",
    "patent_title": "Example patent title",
    "patent_abstract": "Example abstract text."
  },
  "assignees": [],
  "inventors": [],
  "attribution": [],
  "cpc_current": [],
  "citation_count": 0
}

TRY ITLIVE · 100 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Retrieves details for a US patent identified by patent_id and returns a JSON object containing the patent core record plus related arrays such as assignees, inventors, attributions, and current CPC classifications.

Path Parameter(s)

Attribute	Type	Mandatory	Description
patent_id	String	Yes	Patent Id string.

Response

Returns a JSON object with patent object, assignees array, inventors array, attribution array, cpc_current array, and citation_count integer fields.

Attribute	Type	Mandatory	Description
patent	Object	Yes	Core grant record returned inside the patent detail envelope, containing `patent_id`, `wipo_kind`, `withdrawn`, `num_claims`, `patent_date` (date string), `patent_type`, `patent_title`, and `patent_abstract`.
assignees	Object Array	Yes	Array of assignee records. Each item may include `assignee_id` (UUID string), `location_id` (UUID string), `assignee_type`, `assignee_sequence`, `disambig_assignee_organization`, `disambig_assignee_individual_name_last`, and `disambig_assignee_individual_name_first`.
inventors	Object Array	Yes	Array of inventor records. Each item may include `gender_code` (nullable string), `inventor_id`, `location_id` (UUID string), `inventor_sequence`, `disambig_inventor_name_last`, and `disambig_inventor_name_first`.
attribution	Object Array	Yes	Array of attribution records. Each item may include `url` (URI string), `notice`, `source`, `dataset`, and `license`.
cpc_current	Object Array	Yes	Array of current CPC classification records. Each item may include `cpc_type`, `cpc_class`, `cpc_group`, `cpc_section`, `cpc_sequence`, and `cpc_subclass`.
citation_count	Integer	Yes	Number of citations recorded in the response.

Path parameters

Name

Type

Description

patent_idREQUIRED

string

—

▣ ENDPOINT 04 / 12

GET

Get US Patent Assignees

https://api.eu.apyhub.com/dosvak/search-uspto-patents/api/v1/uspto/patents/:patent_id/assignees

QUICKSTART

GUIDE

Quickstart

Fetch the assignee metadata for a specific patent by passing its patent_id in the path.

curl -X GET "https://api.eu.apyhub.com/dosvak/search-uspto-patents/api/v1/uspto/patents/:patent_id/assignees" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with these top-level fields: count as an integer, results as an array of assignee objects, patent_id as a string, and attribution as an array of attribution objects.

{
  "count": 1,
  "results": [
    {
      "assignee_id": "550e8400-e29b-41d4-a716-446655440000",
      "location_id": "550e8400-e29b-41d4-a716-446655440001",
      "assignee_type": "2",
      "assignee_sequence": "0",
      "disambig_assignee_organization": "Acme Technologies Inc.",
      "disambig_assignee_individual_name_last": "Smith",
      "disambig_assignee_individual_name_first": "Jane"
    }
  ],
  "patent_id": "12508435",
  "attribution": [
    {
      "url": "https://www.uspto.gov/",
      "notice": "Data provided by the USPTO",
      "source": "USPTO",
      "dataset": "Patent data",
      "license": "Public domain"
    }
  ]
}

TRY ITLIVE · 100 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Returns the assignees associated with a US patent identified by patent_id. The response includes the patent identifier, a total count, a results array of assignee records, and an attribution array.

Path Parameter(s)

Attribute	Type	Mandatory	Description
patent_id	String	Yes	Patent Id. String identifier for the patent.

Response

Returns a JSON object with count integer, results array, patent_id string, and attribution array fields. The response shape is PatentAssigneesResponse.

Attribute	Type	Mandatory	Description
count	Integer	No	Total number of assignees returned.
results	Object Array	No	Array of assignee objects. Each item may include `assignee_id` (UUID string), `location_id` (UUID string), `assignee_type` (string), `assignee_sequence` (string), `disambig_assignee_organization` (string), `disambig_assignee_individual_name_last` (string), and `disambig_assignee_individual_name_first` (string).
patent_id	String	No	Patent identifier associated with the returned assignees.
attribution	Object Array	No	Array of attribution objects. Each item may include `url` (URI string), `notice` (string), `source` (string), `dataset` (string), and `license` (string).

Path parameters

Name

Type

Description

patent_idREQUIRED

string

—

▣ ENDPOINT 05 / 12

GET

Get US Patent Inventors

https://api.eu.apyhub.com/dosvak/search-uspto-patents/api/v1/uspto/patents/:patent_id/inventors

QUICKSTART

GUIDE

Quickstart

Fetch the inventors for a patent by putting the patent ID in the path.

curl -X GET "https://api.eu.apyhub.com/dosvak/search-uspto-patents/api/v1/uspto/patents/:patent_id/inventors" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with count as an integer, results as an array of inventor objects, patent_id as a string, and attribution as an array of attribution objects.

{
  "count": 2,
  "results": [
    {
      "gender_code": "M",
      "inventor_id": "123456",
      "location_id": "550e8400-e29b-41d4-a716-446655440000",
      "inventor_sequence": "0",
      "disambig_inventor_name_last": "Smith",
      "disambig_inventor_name_first": "John"
    }
  ],
  "patent_id": "12508435",
  "attribution": [
    {
      "url": "https://example.com",
      "notice": "Data provided by ...",
      "source": "USPTO",
      "dataset": "Patents",
      "license": "Public Domain"
    }
  ]
}

TRY ITLIVE · 100 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Returns inventor metadata for a US patent identified by patent_id. The response includes the patent identifier, a count of inventor records, the inventor list, and attribution information.

Path Parameter(s)

Attribute	Type	Mandatory	Description
patent_id	String	Yes	Patent Id, format: string.

Response

Returns a JSON object with count as an integer, results as an array of inventor objects, patent_id as a string, and attribution as an array of attribution objects.

Parameter	Type	Mandatory	Description
count	Integer	No	Number of inventor records returned.
results	Object Array	No	Inventor records. Each item includes:<br>- `gender_code`: string, nullable; examples include `M` and `F`<br>- `inventor_id`: string<br>- `location_id`: string, format: UUID<br>- `inventor_sequence`: string; example: `0`<br>- `disambig_inventor_name_last`: string<br>- `disambig_inventor_name_first`: string
patent_id	String	No	Patent identifier.
attribution	Object Array	No	Attribution records. Each item includes:<br>- `url`: string, format: URI<br>- `notice`: string<br>- `source`: string<br>- `dataset`: string<br>- `license`: string

Path parameters

Name

Type

Description

patent_idREQUIRED

string

—

▣ ENDPOINT 06 / 12

GET

Get US Patent Classifications

https://api.eu.apyhub.com/dosvak/search-uspto-patents/api/v1/uspto/patents/:patent_id/classifications

QUICKSTART

GUIDE

Quickstart

Fetch the patent classifications for a single patent ID by putting the required patent_id in the path.

curl -X GET "https://api.eu.apyhub.com/dosvak/search-uspto-patents/api/v1/uspto/patents/:patent_id/classifications" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with count as an integer, results as an array of classification objects, patent_id as a string, and attribution as an array of attribution objects.

{
  "count": 1,
  "results": [
    {
      "cpc_type": "inventional",
      "cpc_class": "02",
      "cpc_group": "50/10",
      "cpc_section": "H",
      "cpc_sequence": "0",
      "cpc_subclass": "J"
    }
  ],
  "patent_id": "12508435",
  "attribution": [
    {
      "url": "https://example.com",
      "notice": "Example attribution notice",
      "source": "USPTO",
      "dataset": "Patent classifications",
      "license": "CC-BY"
    }
  ]
}

TRY ITLIVE · 100 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Returns the US patent classification metadata for a given patent ID. The request identifies the patent in the path, and the response returns a JSON object containing the patent ID, a count, a list of CPC classification records, and attribution entries.

Path Parameter(s)

Attribute	Type	Mandatory	Description
patent_id	String	Yes	Patent Id.

Response

Returns a JSON object with count as an integer, results as an array of CPC classification objects, patent_id as a string, and attribution as an array of attribution objects.

Attribute	Type	Mandatory	Description
count	Integer	No	Number of classification records returned.
results	Object Array	No	Array of CPC classification objects. Each item may include `cpc_type`, `cpc_class`, `cpc_group`, `cpc_section`, `cpc_sequence`, and `cpc_subclass` as strings.
patent_id	String	No	Patent identifier returned in the response.
attribution	Object Array	No	Array of attribution objects. Each item may include `url` (URI), `notice`, `source`, `dataset`, and `license` as strings.

Path parameters

Name

Type

Description

patent_idREQUIRED

string

—

▣ ENDPOINT 07 / 12

GET

Get US Patent Citations

https://api.eu.apyhub.com/dosvak/search-uspto-patents/api/v1/uspto/patents/:patent_id/citations

QUICKSTART

GUIDE

Quickstart

Fetch citation metadata for a patent ID, using the required patent ID in the URL and the default backward direction.

curl -X GET "https://api.eu.apyhub.com/dosvak/search-uspto-patents/api/v1/uspto/patents/:patent_id/citations" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with count as an integer, results as an array of citation objects, direction and patent_id as strings, and attribution as an array of attribution objects.

Each citation in results may include patent_id, wipo_kind, record_name, citation_date, citation_category, citation_sequence, and citation_patent_id.

{
  "count": 0,
  "results": [],
  "direction": "backward",
  "patent_id": "12508435",
  "attribution": []
}

TRY ITLIVE · 100 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Retrieves US patent citation metadata for the specified patent ID. You can limit the number of citations returned and choose whether to retrieve backward or forward citations.

Path Parameter(s)

Attribute	Type	Mandatory	Description
patent_id	String	Yes	Patent ID identifying the US patent.

Query Parameter(s)

Attribute	Type	Mandatory	Description
limit	Integer	No	Maximum number of citations to return. Default: `200`; minimum: `1`; maximum: `5000`.
direction	String	No	Citation direction. Allowed values: `backward`, `forward`. Default: `backward`.

Response

Returns a JSON object with count as an integer, results as an array of citation objects, direction as a string, patent_id as a string, and attribution as an array of attribution objects. The response is the successful result for the GET /citations endpoint.

Parameter	Type	Mandatory	Description
count	Integer	No	Total number of citations in the response.
results	Object Array	No	Array of citation records. Each item includes the citation fields defined in the schema.
direction	String	No	Citation direction returned by the API. Allowed values: `backward`, `forward`.
patent_id	String	No	Patent ID for the citation lookup.
attribution	Object Array	No	Array of attribution objects containing source and licensing metadata.

Path parameters

Name

Type

Description

patent_idREQUIRED

string

—

Query parameters

Name

Type

Description

limitOPTIONAL

integer

—

DEFAULT 200

directionOPTIONAL

string

—

DEFAULT backward

▣ ENDPOINT 08 / 12

GET

Search US Patent Text

https://api.eu.apyhub.com/dosvak/search-uspto-patents/api/v1/uspto/patent-text/search

QUICKSTART

GUIDE

Quickstart

Search US patent text with the required query parameter.

curl -X GET "https://api.eu.apyhub.com/dosvak/search-uspto-patents/api/v1/uspto/patent-text/search?query=lithium%20battery%20thermal%20management" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with these top-level fields: count and num_found are integers, query is the search string, year_from and year_to are nullable integers, section_type is a nullable string, results is an array of patent section objects, and attribution is an array of attribution objects.

Each item in results includes id, patent_id, text_len_i, source_file, and section_type, plus optional score and section_seq.

{
  "count": 1,
  "query": "lithium battery thermal management",
  "results": [
    {
      "id": "US1234567|summary_text|1",
      "score": 12.34,
      "patent_id": "US1234567",
      "text_len_i": 842,
      "section_seq": 1,
      "source_file": "us_patents.json",
      "section_type": "summary_text"
    }
  ],
  "year_to": null,
  "num_found": 1,
  "year_from": null,
  "attribution": [],
  "section_type": null
}

TRY ITLIVE · 100 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Searches US patent text using the provided query and optional filters, then returns a JSON object containing the match count, the echoed search parameters, and a list of matching patent text sections.

Query Parameter(s)

Attribute	Type	Mandatory	Description
limit	Integer	No	Maximum number of results to return. Default: `20`. Minimum: `1`. Maximum: `200`.
query	String	Yes	Search query string. Minimum length: `2`.
year_to	String	No	Optional upper year filter. Accepts an integer value from `1976` to `2100`, or `null`.
year_from	String	No	Optional lower year filter. Accepts an integer value from `1976` to `2100`, or `null`.
section_type	String	No	Optional section type filter. Can be `null` or a string value.

Response

Returns a JSON object with count integer, query string, results array, year_to integer or null, num_found integer, year_from integer or null, attribution array, and section_type string or null fields.

Attribute	Type	Mandatory	Description
count	Integer	No	Number of results returned in `results`.
query	String	No	The search query echoed back in the response.
results	Object Array	No	Array of patent text section objects. Each item includes:<br>- `id` (String): Composite id in the form `patent_id\|section_type\|section_seq`.<br>- `score` (Number): Solr relevance score. Present only on search results, not on by-id lookups; nullable.<br>- `patent_id` (String)<br>- `text_len_i` (Integer): Character length of the indexed text.<br>- `section_seq` (Integer): Absent/null for single-instance sections such as `summary_text`; nullable.<br>- `source_file` (String)<br>- `section_type` (String): Examples include `claim_text`, `claim_number`, `claim_sequence`, `summary_text`, `draw_desc_text`.
year_to	Integer	No	Upper year filter echoed back in the response; nullable.
num_found	Integer	No	Total Solr matches before limit truncation.
year_from	Integer	No	Lower year filter echoed back in the response; nullable.
attribution	Object Array	No	Attribution metadata objects. Each item includes:<br>- `url` (String): URI.<br>- `notice` (String)<br>- `source` (String)<br>- `dataset` (String)<br>- `license` (String)
section_type	String	No	Section type filter echoed back in the response; nullable.

Query parameters

Name

Type

Description

limitOPTIONAL

integer

—

DEFAULT 20

queryREQUIRED

string

—

year_toOPTIONAL

string

—

year_fromOPTIONAL

string

—

section_typeOPTIONAL

string

—

▣ ENDPOINT 09 / 12

GET

Get US Patent Text Sections

https://api.eu.apyhub.com/dosvak/search-uspto-patents/api/v1/uspto/patent-text/:patent_id

QUICKSTART

GUIDE

Quickstart

Fetch patent text sections for a specific patent ID. patent_id goes in the path, and the optional filters are passed as query parameters.

curl -X GET "https://api.eu.apyhub.com/dosvak/search-uspto-patents/api/v1/uspto/patent-text/:patent_id" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with count and num_found integer fields, a results array of patent section objects, and top-level patent_id, section_type, and attribution fields.

Each item in results includes id, patent_id, text_len_i, source_file, and section_type, with optional score and section_seq fields.

{
  "count": 1,
  "results": [
    {
      "id": "12508435|g_claims_text|1",
      "patent_id": "12508435",
      "text_len_i": 1240,
      "section_seq": 1,
      "source_file": "patent_12508435.pdf",
      "section_type": "g_claims_text"
    }
  ],
  "num_found": 1,
  "patent_id": "12508435",
  "attribution": [],
  "section_type": "g_claims_text"
}

TRY ITLIVE · 100 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Retrieves US patent text section details for a given patent_id. You can optionally narrow the returned sections by section_type and cap the number of results with limit.

Path Parameter(s)

Attribute	Type	Mandatory	Description
patent_id	String	Yes	Patent Id. Example: `12508435`.

Query Parameter(s)

Attribute	Type	Mandatory	Description
limit	Integer	No	Maximum number of results to return. Default: `200`; minimum: `1`; maximum: `5000`.
section_type	String	No	Section type to filter by. Can be omitted or set to a string value. Example: `g_claims_text`.

Response

Returns a JSON object with count and num_found integer fields, results as an array of patent text section objects, patent_id as a string, attribution as an array of attribution objects, and section_type as a nullable string. This is the documented success shape for the response body.

Parameter	Type	Mandatory	Description
count	Integer	No	Number of items returned in `results`.
results	Object Array	No	Array of patent text section objects. Each item may contain: `id` (string, composite id: `patent_id
num_found	Integer	No	Number of matching records found.
patent_id	String	No	Patent identifier for the returned data.
attribution	Object Array	No	Array of attribution objects. Each item may contain: `url` (string, URI format), `notice` (string), `source` (string), `dataset` (string), and `license` (string).
section_type	String	No	Returned section type filter, or null when not set.

Path parameters

Name

Type

Description

patent_idREQUIRED

string

—

Query parameters

Name

Type

Description

limitOPTIONAL

integer

—

DEFAULT 200

section_typeOPTIONAL

string

—

▣ ENDPOINT 10 / 12

GET

Get US Patent Yearly Trends

https://api.eu.apyhub.com/dosvak/search-uspto-patents/api/v1/uspto/patents/analytics/yearly-trend

QUICKSTART

GUIDE

Quickstart

Fetch the yearly patent trend for a date range using the required query parameters.

curl -X GET "https://api.eu.apyhub.com/dosvak/search-uspto-patents/api/v1/uspto/patents/analytics/yearly-trend?year_from=2015&year_to=2025" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with count as an integer, results as an array of yearly trend objects, year_to and year_from as integers, and attribution as an array of attribution objects.

{
  "count": 2,
  "results": [
    {
      "patents": 120,
      "grant_year": 2024,
      "avg_num_claims": "14.5"
    }
  ],
  "year_to": 2025,
  "year_from": 2015,
  "attribution": [
    {
      "url": "https://example.com",
      "notice": "Data provided for analytics",
      "source": "Patent dataset",
      "dataset": "yearly-trend",
      "license": "CC BY 4.0"
    }
  ]
}

TRY ITLIVE · 100 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Returns yearly US patent trend analytics for the requested year range. You can control the range with year_from and year_to, and the response includes the aggregated counts and per-year trend results for that span.

Query Parameter(s)

Attribute	Type	Mandatory	Description
year_to	Integer	No	Upper bound for the year range. Default: `2025`. Minimum: `1976`. Maximum: `2100`.
year_from	Integer	No	Lower bound for the year range. Default: `2015`. Minimum: `1976`. Maximum: `2100`.

Response

Returns a JSON object with count as an integer, results as an array of objects, year_to and year_from as integers, and attribution as an array of objects. Use count for the total number of trend records, and read each item in results for the yearly patent metrics.

Parameter	Type	Mandatory	Description
count	Integer	Yes	Total number of trend records in `results`.
results	Object Array	Yes	Array of yearly trend objects. Each item includes `patents` (integer), `grant_year` (integer), and `avg_num_claims` (string decimal).
results[].patents	Integer	Yes	Number of patents for the grant year.
results[].grant_year	Integer	Yes	Grant year for the trend item.
results[].avg_num_claims	String	Yes	Average number of claims for the year, returned as a decimal string.
year_to	Integer	Yes	Upper year bound reflected in the response.
year_from	Integer	Yes	Lower year bound reflected in the response.
attribution	Object Array	Yes	Array of attribution objects. Each item may include `url` (URI string), `notice` (string), `source` (string), `dataset` (string), and `license` (string).
attribution[].url	String	Yes	Attribution URL in URI format.
attribution[].notice	String	Yes	Attribution notice text.
attribution[].source	String	Yes	Source name.
attribution[].dataset	String	Yes	Dataset name.
attribution[].license	String	Yes	License text.

Query parameters

Name

Type

Description

year_toOPTIONAL

integer

—

DEFAULT 2025

year_fromOPTIONAL

integer

—

DEFAULT 2015

▣ ENDPOINT 11 / 12

GET

Get US Patent CPC Breakdown

https://api.eu.apyhub.com/dosvak/search-uspto-patents/api/v1/uspto/patents/analytics/cpc-breakdown

QUICKSTART

GUIDE

Quickstart

Get a CPC breakdown with the default limit.

curl -X GET "https://api.eu.apyhub.com/dosvak/search-uspto-patents/api/v1/uspto/patents/analytics/cpc-breakdown?limit=50" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with count as an integer, results as an array of CPC breakdown objects, and attribution as an array of attribution objects.

{
  "count": 0,
  "results": [
    {
      "patents": 0,
      "cpc_class": "string",
      "cpc_section": "string",
      "cpc_subclass": "string"
    }
  ],
  "attribution": [
    {
      "url": "https://example.com",
      "notice": "string",
      "source": "string",
      "dataset": "string",
      "license": "string"
    }
  ]
}

TRY ITLIVE · 100 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Returns a CPC breakdown for US patents as a JSON object containing a total count, a results array of CPC breakdown objects, and an attribution array.

Query Parameter(s)

Attribute	Type	Mandatory	Description
limit	Integer	No	Maximum number of results to return. Default: 50. Minimum: 1. Maximum: 500.

Response

Returns a JSON object with count as an integer, results as an array of objects, and attribution as an array of attribution objects. Success returns 200.

Attribute	Type	Mandatory	Description
count	Integer	Yes	Total number of results available.
results	Object Array	Yes	Array of CPC breakdown objects. Each item includes `patents` (integer), `cpc_class` (string), `cpc_section` (string), and `cpc_subclass` (string).
results[].patents	Integer	Yes	Number of patents in the CPC grouping.
results[].cpc_class	String	Yes	CPC class value.
results[].cpc_section	String	Yes	CPC section value.
results[].cpc_subclass	String	Yes	CPC subclass value.
attribution	Object Array	Yes	Array of attribution objects.
attribution[].url	String	Yes	Attribution URL. Format: URI.
attribution[].notice	String	Yes	Attribution notice text.
attribution[].source	String	Yes	Source name.
attribution[].dataset	String	Yes	Dataset name.
attribution[].license	String	Yes	License name.

Query parameters

Name

Type

Description

limitOPTIONAL

integer

—

DEFAULT 50

▣ ENDPOINT 12 / 12

GET

Get US Patent Section Breakdown

https://api.eu.apyhub.com/dosvak/search-uspto-patents/api/v1/uspto/patent-text/analytics/section-breakdown

QUICKSTART

GUIDE

Quickstart

Fetch the patent text section breakdown with the default limit.

curl -X GET "https://api.eu.apyhub.com/dosvak/search-uspto-patents/api/v1/uspto/patent-text/analytics/section-breakdown?limit=20" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with count as an integer, results as an array of objects, and attribution as an array of attribution objects.

{
  "count": 0,
  "results": [
    {
      "docs": 0,
      "section_type": "string"
    }
  ],
  "attribution": [
    {
      "url": "https://example.com",
      "notice": "string",
      "source": "string",
      "dataset": "string",
      "license": "string"
    }
  ]
}

TRY ITLIVE · 100 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Returns a breakdown of US patent text analytics by section type. The response is a JSON object containing the total count, a results array of section breakdown records, and an attribution array.

Query Parameter(s)

Attribute	Type	Mandatory	Description
limit	Integer	No	Maximum number of results to return. Default: `20`; minimum: `1`; maximum: `100`.

Response

Returns a JSON object with count as an integer, results as an array of breakdown objects, and attribution as an array of attribution objects.

Attribute	Type	Mandatory	Description
count	Integer	Yes	Total number of results available.
results	Object Array	Yes	Array of section breakdown objects. Each item includes `docs` and `section_type`.
results[].docs	Integer	Yes	Number of documents for the section type.
results[].section_type	String	Yes	Section type identifier.
attribution	Object Array	Yes	Array of attribution records. Each item includes `url`, `notice`, `source`, `dataset`, and `license`.
attribution[].url	String	Yes	Attribution URL in URI format.
attribution[].notice	String	Yes	Attribution notice text.
attribution[].source	String	Yes	Source name.
attribution[].dataset	String	Yes	Dataset name.
attribution[].license	String	Yes	License text.

Query parameters

Name

Type

Description

limitOPTIONAL

integer

—

DEFAULT 20

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.