> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# PatentsView Connector

## Intro

PatentsView  is a prototype patent data visualization and analysis platform intended to increase the value, utility, and transparency of US patent data.  To learn more about the PatentsView API, visit their page ([http://www.patentsview.org/api/doc.html](http://www.patentsview.org/api/doc.html "http://www.patentsview.org/api/doc.html") ).

You connect to your PatentsView account in the Data Center. This topic discusses the fields and menus that are specific to the PatentsView connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in [Adding a DataSet Using a Data Connector](/s/article/360042926274 "Adding a DataSet Using a Data Connector").

## Prerequisites

None. This connector retrieves public data, so there is no need to enter account credentials.

## Connecting to Your PatentsView Account

This section enumerates the options in the **Details** panes in the PatentsView Connector page. The components of the other panes in this page, **Scheduling** and **Name & Describe Your DataSet**, are universal across most connector types and are discussed in greater length in [Adding a DataSet Using a Data Connector](/s/article/360042926274 "Adding a DataSet Using a Data Connector").

### Details Pane

This pane contains a primary **Reports** menu, along with various other menus which may or may not appear depending on the report type you select.

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p> Menu </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Report </p></td><td colspan="1" rowspan="1"><p> Select the PatentsView report you want to run. The following reports are available: </p><table border="1" cellpadding="1" cellspacing="1"><tbody><tr><td colspan="1" rowspan="1"><p> Assignees </p></td><td colspan="1" rowspan="1"><p> Returns a list of all assignees. </p></td></tr><tr><td colspan="1" rowspan="1"><p> CPC </p></td><td colspan="1" rowspan="1"><p> Returns a list of all CPC (Cooperative Patent Classification) subsections. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Locations </p></td><td colspan="1" rowspan="1"><p> Returns a list of all patent locations. </p></td></tr><tr><td colspan="1" rowspan="1"><p> NBER </p></td><td colspan="1" rowspan="1"><p> Returns a list of NBER (National Bureau of Economic Research) categories. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Patents </p></td><td colspan="1" rowspan="1"><p> Returns a list of patents. </p></td></tr><tr><td colspan="1" rowspan="1"><p> USPC </p></td><td colspan="1" rowspan="1"><p> Returns a list of USPC (United States Patent Classification) mainclasses. </p></td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"><p> Query Type </p></td><td colspan="1" rowspan="1"><p> Select your desired query type. </p><ul><li><p><b> No Filter </b>. Select this option if you do not want to filter data using a query. </p></li><li><p><b> Query Builder </b>. Select this option if you want help in building your query. A sample of template code will appear in the field below the options; all you need to do is fill in the gaps in the code with your desired filter criteria. </p></li><li><p><b> Manual Query </b>. Select this option if you want to build your entire filter query yourself. </p></li></ul></td></tr><tr><td colspan="1" rowspan="1"><p> Query </p></td><td colspan="1" rowspan="1"><p> If you selected <b> Query Builder </b> as your <b> Query Type </b>, simply fill in the gaps in the code sample with your desired filter criteria. </p><p> If you selected <b> Manual Query </b> as your <b> Query Type </b>, enter your query here. </p><p> An example of a manual query would be as follows: </p><p><span class="mt-font-courier-new"> ('inventor\_last\_name' = 'Whitney' AND ('patent\_title' TEXT\_PHRASE 'cotton gin')) <br /> OR <br /> ('inventor\_last\_name' = 'Heath' AND 'patent\_title' TEXT\_ALL 'COBOL') <br /> AND <br /> ('patent\_number' = '9616799'). </span></p><p> In other words, the report will pull data ONLY if the inventors's last name is "Whitney" and the patent name is "cotton\_gin" OR the inventor's last name is "Heath" and the patent title is "Cobol." In both cases, the patent number must also be "9616799." </p><p> Refer to the following links for respective reports for filter selection: </p><ul><li><p> "Patents" -- <a href="http://www.patentsview.org/api/patent.html#field_list" target="_blank" title="PatentsView Connector"> Patents Report Filter List </a></p></li><li><p> "Inventors" -- <a href="http://www.patentsview.org/api/inventor.html#field_list" target="_blank" title="PatentsView Connector"> Inventors Report Filter List </a></p></li><li><p> "Assignees" -- <a href="http://www.patentsview.org/api/assignee.html#field_list" target="_blank" title="PatentsView Connector"> Assignees Report Filter List </a></p></li><li><p> "Locations" -- <a href="http://www.patentsview.org/api/location.html#field_list" target="_blank" title="PatentsView Connector"> Locations Report Filter List </a></p></li><li><p> "CPC" -- <a href="http://www.patentsview.org/api/cpc_subsection.html#field_list" target="_blank" title="PatentsView Connector"> CPC Report Filter List </a></p></li><li><p> "USPC" -- <a href="http://www.patentsview.org/api/uspc.html#field_list" target="_blank" title="PatentsView Connector"> USPC Report Filter List </a></p></li><li><p> "NBER" -- <a href="http://www.patentsview.org/api/nber_subcat.html#field_list" target="_blank" title="PatentsView Connector"> NBER Report Filter List </a></p></li></ul></td></tr><tr><td colspan="1" rowspan="1"><p> Fields </p></td><td colspan="1" rowspan="1"><p> Select the category of fields you want to pull data from. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Date Filter </p></td><td colspan="1" rowspan="1"><p> Select the date filter you want to apply to your report. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Duration </p></td><td colspan="1" rowspan="1"><p> Select whether you want to pull data for a specific date or a date range. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Report Date </p></td><td colspan="1" rowspan="1"><p> Select whether the report data is for a specific date or for a relative number of days back from today. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Select Specific Date </p></td><td colspan="1" rowspan="1"><p> Select the date for the report. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Days Back </p></td><td colspan="1" rowspan="1"><p> Enter the number of past days that should appear in the report. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Start Date </p></td><td colspan="1" rowspan="1"><p> Specify whether the first date in your date range is a specific or relative date. You select the last date in your range in <b> End Date </b>. </p></td></tr><tr><td colspan="1" rowspan="1"><p> End Date </p></td><td colspan="1" rowspan="1"><p> Specify whether the second date in your date range is a specific or relative date. You select the first date in your range in <b> Start Date </b>. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Select Specific Start Date </p></td><td colspan="1" rowspan="1"><p> Select the first date in your date range. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Select Specific End Date </p></td><td colspan="1" rowspan="1"><p> Select the second date in your date range. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Days Back to Start From </p></td><td colspan="1" rowspan="1"><p> Enter the number of the farthest day back that should be represented in the report. Combine with <b> Days Back to End At </b> to create a range of represented days. </p><p> For example, if you entered <span class="mt-font-courier-new"> 10 </span> for <b> Days Back to Start From </b> and <span class="mt-font-courier-new"> 5 </span> for <b> Days Back to End At </b>, the report would contain data for 10 days ago up until 5 days ago. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Days Back to End At </p></td><td colspan="1" rowspan="1"><p> Enter the number of the most recent day back that should be represented in the report. Combine with <b> Days Back to Start From </b> to create a range of represented days. </p><p> For example, if you entered <span class="mt-font-courier-new"> 10 </span> for <b> Days Back to Start From </b> and <span class="mt-font-courier-new"> 5 </span> for <b> Days Back to End At </b>, the report would contain data for 10 days ago up until 5 days ago. </p></td></tr></tbody></table>

### Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Data Connector](/s/article/360042926274 "Adding a DataSet Using a Data Connector").

## FAQs

<AccordionGroup>
  <Accordion title="How often can the data be updated?">
    As often as needed.
  </Accordion>

  <Accordion title="Are there any API limits I should be aware of?">
    The results from the API will only have one level of hierarchy of subentities under the primary entity.
  </Accordion>
</AccordionGroup>
