Bulk downloads via TSDR APIs

Beginning on October 2, you’ll need an API key to download bulk data in TSDR through an application programing interface (API). Using API keys will help optimize usage of our TSDR system, which will help enable users like yourself to better access the information you need from TSDR.

What is a TSDR API?

TSDR allows you to make programmatic requests for trademark case status, documents, and images through a web application programming interface (API). An API is a set of routines, protocols, and tools for building software and applications. APIs allow for safe, direct, and metered access to official USPTO data and reduce service interruptions to USPTO systems.

How do I retrieve bulk data using the TSDR APIs?

As of October 2, 2020, you must register in order to use the TSDR APIs. As part of the registration process, you will receive a code from the USPTO’s enterprise API gateway server. This code is an API key that will allow you to retrieve bulk data.

See our user guide for more on how to retrieve bulk data. You may also access our guide by clicking “Usage Instructions” on our TSDR Data API webpage.

Your API key will be stored in our USPTO database and will be linked to your USPTO.gov account. If you accidently lose your API key, log in to API manager using your MyUSPTO credentials to retrieve your API key.

What is an API key?

API keys are passcodes that give you access to a specific API based on the information you need. Keys are unique alphanumeric string values that help regulate how APIs are used.

Why do I need an API key?

API keys protect API traffic, improve internal system productivity, and reduce system downtime due to outages. By having an API key requirement, we can help prevent USPTO IT systems, such as TSDR, from crashing. We can also work with you to understand your specific needs and help you get the data you need without overburdening our systems. This way everyone is able to access the data they need.

How do I register for an API key?

Once you have an USPTO.gov account, you can register for an API key. See our user guide for step-by-step instructions on how to sign up for an API key. Once you complete the steps, you will be given your API key. The API key is both a unique identifier and a secret token for authentication. After registering, you will also receive an email with your API key. Keep this key private because it’s linked to your specific user account.

Review our user guide for more information about how to obtain and use a TSDR API key.

Where do I get customer support?

If you have questions about the TSDR API or need assistance with your API key, email APIhelp@uspto.gov. You can also ask questions in our TSDR API discussion section.

What is the rate limit for the TSDR API?

The TSDR API usage is rate-limited in order to ensure that system resources remain available. All requests are rate limited at 60 requests per API key per minute. PDF, ZIP, and multi-case downloads are rate limited at four requests per API key per minute. Rate limits are subject to change depending on system availability and usage.

Where can I get more information on the TSDR APIs?

Review our user guide for more information about how to use the TSDR APIs.