Patents Beta Endpoint
Note: The content on this page is outdated. Please see our Search API Reference Page at https://search.patentsview.org/docs/docs/Search%20API/SearchAPIReference/.
GET /api/v1/patent/
POST /api/v1/patent/
GET /api/v1/patent/{patent_id}/
This will search for patents 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.
Requests using the lookup endpoint must include a single patent number and will use the default f, s, and o options.
A request may be submitted with an empty query string. This will return all records.
Name | Description | Defaults | Details |
|---|---|---|---|
q | JSON formatted object containing the query parameters. See below for details on formatting this object. | string, required | |
f | JSON formatted array of fields to include in the results. | If not provided, defaults to "patent_id", "patent_title", "patent_date" | string, optional |
s | JSON formatted array of objects to sort the results. | If not provided, defaults to {"patent_id":"asc"} | string, optional |
o | JSON formatted object of options to modify the results. Use these to page through results. Available options are: | Size: Defaults to 100. After: Defaults to none. | string, optional |
An example of a complete API call using the GET verb is:
api/v1/patent/?q={"patent_id":"10757852"}&f=["patent_title", "patent_date", "patent_country"]
An example of the equivalent API call using the POST verb is:
https://search.patentsview.org/api/v1/patent/
with the body containing:
{"q":{"patent_id":"10757852"}, "f": ["patent_title", "patent_date", "patent_country"]}
An example of an API call using the lookup endpoint is:
https://search.patentsview.org/api/v1/patent/10757852/
Examples
Return the patent number and patent title of all patents granted in 2020.
api/v1/patent/?q={"patent_year":"2020"}&f=["patent_id","patent_title"]
Return all patent numbers and titles after 2006 where the inventor's last name was "Jobs" and the assignee was based in the US.
Return the patent number, processing time, and patent kind for patents granted after 2001 that have the word "international" in the abstract and have a foreign company or corporation assignee.
Return location information at grant for all inventors mentioned on a given patent.
Patent Field List
"patents": [
{
"applicants": [
{
"applicant_designation": "keyword",
"applicant_name_first": "text",
"applicant_name_last": "text",
"applicant_organization": "text",
"applicant_sequence": 1,
"applicant_type": "keyword",
"location_id": "keyword"
}
],
"application": [
{
"application_id": "keyword",
"application_type": "keyword",
"filing_date": "1976-01-06",
"filing_type": "keyword",
"rule_47_flag": true,
"series_code": "keyword"
}
],
"assignees": [
{
"assignee_city": "text",
"assignee_country": "text",
"assignee_id": "keyword",
"assignee_individual_name_first": "text",
"assignee_individual_name_last": "text",
"assignee_location_id": "keyword",
"assignee_organization": "text",
"assignee_sequence": 1,
"assignee_state": "text",
"assignee_type": "keyword"
}
],
"attorneys": [
{
"attorney_id": "keyword",
"attorney_name_first": "text",
"attorney_name_last": "text",
"attorney_organization": "text",
"attorney_sequence": 1
}
],
"botanic": [
{
"latin_name": "keyword",
"variety": "keyword"
}
],
"cpc_at_issue": [
{
"cpc_class": "keyword",
"cpc_class_id": "keyword",
"cpc_group": "keyword",
"cpc_group_id": "keyword",
"cpc_section": "keyword",
"cpc_sequence": 1,
"cpc_subclass": "keyword",
"cpc_subclass_id": "keyword",
"cpc_type": "keyword"
}
],
"cpc_current": [
{
"cpc_class": "keyword",
"cpc_class_id": "keyword",
"cpc_group": "keyword",
"cpc_group_id": "keyword",
"cpc_section": "keyword",
"cpc_sequence": 1,
"cpc_subclass": "keyword",
"cpc_subclass_id": "keyword",
"cpc_type": "keyword"
}
],
"examiners": [
{
"art_group": "keyword",
"examiner_first_name": "text",
"examiner_id": "keyword",
"examiner_last_name": "text",
"examiner_role": "keyword"
}
],
"figures": [
{
"num_figures": 1,
"num_sheets": 1
}
],
"foreign_priority": [
{
"filing_date": "1976-01-06",
"foreign_application_id": "keyword",
"foreign_country_filed": "keyword",
"priority_claim_kind": "keyword",
"priority_claim_sequence": 1
}
],
"gov_interest_contract_award_numbers": [
{
"award_number": "keyword"
}
],
"gov_interest_organizations": [
{
"fedagency_name": "text",
"level_one": "text",
"level_three": "text",
"level_two": "text"
}
],
"gov_interest_statement": "text",
"granted_pregrant_crosswalk": [
{
"application_number": "keyword",
"document_number": 1
}
],
"inventors": [
{
"inventor_city": "text",
"inventor_country": "text",
"inventor_id": "keyword",
"inventor_location_id": "keyword",
"inventor_name_first": "text",
"inventor_name_last": "text",
"inventor_sequence": 1,
"inventor_state": "text"
}
],
"ipcr": [
{
"ipc_action_date": "1976-01-06",
"ipc_class": "keyword",
"ipc_classification_data_source": "keyword",
"ipc_classification_value": "keyword",
"ipc_id": "keyword",
"ipc_main_group": "keyword",
"ipc_section": "keyword",
"ipc_sequence": 1,
"ipc_subclass": "keyword",
"ipc_subgroup": "keyword",
"ipc_symbol_position": "keyword"
}
],
"patent_abstract": "text",
"patent_cpc_current_group_average_patent_processing_days": 1,
"patent_date": "1976-01-06",
"patent_detail_desc_length": 1,
"patent_earliest_application_date": "1976-01-06",
"patent_id": "keyword",
"patent_num_foreign_documents_cited": 1,
"patent_num_times_cited_by_us_patents": 1,
"patent_num_total_documents_cited": 1,
"patent_num_us_applications_cited": 1,
"patent_num_us_patents_cited": 1,
"patent_processing_days": 1,
"patent_term_extension": 1,
"patent_title": "text",
"patent_type": "keyword",
"patent_uspc_current_mainclass_average_patent_processing_days": 1,
"patent_year": 1,
"pct_data": [
{
"application_kind": "keyword",
"pct_102_date": "1976-01-06",
"pct_371_date": "1976-01-06",
"pct_doc_number": "keyword",
"pct_doc_type": "keyword",
"published_filed_date": "1976-01-06"
}
],
"us_related_documents": [
{
"published_country": "keyword",
"related_doc_kind": "keyword",
"related_doc_number": "keyword",
"related_doc_published_date": "1976-01-06",
"related_doc_sequence": 1,
"related_doc_status": "keyword",
"related_doc_type": "keyword",
"wipo_kind": "keyword"
}
],
"us_term_of_grant": [
{
"disclaimer_date": "1976-01-06",
"term_disclaimer": "keyword",
"term_extension": "keyword",
"term_grant": "keyword"
}
],
"uspc_at_issue": [
{
"uspc_mainclass": "keyword",
"uspc_mainclass_id": "keyword",
"uspc_sequence": 1,
"uspc_subclass": "keyword",
"uspc_subclass_id": "keyword"
}
],
"wipo": [
{
"wipo_field": "keyword",
"wipo_field_id": "keyword",
"wipo_sequence": 1
}
],
"wipo_kind": "keyword"
}
]
}