A collection of ORM-style clients to public patent data
A powerful library for accessing intellectual property, featuring:
Docs, including a fulsome Getting Started and User Guide are available on Read the Docs. The Examples folder includes examples of using patent_client
for
many common IP tasks
Version 5 brings a new and more reliable way to provide synchronous and asynchronous access to the various APIs.
In version 5, like in version 3, you can just from patent_client import [Model]
and get a synchronous version
of the model. No asynchronous methods or functionality at all. Or you can do from patent_client._async import [Model]
and get an asynchronous version of the model.
Version 5 also brings support for the USPTO's new Open Data Portal, a system currently in beta that is scheduled to replace the current Patent Examination Data System in late 2024.
United States Patent & Trademark Office
European Patent Office - Open Patent Services
pip install patent_client
If you only want access to USPTO resources, you're done! However, additional setup is necessary to access EPO Inpadoc and EPO Register resources. See the Docs.
To use the project:
# Import the model classes you need
>>> from patent_client import Inpadoc, Assignment, USApplication
# Fetch US Applications
>>> app = USApplication.objects.get('15710770')
>>> app.patent_title
'Camera Assembly with Concave-Shaped Front Face'
# Fetch from USPTO Assignments
>>> assignments = Assignment.objects.filter(assignee='Google')
>>> len(assignments) > 23000
True
>>> assignment = Assignment.objects.get('47086-788')
>>> assignment.conveyance_text
'ASSIGNMENT OF ASSIGNORS INTEREST'
# Fetch from INPADOC
>>> pub = Inpadoc.objects.get('EP3082535A1')
>>> pub.biblio.title
'AUTOMATIC FLUID DISPENSER'
To use async with Patent Client, just import the classes you need from the async module. All methods and iterators that access data or create a network request are asynchronous.
from patent_client._async import USApplication
apps = list()
async for app in USApplication.objects.filter(first_named_applicant="Google"):
apps.append(app)
app = await USApplication.objects.aget("16123456")
Docs, including a fulsome Getting Started are available on Read the Docs.
To run the all tests run:
pytest
A developer guide is provided in the Documentation. Pull requests welcome!