▣ DATA EXTRACTION

US Patent & Trademark Assignments API

What it does

US IP Search & Ownership Transfer covers the parts of USPTO data that span both patents and trademarks: cross-domain search, ingestion readiness, and patent ownership-transfer history.

/search/unified runs a single query across all three underlying datasets at once — patent metadata, full-text patent sections, and trademark records — and returns a blended, ranked result set. Each hit includes an entity_type (patent_text, patent_metadata, or trademark) and a payload shaped to match, plus a components object breaking down how many results came from each source. Use this when you don't yet know whether what you're looking for is a patent or a trademark, or when you want one search box to cover both.

/assignments/status is a lightweight, read-only readiness check for assignment data: it reports whether the patent_assignments and trademark_assignments tables exist, current row counts, and references to the underlying raw archive files. It's useful for monitoring checks and ingestion guards before downstream jobs depend on assignment coverage being present.

/assignments/patent/search searches recorded patent assignment transfers by name, company, or patent/application identifier, with optional recorded-date filtering. Each result includes assignee_name, assignor_name, recorded_date, conveyance_text, and reel_frame — the patent-side counterpart to the trademark assignment search in the Trademark Intelligence API.

Use this API when your workflow genuinely spans both patent and trademark data — unified discovery tools, ingestion monitoring, or patent ownership diligence — rather than when you're working exclusively within one domain. All responses include attribution metadata for source and licensing tracking.

▣ ENDPOINT 01 / 03

GET

Search US Patent & Trademark Data

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

QUICKSTART

GUIDE

Quickstart

Search USPTO patent and trademark data with a simple query.

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

What you'll get back

Returns a JSON object with these top-level fields: year (integer or null), count (integer), query (string), results (array of ranked hit objects), components (object with per-dataset counts), attribution (array of attribution objects), include_text (boolean), and jurisdiction (string or null).

{
  "year": 2024,
  "count": 1,
  "query": "wireless charging",
  "results": [],
  "components": {
    "trademark_count": 0,
    "patent_text_count": 1,
    "patent_metadata_count": 0,
    "patent_text_num_found": 1
  },
  "attribution": [],
  "include_text": true,
  "jurisdiction": 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 and trademark data using a text query and returns a ranked list of matching records. You can optionally filter by year, limit the number of results, request text inclusion, and constrain by jurisdiction.

Query Parameter(s)

Attribute	Type	Mandatory	Description
year	String	No	Optional year filter. Accepts an integer from 1976 to 2100 or `null`.
limit	Integer	No	Maximum number of results to return. Default: 25; minimum: 1; maximum: 200.
query	String	Yes	Search query text. Minimum length: 2 characters.
include_text	Boolean	No	Whether to include text in the search response. Default: `true`.
jurisdiction	String	No	Optional jurisdiction filter. Accepts a string with length 2 to 8 characters, or `null`.

Response

Returns a JSON object with year (integer or null), count (integer), query (string), results (array of objects), components (object), attribution (array of objects), include_text (boolean), and jurisdiction (string or null) fields. The results array contains ranked hits, and each item includes id (string), payload (object), rank_score (number), and entity_type (string).

Attribute	Type	Mandatory	Description
year	Integer	No	The requested year, or `null`.
count	Integer	Yes	Number of results returned.
query	String	Yes	The query used for the search.
results	Object Array	Yes	Ranked search hits. Each item includes:<br>`id` (string)<br>`payload` (object; additional properties allowed; shape depends on `entity_type`)<br>`rank_score` (number)<br>`entity_type` (string; examples include `patent_text`, `patent_metadata`, `trademark`)
components	Object	No	Counts broken down by result category. Contains:<br>`trademark_count` (integer)<br>`patent_text_count` (integer)<br>`patent_metadata_count` (integer)<br>`patent_text_num_found` (integer)
attribution	Object Array	No	Attribution entries. Each item includes:<br>`url` (string, URI format)<br>`notice` (string)<br>`source` (string)<br>`dataset` (string)<br>`license` (string)
include_text	Boolean	No	Echoes the `include_text` request value.
jurisdiction	String	No	Echoes the `jurisdiction` request value, or `null`.

Query parameters

Name

Type

Description

yearOPTIONAL

string

—

limitOPTIONAL

integer

—

DEFAULT 25

queryREQUIRED

string

—

include_textOPTIONAL

boolean

—

DEFAULT true

jurisdictionOPTIONAL

string

—

▣ ENDPOINT 02 / 03

GET

Get US Assignment Status

https://api.eu.apyhub.com/dosvak/unified-uspto-search/api/v1/uspto/assignments/status

QUICKSTART

GUIDE

Quickstart

This GET call checks the USPTO assignment status and returns the current status plus related tables and archive metadata.

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

What you'll get back

Returns a JSON object with these top-level fields: status is a string, tables is an object with patent_assignments and trademark_assignments sub-objects, attribution is an array of attribution objects, and raw_archives is an object listing archive file arrays.

{
  "status": "ready",
  "tables": {
    "patent_assignments": { "rows": 0, "exists": false },
    "trademark_assignments": { "rows": 0, "exists": false }
  },
  "attribution": [],
  "raw_archives": {
    "patent_assignment_files": [],
    "trademark_assignment_files": []
  }
}

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 the current US assignment status as a JSON object. The response includes a status string, a tables object with summary information for patent and trademark assignments, an attribution array, and a raw_archives object listing archive files.

Response

Returns a JSON object with status (string), tables (object), attribution (array), and raw_archives (object) fields. The response describes the assignment status and related dataset metadata; the schema does not define a separate success status code.

Parameter	Type	Mandatory	Description
status	String	No	Status string for the assignment status response. Example: `ready`.
tables	Object	No	Summary table metadata for assignment datasets. Contains `patent_assignments` and `trademark_assignments` objects, each with `rows` and `exists` fields.
tables.patent_assignments	Object	No	Patent assignment table summary. Contains `rows` and `exists`.
tables.patent_assignments.rows	Integer	No	Number of rows in the patent assignments table.
tables.patent_assignments.exists	Boolean	No	Whether the patent assignments table exists.
tables.trademark_assignments	Object	No	Trademark assignment table summary. Contains `rows` and `exists`.
tables.trademark_assignments.rows	Integer	No	Number of rows in the trademark assignments table.
tables.trademark_assignments.exists	Boolean	No	Whether the trademark assignments table exists.
attribution	Object Array	No	Attribution entries for the response data. Each item includes `url`, `notice`, `source`, `dataset`, and `license`.
attribution[].url	String	No	Attribution URL. Format: URI.
attribution[].notice	String	No	Attribution notice text.
attribution[].source	String	No	Source name.
attribution[].dataset	String	No	Dataset name.
attribution[].license	String	No	License text.
raw_archives	Object	No	Raw archive file references for patent and trademark assignments. Contains `patent_assignment_files` and `trademark_assignment_files`.
raw_archives.patent_assignment_files	String Array	No	List of patent assignment archive file paths or names.
raw_archives.trademark_assignment_files	String Array	No	List of trademark assignment archive file paths or names.

Parameters

No parameters.

▣ ENDPOINT 03 / 03

GET

Search US Patent Assignments

https://api.eu.apyhub.com/dosvak/unified-uspto-search/api/v1/uspto/assignments/patent/search

QUICKSTART

GUIDE

Quickstart

Search patent assignments for a company name like Tesla using the required query parameter.

curl -X GET "https://api.eu.apyhub.com/dosvak/unified-uspto-search/api/v1/uspto/assignments/patent/search?query=Tesla" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with count as an integer, query as a string, status as a string, results as an array of patent assignment records, end_date and start_date as date strings or null, and attribution as an array of attribution objects.

{
  "count": 1,
  "query": "Tesla",
  "status": "ok",
  "results": []
}

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 assignment records using a required query string, with optional date filters and a limit on the number of results returned. The response includes the search metadata plus an array of matching patent assignment records.

Query Parameter(s)

Attribute	Type	Mandatory	Description
limit	Integer	No	Maximum number of results to return. Default: 100. Minimum: 1, maximum: 1000.
query	String	Yes	Search term. Minimum length: 2. Example: `Tesla`.
end_date	String	No	End of the date range. Format: `YYYY-MM-DD` or `null`.
start_date	String	No	Start of the date range. Format: `YYYY-MM-DD` or `null`.

Response

Returns a JSON object with count integer, query string, status string, results array, end_date string-or-null, start_date string-or-null, and attribution array fields. The results array contains patent assignment record objects, and attribution contains attribution items.

Parameter	Type	Mandatory	Description
count	Integer	No	Number of matching records returned or available.
query	String	No	The query string used for the search.
status	String	No	Response status string. Example: `ok`.
results	Object Array	No	Array of patent assignment records. Each item can include `patent_id` (nullable string), `reel_frame` (string), `source_file` (string), `assignee_name` (string), `assignor_name` (string), `recorded_date` (date string), `application_id` (string), and `conveyance_text` (string).
end_date	String	No	End date included in the response, nullable. Format: `YYYY-MM-DD`.
start_date	String	No	Start date included in the response, nullable. Format: `YYYY-MM-DD`.
attribution	Object Array	No	Array of attribution items. Each item can include `url` (URI string), `notice` (string), `source` (string), `dataset` (string), and `license` (string).

Query parameters

Name

Type

Description

limitOPTIONAL

integer

—

DEFAULT 100

queryREQUIRED

string

—

end_dateOPTIONAL

string

—

start_dateOPTIONAL

string

—

▣ 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.