Inventors Beta Endpoint
GET /api/v1/inventor/
POST /api/v1/inventor/
This will search for inventors matching the query string (q) and returning the data fields listed in the field string (f) sorted by the fields in the sort string (s) using options provided in the option string (o).
Either the HTTP GET, or POST method can be used; however, when the query parameters exceed a reasonable size (around 2,000 characters), then the POST method may be preferable. When using the POST method, the query parameters should be embedded within a JSON string within the request body.
| Name | Description | Defaults | Details |
|---|---|---|---|
| q | JSON formatted object containing the query parameters. See below for details on formatting this object. | string, required example: {"inventor_id":"2335918"} |
|
| f | JSON formatted array of fields to include in the results. | If not provided, defaults to inventor_id, name_first, name_last | string, optional example: ["inventor_id", "lastknown_city", "lastknown_state", "lastknown_country"] |
| s | JSON formatted array of objects to sort the results. | If not provided, defaults to {"inventor_id":"asc"} | string, optional example: [{"name_last": "desc"}] |
| o |
JSON formatted object of options to modify the results. Use these to page through results. Available options are: |
Size: Defaults to 100. Offset: Defaults to 0. |
string, optional example: {"size": 100, "offset": 0} |
An example of a complete API call using the GET verb is:
https://search.patentsview.org/api/v1/inventor/?q={"name_last":"Young"}&f=["inventor_id","name_last","name_first"]
An example of the equivalent API call using the POST verb is:
https://search.patentsview.org/api/v1/inventor/
with the body containing:
{"q": {"name_last":"Young"},"f": ["inventor_id","name_last","name_first"],"o": {},"s": []}
Examples
Return all inventors who were active for more than 10 years. Show number of patents and sort by years active.
https://search.patentsview.org/api/v1/inventor/?q={"_gte":{"years_active":10}}&f=["inventor_id","name_last","name_first","num_patents","years_active"]&s=[{"years_active":"desc"}]
Return the name and location of all international inventors.
https://search.patentsview.org/api/v1/inventor/?q={"_neq":{"lastknown_country":"US"}}&f=["inventor_id", "name_last", "name_first", "lastknown_city", "lastknown_country"]
Inventor Field List
The endpoint's field list can be viewed at the bottom of the webpage on the API's Swagger interface.