NBER Endpoint

GET /api/nber_subcategories/query?q{,f,o,s}
POST /api/nber_subcategories/query

This will search for NBER (National Bureau of Economic Research) subcategories 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).

The HTTP GET request method is the preferred access mechanism; however when the query parameters exceed a reasonable size (around 2,000 characters), then the POST method can be used. When using the POST method, the query parameters should be embedded within a JSON string within the request body.

Name Description Details
q JSON formatted object containing the query parameters. See below for details on formatting this object. string, required
example: {"nber_subcategory_id":"62"}
f JSON formatted array of fields to include in the results. If not provided, defaults to nber_subcategory_id and nber_subcategory_title . string, optional
example: ["nber_subcategory_id", "nber_subcategory_title","nber_total_num_patents"]
s JSON formatted array of objects to sort the results. If not provided, defaults to nber_subcategory_id . string, optional
example: [{"nber_total_num_patents":"desc"}]
o

JSON formatted object of options to modify the query or results. Available options are:

matched_subentities_only — Only subentity data that matches the subentity specific criteria is included in results. Defaults to true.

include_subentity_total_counts — Total counts of unique subentities included in results. Defaults to false.

page — return only the Nth page of results. Defaults to 1.

per_page — Size of each page of results. Defaults to 25.

string, optional
example: o={"matched_subentities_only": "true", "page": 2, "per_page": 50, "include_subentity_total_counts": "false"}
format

Specifies the response data format. If not provided, defaults to JSON. Available options are:

json

xml

string, optional
example: format=xml

An example of a complete API call using the GET verb is:

http://www.patentsview.org/api/nber_subcategories/query?q={"nber_subcategory_id":"62"}&f=["nber_subcategory_id","nber_subcategory_title","nber_total_num_patents"]

An example of the equivalent API call using the POST verb is:

http://www.patentsview.org/api/nber_subcategories/query

with the body containing:

{"q":{"nber_subcategory_id":"62"},"f":["nber_subcategory_id", "nber_subcategory_title","nber_total_num_patents"]}

Examples

NBER Subcategory Field List

API Field Name Group Common Name Type Query Description
app_country applications Country string Y Country in which patent application was filed, always U.S.
app_date applications Filing Date date Y Date the patent application was filed (filing date)
app_number applications Number string Y Application ID assigned by USPTO
app_type applications Type string Y Patent Application Type (From XML data dictionary). 02 through 28 = Utility application; 29, D = Design application; 60 = Provisional application; 90 = Reexamination request
assignee_city assignees City string Y Assignee's city as listed on the patent
assignee_country assignees Country string Y Assignee's country as listed on the patent
assignee_first_name assignees First Name string Y First name, if assignee is individual
assignee_first_seen_date assignees First Seen Date date Y Earliest patent grant date for all of an asisgnee's patents in the database
assignee_id* assignees ID string Y Unique database assignee ID assigned by disambiguation algorithm
assignee_last_name assignees Last Name string Y Last name, if assignee is individual
assignee_last_seen_date assignees Last Seen Date date Y Most recent patent grant date for all of the asisgnee's patents in the database
assignee_lastknown_city assignees Last Known City string Y Assignee's country as of their most recent patent grant date (equivalently, as of assignee_last_seen_date)
assignee_lastknown_country assignees Last Known Country string Y Assignee's city as of their most recent patent grant date (equivalently, as of assignee_last_seen_date)
assignee_lastknown_latitude assignees Last Known Latitude float N Latitude for assignee's location as of their most recent patent grant date (equivalently, as of assignee_last_seen_date)
assignee_lastknown_location_id assignees Last Known Location ID string Y Unique database ID for the assignee's location on their most recent patent grant date (equivalently, as of assignee_last_seen_date)
assignee_lastknown_longitude assignees Last Known Longitude float N Longitude for assignee's location as of their most recent patent grant date (equivalently, as of assignee_last_seen_date)
assignee_lastknown_state assignees Last Known State string Y Assignee's state as of their most recent patent grant date (equivalently, as of assignee_last_seen_date)
assignee_latitude assignees Latitude float N Latitude for assignee's location as listed on the patent
assignee_location_id assignees Location ID string Y Unique database ID for the assignee's location as listed on the patent
assignee_longitude assignees Longitude float N Longitude for assignee's location a listed on the patent
assignee_num_patents_for_nber_subcategory assignees Number of Patents for NBER Subcategory integer N Number of patents in the database for a given assignee within a NBER subcategory
assignee_organization assignees Organization string Y Organization name, if assignee is organization
assignee_state assignees State string Y Assignee's state as listed on the patent
assignee_total_num_inventors assignees Total Number of Inventors integer Y Total number of inventors in database for a given assignee (as indicated by unique assignee_id)
assignee_total_num_patents assignees Total Number of Patents integer Y Total number of patents in database for a given assignee (as indicated by unique assignee_id)
assignee_type assignees Type string Y Classification of assignee. 2 - US Company or Corporation, 3 - Foreign Company or Corporation, 4 - US Individual, 5 - Foreign Individual, 6 - US Government, 7 - Foreign Government, 8 - Country Government, 9 - State Government (US). Note: A "1" appearing before any of these codes signifies part interest
cpc_group_id cpc_subgroups Group ID string Y CPC group ID
cpc_group_title cpc_subgroups Group Title string Y Description of CPC group
cpc_subgroup_id cpc_subgroups Subgroup ID string Y CPC subgroup ID
cpc_subgroup_title cpc_subgroups Subgroup Title string Y Description of CPC subgroup
cpc_category cpc_subsections Category string Y Top Level Cooperative Patent Classification (CPC) category (http://www.cooperativepatentclassification.org/index.html)
cpc_first_seen_date cpc_subsections First Seen Date date Y Grant date of the earliest patent in the database within a CPC subsection.
cpc_last_seen_date cpc_subsections Last Seen Date date Y Grant date of the most recent patent in the database within a CPC subsection
cpc_section_id cpc_subsections Section ID string Y CPC section ID (A = Human Necessitites, B = Performing Operations; Transporint, C = Chemistry; Metallurgy, D = Textiles; paper, E = Fixed Constructing, F = Mechanical Engineering; Lighting; Heating; Weapons; Blasting Engines; Pumps, G = Physics, H = Electricity, Y = General Tagging of new technological developments)
cpc_subsection_id* cpc_subsections Subsection ID string Y CPC subsection ID
cpc_subsection_title cpc_subsections Subsection Title string Y Description of CPC subsection
cpc_total_num_assignees cpc_subsections Total Number of Assignees integer Y Total number of unique assignees on patents within a CPC subsection
cpc_total_num_inventors cpc_subsections Total Number of Inventors integer Y Total number of unique inventors on patents within a CPC subsection
cpc_total_num_patents cpc_subsections Total Number of Patents integer Y Total number of patents within a CPC subsection
govint_contract_award_number gov_interests Contract/Award Number string Y Contract or award number as reported in the government interest statement on patents (if available)
govint_org_id gov_interests Organization ID integer Y Organization ID of the U.S. government agency reported in the government interest statement on patents (if available)
govint_org_level_one gov_interests Top Level Government Organization string Y The top-level U.S. government organization name related to the organization reported in the government interest statement on patents (if available). For example, the National Institutes of Health report to the U.S. Department of Health and Human Services.
govint_org_level_two gov_interests Second Level Government Organization string Y The second-level U.S. government organization name related to the organization reported in the government interest statement on patents (if available). For example, the National Institutes of Health is second-level in relation to the National Heart, Lung, and Blood Institute.
govint_org_level_three gov_interests Third Level Government Organization string Y The third-level U.S. government organization name related to the organization reported in the government interest statement on patents (if available). For example, the National Institute for Occupational Safety and Health is third-level in relation to the Centers for Disease Control and Prevention that report to the U.S. Department of Health and Human Services.
govint_org_name gov_interests Organization Name string Y Name of the U.S. government organization reported in the government interest statement on patents (if available).
govint_raw_statement gov_interests Government Interest Statement full text Y The full government interest statement as reported on a given patent (if available).
inventor_city inventors City string Y Inventor's city as listed on the selected patent
inventor_country inventors Country string Y Inventor's country as listed on the selected patent
inventor_first_name inventors First Name string Y First name of inventor
inventor_first_seen_date inventors First Seen Date date Y Earliest patent grant date for all the inventor's patents in the database
inventor_id* inventors ID string Y Unique database inventor ID by disambiguation algorithm
inventor_last_name inventors Last Name string Y Last name of inventor
inventor_last_seen_date inventors Last Seen Date date Y Most recent patent grant date for all the inventor's patents in the database
inventor_lastknown_city inventors Last Known City string Y Inventor's city as of their most recent patent grant date (equivalently, as of inventor_last_seen_date)
inventor_lastknown_country inventors Last Known Country string Y Inventor's country as of their most recent patent grant date (equivalently, as of inventor_last_seen_date)
inventor_lastknown_latitude inventors Last Known Latitude float N Latitude of inventor's city as of their most recent patent grant date (equivalently, as of inventor_last_seen_date)
inventor_lastknown_location_id inventors Last Known Location ID string Y Unique database ID for the inventor's location as of their most recent patent grant date (equivalently, as of inventor_last_seen_date)
inventor_lastknown_longitude inventors Last Known Longitude float N Longitude of inventor's city as of their most recent patent grant date (equivalently, as of inventor_last_seen_date)
inventor_lastknown_state inventors Last Known State string Y Inventor's state as of their most recent patent grant date (equivalently, as of inventor_last_seen_date)
inventor_latitude inventors Latitude float N Latitude of inventor's as listed on the selected patent patent
inventor_location_id inventors Location ID string Y Unique database ID for inventor's location as listed on the selected patent
inventor_longitude inventors Longitude float N Longitude of inventor's city as listed on the selected patent
inventor_num_patents_for_nber_subcategory inventors Number of Patents for NBER Subcategory integer N Number of patents for an inventor within a NBER subcategory
inventor_state inventors State string Y Inventor's state as listed on the selected patent
inventor_total_num_patents inventors Total Number of Patents integer Y Total number of patents in the database for a given inventor (as indicated by unique inventor_id)
ipc_action_date ipcs Action Date date N Date an International Patent Classification (IPC) is issued for the patent
ipc_class ipcs Class string Y Second hierarchial level of the IPC system, sections are subdivided into classes
ipc_classification_data_source ipcs Classification Data Source string N “H” defining “Human - Generated”, “M” defining “Machine - Generated” and “G” defining “G enerated via Software”
ipc_classification_value ipcs Classification Value string Y “ I ” defining “invention information” or “N” defining “non - invention information”
ipc_first_seen_date ipcs First Seen Date date Y Grant date of the earliest patent in the database within a IPC group
ipc_last_seen_date ipcs Last Seen Date date Y Grant date of the most recent patent in the database within a IPC group
ipc_main_group ipcs Main Group string Y Subdivisions of the IPC subclass
ipc_section ipcs Section string Y Highest hierarchical levels of the IPC corresponding to broad technical fields ( A = Human Necessitites, B = Performing Operations; Transporint, C = Chemistry; Metallurgy, D = Textiles; paper, E = Fixed Constructing, F = Mechanical Engineering; Lighting; Heating; Weapons; Blasting Engines; Pumps, G = Physics, H = Electricity)
ipc_subclass ipcs Subclass string Y Subdivisions IPC class
ipc_subgroup ipcs Subgroup string Y Subdivisions of IPC main group
ipc_symbol_position ipcs Position string Y First or later position of symbols. The position of the first invention information classification can be recognized by this field. The letters "F" and "L" are used for the first and later position, respectively.
ipc_total_num_assignees ipcs Total Number of Assignees integer Y Total number of unique assignees on patents within an IPC class
ipc_total_num_inventors ipcs Total Number of Inventors integer Y Total number of unique inventors on patents within an IPC class
ipc_version_indicator ipcs Version Indicator date N The version of the IPC classification system
nber_category_id nber_subcategories Category ID string Y National Bureau of Economic Research (NBER) technology category ID (see nber_category_title for details)
nber_category_title nber_subcategories Category Title string Y Description of NBER category
nber_first_seen_date nber_subcategories First Seen Date date Y Grant date of the earliest patent in the database within a NBER subcategory
nber_last_seen_date nber_subcategories Last Seen Date date Y Grant date of the most recent patent in the database within a NBER subcategory
nber_subcategory_id nber_subcategories Subcategory ID string Y NBER subcategory ID (see nber_subcategory_title for details)
nber_subcategory_title nber_subcategories Subcategory Title string Y Description of NBER subcategory
nber_total_num_assignees nber_subcategories Total Number of Assignees integer Y Total number of unique assignees on patents within a NBER subcategory
nber_total_num_inventors nber_subcategories Total Number of Inventors integer Y Total number of unique inventors on patents within a NBER subcategory
nber_total_num_patents nber_subcategories Total Number of Patents integer Y Total number of patents within a NBER subcategory
patent_abstract patents Abstract full text N Abstract of the patent
patent_date patents Grant Date date Y Date patent was granted
patent_firstnamed_assignee_city patents First Named Assignee City string Y City of the location of the first-named (i.e. first in the list) assignee on the patent
patent_firstnamed_assignee_country patents First Named Assignee Country string Y Country of the location of the first-named (i.e. first in the list) assignee on the patent
patent_firstnamed_assignee_id patents First Named Assignee ID string Y Assignee ID (assignee_id) for the first-named (i.e. first in the list) assignee on the patent
patent_firstnamed_assignee_latitude patents First Named Assignee Latitude float N Latitude of the location of the first-named (i.e. first in the list) assignee on the patent
patent_firstnamed_assignee_location_id patents First Named Assignee Location ID string Y Unique database ID for the location of the first-named (i.e. first in the list) assignee on the patent
patent_firstnamed_assignee_longitude patents First Named Assignee Longitude float N Longitude of the location of the first-named (i.e. first in the list) assignee on the patent
patent_firstnamed_assignee_state patents First Named Assignee State string Y State of the location of the the first-named (i.e. first in the list) assignee on the patent
patent_firstnamed_inventor_city patents First Named Inventor City string Y City of the location of the the first-named (i.e. first in the list) inventor on the patent
patent_firstnamed_inventor_country patents First Named Inventor Country string Y Country of the location of the first-named (i.e. first in the list) inventor on the patent
patent_firstnamed_inventor_id patents First Named Inventor ID string Y Inventor ID (inventor_id) for the first-named (i.e. first in the list) inventor on the patent
patent_firstnamed_inventor_latitude patents First Named Inventor Latitude float N Latitude of the location of the first-named (i.e. first in the list) inventor on the patent
patent_firstnamed_inventor_location_id patents First Named Inventor Location ID string Y Unique database ID for the location of the first-named (i.e. first in the list) inventor on the patent
patent_firstnamed_inventor_longitude patents First Named Inventor Longitude float N Longitude of the location of the first-named (i.e. first in the list) inventor on the patent
patent_firstnamed_inventor_state patents First Named Inventor State string Y State of the location of the first-named (i.e. first in the list) inventor on the patent
patent_kind patents Kind string Y World Intellectual Property Organization (WIPO) Standard ST.16 Patent Code (http://www.uspto.gov/learning-and-resources/support-centers/electronic-business-center/kind-codes-included-uspto-patent)
patent_num_cited_by_us_patents patents Number Cited by US Patents integer Y Number of times the patent was cited by other US patents
patent_num_claims patents Number of Claims integer N Number of claim statements on the patent
patent_num_combined_citations patents Number of Combined Citations integer Y Number of patents and applications cited by the selected patent. This is the sum of citations of US patents, foreign patents, and US applications
patent_num_foreign_citations patents Number of Foreign Citations integer Y Number of foreign patents cited by the selected patent
patent_num_us_application_citations patents Number of US Application Citations integer Y Number of US applications cited by the selected patent
patent_num_us_patent_citations patents Number of US Patent Citations integer Y Number of US patents cited by the selected patent
patent_number* patents Number string Y US Patent number, as assigned by USPTO
patent_title patents Title full text Y Title of the patent
patent_type patents Type string Y Category of patent. There are 6 possible type: "Defensive Publication" - 509, "Design" - 474736, "Plant" - 21052, "Reissue" - 16416, "Statutory Invention Registration" - 2254, "Utility" - 4910906.
rawinventor_first_name rawinventors First Name string Y Inventor first name before disambiguation as listed on the selected patent
rawinventor_last_name rawinventors Last Name string Y Inventor last name before disambiguation as listed on the selected patent
uspc_first_seen_date uspcs First Seen Date date Y Grant date of the earliest patent in the database within a USPC mainclass
uspc_last_seen_date uspcs Last Seen Date date Y Grant date of the most recent patent in the database within a USPC mainclass
uspc_mainclass_id uspcs Mainclass ID string Y ID of the USPC mainclass
uspc_mainclass_title uspcs Mainclass Title string Y Description of USPC mainclass
uspc_sequence uspcs Sequence integer Y Order of the USPC classification in the list of classifications for the selected patent
uspc_subclass_id* uspcs Subclass ID string Y ID of USPC subclass
uspc_subclass_title uspcs Subclass Title string Y Description of USPC subclass
uspc_total_num_assignees uspcs Total Number of Assignees integer Y Total number of unique assignees on patents within a USPC mainclass
uspc_total_num_inventors uspcs Total Number of Inventors integer Y Total number of unique inventors on patents within a USPC mainclass
uspc_total_num_patents uspcs Total Number of Patents integer Y Total number of patents within a USPC mainclass
wipo_field_id wipos WIPO Technology Field ID integer Y ID of WIPO technology field
wipo_field_title wipos Technology Field Title string Y Description of WIPO technology field
wipo_sector_title wipos Technology Sector Title string Y Description of WIPO technology sector
wipo_sequence wipos Sequence integer Y Order of the WIPO technology field in the list of technology fields for the selected patent
year_id years ID integer Y Year
year_num_patents_for_nber_subcategory years Number of Patents for NBER Subcategory integer N Number of patents within a NBER subcategory for a given year