Skip to main content

A set of ORM-style clients for publicly available intellectual property data

Project description

https://travis-ci.org/parkerhancock/patent_client.svg?branch=master https://codecov.io/gh/parkerhancock/patent_client/branch/master/graph/badge.svg PyPI Package latest release PyPI Wheel Supported versions

Overview

A set of Django-ORM-Style accessors to publicly available intellectual property data.

Currently supports:

  • Free software: Apache Software License 2.0

Installation

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.

Documentation

The easiest way to get started is with Patent Client Examples. The examples repository has a list of Jupyter notebooks showing application examples of the patent_client library.

Docs, including a fulsome Getting Started are available on Read the Docs.

SUPER QUICK START

To use the project:

# Import the model classes you need
>>> from patent_client import Inpadoc, Epo, 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)
23860
>>> assignments[0].id
'47086-788'
>>> assignments[0].conveyance_text
'ASSIGNMENT OF ASSIGNORS INTEREST (SEE DOCUMENT FOR DETAILS).'

# Fetch from INPADOC
>>> pub = Inpadoc.objects.get('EP3082535A1')
>>> pub.title
'AUTOMATIC FLUID DISPENSER'
>>> pub.priority_claims
['201314137130', '2014071849']

# Fetch from EPO Register
>>> epo = Epo.objects.get('EP3082535A1')
>>> epo.title
'AUTOMATIC FLUID DISPENSER'
>>> epo.status
[{'description': 'Examination is in progress', 'code': '14', 'date': '20180615'}]

Other Languages

Merely as a way to explore other languages and technologies, I have built a few (partial) ports of this library to other languages:

Development

To run the all tests run:

pytest

A developer guide is provided in the Documentation. This project is narrowly scoped to only public documented API’s available without charge (at least for moderate usage). Scrapers of HTML websites are not permitted. But PR’s to add support for new API’s are more than welcome.

Pull requests welcome!

Changelog

0.4.0 (2019-01-30)

  • Renewed commitment to adhere to semantic versioning

  • Added several new synthetic data attributes, including expiration date calculations

  • General updates and improvements, including an overhaul of the base Manager and Model classes

0.2.3 (2018-11-02)

  • Added parser for Inpadoc claims so they have an object repesentation

0.1.5 (2018-10-25)

  • Massive refactor of OPS client

0.1.4 (2018-10-24)

  • Support for USPTO Applications, Assignments, and PTAB documents

  • Support for EPO Inpadoc and EPO Register

  • Initial Installation and Getting Started Documentation

0.0.1 (2018-10-15)

  • First release on PyPI.

  • Support for EPO OPS (except Classification data)

Project details


Download files

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

Source Distribution

patent_client-1.1.1.tar.gz (5.5 MB view hashes)

Uploaded Source

Built Distribution

patent_client-1.1.1-py2.py3-none-any.whl (35.4 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page