Skip to main content

graph patent citation USPTO database graphscraper webscraper

Project description


Graph that downloads patent citation data from USPTO's PatentsView API on-demand and stores it locally in an SQL database (and in memory) for fast access later.

The project is based on the graphscraper project, please see that project for the details of the graph API.


Install the latest version of the project from the Python Package Index using pip install uspto-patent-citation-graph.

Getting started

Creating a graph instance that will use a default, on-disk SQLite database:

from uspto_patent_citation_graph import USPTOPatentCitationGraph

graph = USPTOPatentCitationGraph(None)

Loading a node that is not in the local database yet:

# `can_validate_and_load=True` tells the graph's node list that it is allowed to
# load data from the PatentsView API. Its default value is `False`, and the
# argument can be omitted if the given patent is already in the local database.
patent_number = "4733665"  # Stent patent
stent_patent = g.nodes.get_node_by_name(patent_number, can_validate_and_load=True)

Accessing a node's neighbors (cited and cited-by patents):

print(f"Neighbors of {}:")
for neighbor in stent_patent.neighbors:
    print(f" - {}: {neighbor.external_id}")

Community guidelines

Any form of constructive contribution is welcome:

  • Questions, feedback, bug reports: please open an issue in the issue tracker of the project or contact the repository owner by email, whichever you feel appropriate.
  • Contribution to the software: please open an issue in the issue tracker of the project that describes the changes you would like to make to the software and open a pull request with the changes. The description of the pull request must references the corresponding issue.

The following types of contribution are especially appreciated:

License - MIT

The library is open-sourced under the conditions of the MIT license.

Project details

Release history Release notifications

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for uspto-patent-citation-graph, version 0.2002.0
Filename, size File type Python version Upload date Hashes
Filename, size uspto_patent_citation_graph-0.2002.0-py3-none-any.whl (5.2 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size uspto-patent-citation-graph-0.2002.0.tar.gz (4.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page