Бюро по патентам и товарным знакам США (независимый издатель) (предварительная версия)

Поиск и получение библиографических данных для патентных приложений.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга	Class	Регионы
Copilot Studio	Премия	Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD)
Логические приложения	Стандарт	Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD)
Power Apps	Премия	Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD)
Power Automate	Премия	Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD)

Контакт
Имя	Бюро по патентам и товарным знакам США
URL	https://developer.uspto.gov
Адрес электронной почты	uspto@uspto.gov

Метаданные соединителя
Publisher	krautrocker
Website	https://developer.uspto.gov
Политика конфиденциальности	https://www.uspto.gov/privacy-policy
Категории	ИТ-операции

Бюро по патентам и товарным знакам США (независимый издатель)

Издатель: Дэн Романо (swolcat)

Предпосылки

Чтобы получить ключ API, у вас должна быть зарегистрированная учетная запись разработчика в Сша По патентам и товарным знакам .

Вы можете зарегистрироваться и получить ключ из Центра разработчиков API USPTO.

Поддерживаемые операции

Соединитель предоставляет доступ к службам данных о библиографических и файловых оболочках USPTO.
Он поддерживает как параметр запроса (GET), так и структурированные полезные данные JSON (POST) для поиска гибких, высоко томных патентных данных.

Поиск по патентам

GET /applications/search— Поиск патентоприязательных приложений с помощью параметров запроса (q, , filters, rangeFilterssortи т. д.).
Возвращает первые 25 записей по умолчанию, если параметры не указаны.
POST /applications/search— Выполните расширенный поиск с помощью структурированной полезных данных JSON с фильтрами, фильтрами диапазона, разбивкой на страницы и выбором полей.
Пример:
GET /applications/search/download — получение результатов поиска в формате скачивания с помощью параметров запроса.
POST /applications/search/download — Скачайте результаты поиска в формате JSON или CSV с помощью аналогичной полезных данных, как конечная точка POST поиска.

Сведения о патенте приложения

Каждая из следующих конечных точек извлекает определенные данные, связанные с заданным номером приложения патента ({applicationNumberText}):

GET /{applicationNumberText} — получение патента по номеру приложения
GET /{applicationNumberText}/meta-data — Bibliographic metadata for a patent application.
GET /{applicationNumberText}/adjustment — сведения о корректировке терминов.
GET /{applicationNumberText}/assignment — данные о назначении и владении.
GET /{applicationNumberText}/attorney - Адвокат и сведения о переписке.
GET /{applicationNumberText}/continuity — данные непрерывности (родительские и дочерние приложения).
GET /{applicationNumberText}/foreign-priority — сведения о утверждении внешнего приоритета.
GET /{applicationNumberText}/transactions — журнал транзакций приложений.
GET /{applicationNumberText}/documents — опубликованные документы оболочки файлов.
GET /{applicationNumberText}/associated-documents — связанные метаданные публикации (PGPub или grant).

Справочные данные по патентам

GET /patent/status-codes — получение кодов состояния и их определений, используемых в записях USPTO.
POST /patent/status-codes — поиск кодов состояния патентного приложения с помощью полезных данных JSON.

Поиск набора данных

GET /datasets/products/search — поиск наборов данных продукта USPTO.
GET /datasets/products/{productIdentifier} — получение метаданных для определенного набора данных.

Данные о решении петиции

GET /petition/decisions/search — поиск записей решения о петиции (параметры запроса).
POST /petition/decisions/search — поиск записей о решении петиции (JSON).
GET /petition/decisions/search/download — скачайте решения по петициям (параметры запроса).
POST /petition/decisions/search/download — скачать решения по петициям (JSON).
GET /petition/decisions/{petitionDecisionRecordIdentifier} — получение определенной записи о решении петиции.

Поиск текста в поиск

POST /patent/applications/text-to-search — примите текстовые входные данные и возвращать соответствующие результаты патентного приложения.

Получение учетных данных

Официальный справочник по API USPTO можно найти здесь.

Начало работы

Официальный сайт

Официальный справочник по API USPTO

Перейдите в Центр разработчиков USPTO.
Зарегистрируйтесь или войдите в учетную запись разработчика.
Запрос ключа API для API-интерфейсов данных патента.Примечание. Ключ API является обязательным. Получите ключ API здесь.
Скопируйте ключ API и сохраните его безопасно. Вы будете использовать его для проверки подлинности запросов.

При создании подключения в Power Platform введите ключ API USPTO. Соединитель автоматически отправляет этот ключ в заголовке запроса как x-api-key: {your-api-key}

Известные проблемы и ограничения

1.) Ограничения запросов

USPTO может ограничить использование API скорости в зависимости от тома запроса.

Конечная точка /search/download GET может быть недоступна в режиме песочницы; вместо этого используйте вариант POST.
Время ожидания запросов может возникать при использовании сложных фильтров или больших диапазонов дат.
Свежесть данных зависит от внутреннего расписания публикации USPTO.

2.) Переход

На веб-сайте: "По состоянию на 14 марта 2025 г. система обработки данных патента (PEDS) больше не доступна. Чтобы получить доступ к общедоступным записям о патентах USPTO или статусе подачи патента, пользователи могут получить доступ к функции оболочки патентного файла на портале Open Data Portal".
[Подробнее здесь[(https://data.uspto.gov/apis/transition-guide/bdss).

3.) Конечная точка "Текст — поиск"

Конечная точка "Текст в поиск" находится в документе Swagger, но он не указан на общедоступном сайте. Эта конечная точка не включена в этот соединитель.

Рассмотрите возможность использования /api/v1/patent/applications/search в качестве альтернативы.

4.) Коды идентификаторов продукта

Для конечных точек массовых данных требуется идентификатор продукта. Примеры см. здесь.

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:


По умолчанию	Параметры для создания подключения.	Все регионы	Недоступен для совместного использования

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя	Тип	Description	Обязательно
ключ API	securestring	Api_key для этого API	True

Ограничения регулирования

Имя	Вызовы	Период обновления
Вызовы API для каждого подключения	100	60 секунд

Действия

Поиск кодов состояния патентного приложения с помощью полезных данных JSON	Выполните расширенный поиск кодов состояния патентного приложения с помощью структурированной полезных данных JSON. Все поля в запросе являются необязательными.
Поиск патентных приложений (расширенный JSON)	Получение данных приложения-патента с помощью структурированных полезных данных JSON.
Поиск патентных приложений с помощью параметров запроса	Возвращает до 25 патентных приложений, соответствующих необязательным фильтрам, полям, сортировке и аспектам.
Поиск продуктов массового набора данных	Получение доступных наборов массовых данных USPTO с дополнительными фильтрами и параметрами поиска.
Получение данных адвоката или агента	Получение сведений о адвокате или представлении агента для определенного номера патентного приложения.
Получение данных внешнего приоритета	Получение сведений о внешнем приоритете для конкретного патента, включая номера иностранных заявок, страны и даты подачи.
Получение данных о корректировке терминов патента	Получение сведений о корректировке терминов патента для определенного номера приложения, включая расширения и сведения о задержке.
Получение данных о назначении патента	Получение сведений о назначении и передаче собственности для определенного номера приложения патента.
Получение данных о непрерывности патентов	Получение отношений непрерывности родительских и дочерних элементов для указанного номера приложения патента, включая продолжение, деления и продолжение в части.
Получение журнала транзакций патента	Получение хронологического списка событий судебного преследования и транзакций для определенного номера заявки на патент.
Получение кодов состояния патентного приложения	Поиск и фильтрация кодов состояния патентного приложения и описания с помощью параметров запроса. Все параметры являются необязательными. Возвращает первые 25 результатов по умолчанию.
Получение метаданных документа для патентного приложения	Получение сведений о документах, поданных или выданных для определенного номера патентного приложения, включая действия офиса, ответы и листы сборов.
Получение метаданных приложения-патента	Получение сведений о метаданных для указанного номера приложения патента, включая библиографические и данные оболочки файлов.
Получение патентного приложения по номеру	Получение подробных библиографических данных для указанного номера приложения патента. Номера приложений, содержащие специальные символы (например `PCT/BR00/000001`, должны быть закодированы в кодировке UTF-8).
Получение продукта массового набора данных по идентификатору	Получение сведений о конкретном продукте массового набора данных USPTO по его короткому имени (productIdentifier). Необязательные параметры позволяют фильтровать по диапазону дат и включать файлы продукта.
Получение решения петиции по идентификатору	Получение подробных сведений о решении петиции по уникальному идентификатору записи решения петиции. При необходимости включите документы принятия решений в ответ с помощью `includeDocuments` параметра запроса.
Получение связанных публикаций и предоставление метаданных документа	Извлеките метаданные для связанной публикации (PGPub) и предоставьте документы, связанные с определенным номером приложения патента.
Решения по поиску петиций (параметры запроса)	Получение данных о решении петиции путем предоставления параметров запроса. Параметры запроса являются необязательными— если они не предоставлены, возвращаются первые 25 записей.
Решения по поиску петиций (расширенные json)	Получение данных о решении петиции с помощью структурированной полезных данных JSON. Поддерживает логический поиск, фильтры, фильтры диапазона, сортировку, выделение полей и разбиение на страницы.
Скачивание данных о решении петиции (advanced JSON)	Скачайте данные о решении петиции путем предоставления структурированной полезных данных JSON. Ответ поддерживает формат JSON или CSV на `format` основе параметра.
Скачивание данных о решении петиции (параметры запроса)	Получение данных о решении петиции путем предоставления параметров запроса. Поддерживает необязательные параметры запроса и возвращает первые 25 результатов по умолчанию.
Скачивание патентных данных	Скачайте данные приложения патента путем предоставления полезных данных поиска JSON.

Поиск кодов состояния патентного приложения с помощью полезных данных JSON

Идентификатор операции:: Search_Patent_Status_Codes_POST

Выполните расширенный поиск кодов состояния патентного приложения с помощью структурированной полезных данных JSON. Все поля в запросе являются необязательными.

Параметры

Имя	Ключ	Тип	Описание
q	q	string	Поисковый запрос, поддерживающий логические операторы (AND, OR, NOT), подстановочные знаки (*) и точные фразы (""). Соответствует полям кода состояния и описания.
имя	name	string	Имя поля для фильтрации по.
value	value	array of string	Список значений фильтра для указанного поля.
поле	field	string	Имя поля для фильтра диапазона.
valueFrom	valueFrom	string	Начальное значение диапазона (включительно).
valueTo	valueTo	string	Конечное значение диапазона (включительно).
поле	field	string	Имя поля для сортировки по.
заказ	order	string	Порядок сортировки (asc или desc).
offset	offset	integer	Смещение первой записи, возвращаемой.
limit	limit	integer	Максимальное количество возвращаемых записей.

Возвращаемое значение

Структура ответа для результатов поиска кода состояния патента.

Тело: StatusCodeSearchResponse

Поиск патентных приложений (расширенный JSON)

Идентификатор операции:: Search_Patent_Applications_POST

Получение данных приложения-патента с помощью структурированных полезных данных JSON.

Параметры

Имя	Ключ	Тип	Описание
q	q	string	Строка запроса поиска, поддерживающая логические операторы и подстановочные знаки.
имя	name	string
value	value	array of string
поле	field	string
valueFrom	valueFrom	string
valueTo	valueTo	string
поле	field	string
заказ	order	string
столбцов	fields	array of string
offset	offset	integer
limit	limit	integer
Аспекты	facets	array of string

Возвращаемое значение

Тело: PatentDataResponse

Поиск патентных приложений с помощью параметров запроса

Идентификатор операции:: Search_Patent_Applications_GET

Возвращает до 25 патентных приложений, соответствующих необязательным фильтрам, полям, сортировке и аспектам.

Параметры

Имя	Ключ	Тип	Описание
Поисковый запрос	q	string	Строка текста поиска, поддерживающая логический синтаксис, диапазон и подстановочные знаки.
Порядок сортировки	sort	string	Порядок полей и сортировки (например, заявок asc).
Смещение	offset	integer	Позиция смещения записи.
Лимит	limit	integer	Количество возвращаемых записей.
Facets	facets	string	Разделенные запятыми поля для аспектов.
Fields	fields	string	Разделенный запятыми список полей для включения в результаты.
Фильтры	filters	string	Фильтрация записей по имени поля и значению.
Фильтры диапазонов	rangeFilters	string	Фильтры диапазона для числовых или датовых полей.

Возвращаемое значение

Тело: PatentDataResponse

Поиск продуктов массового набора данных

Идентификатор операции:: Search_Bulk_DataSets

Получение доступных наборов массовых данных USPTO с дополнительными фильтрами и параметрами поиска.

Параметры

Имя	Ключ	Тип	Описание
Поисковый запрос	q	string	Строка запроса поиска, поддерживающая логические операторы (AND, OR, NOT), подстановочные знаки (*) и точные фразы (""). Пример: `decisionTypeCodeDescriptionText:Denied OR finalDecidingOfficeName:OFFICE`
Поле сортировки	sort	string	Поле для сортировки результатов по (например, `petitionMailDate asc`).
Смещение записи	offset	integer	Позиция в наборе данных первой записи, возвращаемой.
Ограничение результатов	limit	integer	Максимальное количество возвращаемых результатов.
Facets	facets	string	Разделенный запятыми список полей для группирования результатов (аспектов).
Fields	fields	string	Разделенный запятыми список полей для включения в ответ.
Фильтры	filters	string	Фильтры значений полей, разделенные пробелом. Пример: `technologyCenter 3600` или `businessEntityStatusCategory 'Small'`.
Фильтры диапазонов	rangeFilters	string	Укажите фильтры числовых или диапазонов дат с помощью `:` разделителя. Пример: `petitionMailDate 2021-01-01:2025-01-01`

Возвращаемое значение

Структура ответа для результатов поиска массового набора данных USPTO.

Тело: BdssResponseBag

Получение данных адвоката или агента

Идентификатор операции:: Get_Patent_Application_Attorney

Получение сведений о адвокате или представлении агента для определенного номера патентного приложения.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Номер приложения	applicationNumberText	True	string	Номер заявки на патент, для которого запрашивается информация адвоката или агента.

Возвращаемое значение

Тело: PatentAttorneyResponse

Получение данных внешнего приоритета

Идентификатор операции:: Get_Patent_Application_ForeignPriority

Получение сведений о внешнем приоритете для конкретного патента, включая номера иностранных заявок, страны и даты подачи.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Номер приложения	applicationNumberText	True	string	Номер заявки на патент, для которого запрашивается внешний приоритет данных.

Возвращаемое значение

Тело: PatentForeignPriorityResponse

Получение данных о корректировке терминов патента

Идентификатор операции:: Get_Patent_Application_Adjustment

Получение сведений о корректировке терминов патента для определенного номера приложения, включая расширения и сведения о задержке.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Номер приложения	applicationNumberText	True	string	Номер заявки на патент, для которого запрашивается информация о корректировке терминов.

Возвращаемое значение

Тело: PatentAdjustmentResponse

Получение данных о назначении патента

Идентификатор операции:: Get_Patent_Application_Assignment

Получение сведений о назначении и передаче собственности для определенного номера приложения патента.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Номер приложения	applicationNumberText	True	string	Номер заявки на патент, для которого запрашивается информация о назначении.

Возвращаемое значение

Тело: PatentAssignmentResponse

Получение данных о непрерывности патентов

Идентификатор операции:: Get_Patent_Application_Continuity

Получение отношений непрерывности родительских и дочерних элементов для указанного номера приложения патента, включая продолжение, деления и продолжение в части.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Номер приложения	applicationNumberText	True	string	Номер приложения патента, для которого запрашивается данные непрерывности.

Возвращаемое значение

Тело: PatentContinuityResponse

Получение журнала транзакций патента

Идентификатор операции:: Get_Patent_Application_Transactions

Получение хронологического списка событий судебного преследования и транзакций для определенного номера заявки на патент.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Номер приложения	applicationNumberText	True	string	Номер патентного приложения, для которого запрашивается история транзакций.

Возвращаемое значение

Тело: PatentTransactionResponse

Получение кодов состояния патентного приложения

Идентификатор операции:: Get_Patent_Status_Codes

Поиск и фильтрация кодов состояния патентного приложения и описания с помощью параметров запроса. Все параметры являются необязательными. Возвращает первые 25 результатов по умолчанию.

Параметры

Имя	Ключ	Тип	Описание
Поисковый запрос	q	string	Строка поиска, поддерживающая логические операторы (AND, OR, NOT), подстановочные знаки (*) и точные фразы ("").
Смещение результата	offset	integer	Позиция в наборе данных определенной записи.
Ограничение результатов	limit	integer	Ограничить количество возвращаемых результатов.

Возвращаемое значение

Структура ответа для результатов поиска кода состояния патента.

Тело: StatusCodeSearchResponse

Получение метаданных документа для патентного приложения

Идентификатор операции:: Get_Patent_Application_Documents

Получение сведений о документах, поданных или выданных для определенного номера патентного приложения, включая действия офиса, ответы и листы сборов.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Номер приложения	applicationNumberText	True	string	Номер заявки на патент, для которого запрашиваются сведения о документе.
Коды документов	documentCodes		string	Разделенный запятыми список кодов документов для фильтрации результатов.
с даты	officialDateFrom		date	Начало диапазона дат для официальной даты документа (гггг-ММ-дд).
По дату	officialDateTo		date	Диапазон дат окончания официальной даты документа (гггг-ММ-дд).

Возвращаемое значение

Тело: PatentDocumentResponse

Получение метаданных приложения-патента

Идентификатор операции:: Get_Patent_Application_MetaData

Получение сведений о метаданных для указанного номера приложения патента, включая библиографические и данные оболочки файлов.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Номер приложения	applicationNumberText	True	string	Номер приложения патента, для которого запрашивается метаданные.

Возвращаемое значение

Тело: ApplicationMetaDataResponse

Получение патентного приложения по номеру

Идентификатор операции:: Get_Patent_Application_By_Number

Получение подробных библиографических данных для указанного номера приложения патента. Номера приложений, содержащие специальные символы (например PCT/BR00/000001, должны быть закодированы в кодировке UTF-8).

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Номер приложения	applicationNumberText	True	string	Номер приложения патента (UTF-8 закодирован, если специальные символы присутствуют).

Возвращаемое значение

Тело: PatentDataResponse

Получение продукта массового набора данных по идентификатору

Идентификатор операции:: Get_Bulk_DataSet_Product

Получение сведений о конкретном продукте массового набора данных USPTO по его короткому имени (productIdentifier). Необязательные параметры позволяют фильтровать по диапазону дат и включать файлы продукта.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор продукта	productIdentifier	True	string	Короткое имя продукта массового набора данных (например, BDSS_PETITIONS_2024).
Дата начала данных файла	fileDataFromDate		date	Дата начала (включительно) для фильтрации файлов набора данных по дате.
Дата окончания данных файла	fileDataToDate		date	Дата окончания (включительно) для фильтрации файлов набора данных по дате.
Смещение	offset		integer	Количество пропускаемых записей файла продукта.
Лимит	limit		integer	Количество возвращаемых записей файла продукта.
Включить файлы	includeFiles		boolean	Задайте значение true, чтобы включить подробные записи файлов в ответ; Значение false, чтобы опустить их.
Только последняя версия	latest		boolean	Задайте значение true, чтобы вернуть только последний файл продукта для этого набора данных.

Возвращаемое значение

Подробный ответ для конкретного продукта массового набора данных USPTO.

Тело: BdssResponseProductBag

Получение решения петиции по идентификатору

Идентификатор операции:: Get_Petition_Decision_By_Id

Получение подробных сведений о решении петиции по уникальному идентификатору записи решения петиции. При необходимости включите документы принятия решений в ответ с помощью includeDocuments параметра запроса.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор решения петиции	petitionDecisionRecordIdentifier	True	string	Уникальный идентификатор записи решения петиции.
Включение документов принятия решений	includeDocuments		boolean	Установите для `true` включения документов о решении петиции в ответ или `false` опустить их.

Возвращаемое значение

Объект ответа, содержащий сведения о решении петиции для определенного идентификатора.

Тело: PetitionDecisionIdentifierResponseBag

Получение связанных публикаций и предоставление метаданных документа

Идентификатор операции:: Get_Patent_Application_AssociatedDocuments

Извлеките метаданные для связанной публикации (PGPub) и предоставьте документы, связанные с определенным номером приложения патента.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Номер приложения	applicationNumberText	True	string	Номер заявки на патент, для которого запрашиваются связанные публикации и предоставления документов.

Возвращаемое значение

Тело: PatentAssociatedDocumentsResponse

Решения по поиску петиций (параметры запроса)

Идентификатор операции:: Search_Petition_Decisions_GET

Получение данных о решении петиции путем предоставления параметров запроса. Параметры запроса являются необязательными— если они не предоставлены, возвращаются первые 25 записей.

Параметры

Имя	Ключ	Тип	Описание
Поисковый запрос	q	string	Строка запроса, поддерживающая логические операторы (AND, OR, NOT), подстановочные знаки (*) и точные фразы ("").
Порядок сортировки	sort	string	Имя поля, за которым следует направление сортировки (asc или desc).
Смещение	offset	integer	Позиция в наборе данных первой записи, возвращаемой.
Лимит	limit	integer	Максимальное количество возвращаемых записей.
Поля аспектов	facets	string	Разделенный запятыми список полей для аспектов.
Выбранные поля	fields	string	Разделенный запятыми список полей для включения в ответ.
Фильтры	filters	string	Отфильтруйте результаты, указав имя поля и значение.
Фильтры диапазонов	rangeFilters	string	Фильтруйте результаты, предоставляя числовые или диапазоны дат.

Возвращаемое значение

Ответ на поиск решения петиции.

Тело: PetitionDecisionResponseBag

Решения по поиску петиций (расширенные json)

Идентификатор операции:: Search_Petition_Decisions_POST

Получение данных о решении петиции с помощью структурированной полезных данных JSON. Поддерживает логический поиск, фильтры, фильтры диапазона, сортировку, выделение полей и разбиение на страницы.

Параметры

Имя	Ключ	Тип	Описание
q	q	string	Поиск текста с логическими операторами или запросами на основе полей.
имя	name	string
value	value	array of string
поле	field	string
valueFrom	valueFrom	string
valueTo	valueTo	string
поле	field	string
заказ	order	string
столбцов	fields	array of string	Список полей для включения в ответ.
offset	offset	integer
limit	limit	integer
Аспекты	facets	array of string	Список имен полей для создания аспектов.

Возвращаемое значение

Ответ на поиск решения петиции.

Тело: PetitionDecisionResponseBag

Скачивание данных о решении петиции (advanced JSON)

Идентификатор операции:: Download_Petition_Decisions_POST

Скачайте данные о решении петиции путем предоставления структурированной полезных данных JSON. Ответ поддерживает формат JSON или CSV на format основе параметра.

Параметры

Имя	Ключ	Тип	Описание
q	q	string	Строка запроса с логическим или логическим поиском на основе полей.
имя	name	string
value	value	array of string
поле	field	string
valueFrom	valueFrom	string
valueTo	valueTo	string
поле	field	string
заказ	order	string
столбцов	fields	array of string	Поля для включения в выходные данные.
offset	offset	integer
limit	limit	integer
Аспекты	facets	array of string	Необязательные аспекты для вычислений агрегатов.
format	format	string	Формат возвращаемых данных.

Возвращаемое значение

Ответ на поиск решения петиции.

Тело: PetitionDecisionResponseBag

Скачивание данных о решении петиции (параметры запроса)

Идентификатор операции:: Download_Petition_Decisions_GET

Получение данных о решении петиции путем предоставления параметров запроса. Поддерживает необязательные параметры запроса и возвращает первые 25 результатов по умолчанию.

Параметры

Имя	Ключ	Тип	Описание
Поисковый запрос	q	string	Строка запроса поиска, принимаюющая логические операторы (AND, OR, NOT), подстановочные знаки (*) и точные фразы ("").
Порядок сортировки	sort	string	Имя поля, за которым следует порядок сортировки (asc или desc).
Смещение	offset	integer	Позиция набора данных для начала ответа.
Лимит	limit	integer	Максимальное количество возвращаемых записей.
Выбранные поля	fields	string	Разделенный запятыми список полей для включения в результат.
Фильтры	filters	string	Отфильтруйте результаты по имени поля и значению. Пример: `decisionTypeCodeDescriptionText DENIED`
Фильтры диапазонов	rangeFilters	string	Фильтрация по числовым или диапазонам дат. Пример: `petitionMailDate 2021-01-01:2025-01-01`
Формат скачивания	format	string	Формат возвращаемого набора данных (json или csv).

Возвращаемое значение

Ответ на поиск решения петиции.

Тело: PetitionDecisionResponseBag

Скачивание патентных данных

Идентификатор операции:: Download_Patent_Search_Results

Скачайте данные приложения патента путем предоставления полезных данных поиска JSON.

Параметры

Имя	Ключ	Тип	Описание
q	q	string	Строка запроса поиска.
имя	name	string
value	value	array of string
поле	field	string
valueFrom	valueFrom	string
valueTo	valueTo	string
поле	field	string
заказ	order	string
столбцов	fields	array of string
offset	offset	integer
limit	limit	integer
format	format	string

Возвращаемое значение

Тело: PatentDataResponse

Определения

PatentDataResponse

Имя	Путь	Тип
totalCount	totalCount	integer
response	response	array of object
applicationNumberText	response.applicationNumberText	string
заявок	response.filingDate	date
publicationNumber	response.publicationNumber	string
inventorName	response.inventorName	string
assigneeName	response.assigneeName	string
applicationType	response.applicationType	string

ApplicationMetaDataResponse

Имя	Путь	Тип	Описание
count	count	integer
patentFileWrapperDataBag	patentFileWrapperDataBag	array of object
applicationNumberText	patentFileWrapperDataBag.applicationNumberText	string	Бесплатный формат номера приложения
applicationMetaData	patentFileWrapperDataBag.applicationMetaData	ApplicationMetaData
requestIdentifier	requestIdentifier	string

ApplicationMetaData

Имя	Путь	Тип
заявок	filingDate	string
applicationTypeCode	applicationTypeCode	string
applicationStatusCode	applicationStatusCode	integer
firstApplicantName	firstApplicantName	string
firstInventorToFileIndicator	firstInventorToFileIndicator	string
entityStatus	entityStatus	string
groupArtUnitNumber	groupArtUnitNumber	string
docketNumber	docketNumber	string
publicationCategoryBag	publicationCategoryBag	array of string
examinerName	examinerName	string
patentNumber	patentNumber	string

PatentAdjustmentResponse

Имя	Путь	Тип	Описание
count	count	integer
patentFileWrapperDataBag	patentFileWrapperDataBag	array of object
applicationNumberText	patentFileWrapperDataBag.applicationNumberText	string	Бесплатный формат номера приложения
patentTermAdjustmentData	patentFileWrapperDataBag.patentTermAdjustmentData	PatentTermAdjustment
requestIdentifier	requestIdentifier	string

PatentTermAdjustment

Имя	Путь	Тип	Описание
applicationNumberText	applicationNumberText	string
totalDays	totalDays	integer	Общее число предоставленных дней корректировки срока патента
aDelayDays	aDelayDays	integer	Количество дней, отложенных в категории задержки USPTO A
bDelayDays	bDelayDays	integer	Количество дней, отложенных в категории задержки USPTO B
cDelayDays	cDelayDays	integer	Количество дней, отложенных в категории задержки USPTO C
перекрытиеDays	overlapDays	integer	Дни, перекрывающиеся между категориями, вычитаются из общего числа
IssueDate	issueDate	date
publicationDate	publicationDate	date
Дата расчёта	calculationDate	date
статус	status	string	Текущее состояние вычисления корректировки терминов патента

PatentAssignmentResponse

Имя	Путь	Тип	Описание
count	count	integer
patentFileWrapperDataBag	patentFileWrapperDataBag	array of object
applicationNumberText	patentFileWrapperDataBag.applicationNumberText	string	Бесплатный формат номера приложения
assignmentBag	patentFileWrapperDataBag.assignmentBag	array of Assignment
requestIdentifier	requestIdentifier	string

Assignment

Имя	Путь	Тип	Описание
reelNumber	reelNumber	integer	Номер reel, определяющий записанное назначение
frameNumber	frameNumber	integer	Номер кадра в катушке
recordedDate	recordedDate	date	Присвоение даты было записано
executionDate	executionDate	date	Назначение даты было выполнено
conveyanceText	conveyanceText	string	Тип передачи или назначения
assignorName	assignorName	string	Имя назначателя
assigneeName	assigneeName	string	Имя назначаемого
correspondenceAddress	correspondenceAddress	string	Адрес соответствия, связанный с назначением
documentIdentifier	documentIdentifier	string	Сцепленный нуль и идентификатор кадра
publicationDate	publicationDate	date	Данные назначения даты были опубликованы

PatentAttorneyResponse

Имя	Путь	Тип	Описание
count	count	integer
patentFileWrapperDataBag	patentFileWrapperDataBag	array of object
applicationNumberText	patentFileWrapperDataBag.applicationNumberText	string	Бесплатный формат номера приложения
recordAttorney	patentFileWrapperDataBag.recordAttorney	RecordAttorney
requestIdentifier	requestIdentifier	string

RecordAttorney

Имя	Путь	Тип	Описание
адвокатDocketNumber	attorneyDocketNumber	string	Номер док-набора адвоката, связанный с приложением
attorneyName	attorneyName	string	Имя адвоката записи
registrationNumber	registrationNumber	string	Номер регистрации USPTO для адвоката или агента
lawFirmName	lawFirmName	string	Юридическая фирма или организация, представляющая заявителя
correspondenceAddress	correspondenceAddress	string	Адрес переписки по записи
номер телефона	phoneNumber	string	Номер телефона для соответствия
адрес электронной почты	emailAddress	string	Обращение по электронной почте к адвокату или агенту
Дата вступления в силу	effectiveDate	date	Дата вступления в силу для адвоката записи
статус	status	string	Текущее состояние адвоката или записи агента

PatentContinuityResponse

Имя	Путь	Тип	Описание
count	count	integer
patentFileWrapperDataBag	patentFileWrapperDataBag	array of object
applicationNumberText	patentFileWrapperDataBag.applicationNumberText	string	Бесплатный формат номера приложения
parentContinuityBag	patentFileWrapperDataBag.parentContinuityBag	array of ParentContinuityData
childContinuityBag	patentFileWrapperDataBag.childContinuityBag	array of ChildContinuityData
requestIdentifier	requestIdentifier	string

ParentContinuityData

Имя	Путь	Тип	Описание
parentApplicationNumberText	parentApplicationNumberText	string	Номер родительского приложения
relationType	relationType	string	Тип родительской связи
заявок	filingDate	date
patentNumber	patentNumber	string
publicationNumber	publicationNumber	string
IssueDate	issueDate	date

ChildContinuityData

Имя	Путь	Тип	Описание
childApplicationNumberText	childApplicationNumberText	string	Номер дочернего приложения
relationType	relationType	string	Тип дочерней связи
заявок	filingDate	date
patentNumber	patentNumber	string
publicationNumber	publicationNumber	string
IssueDate	issueDate	date

PatentForeignPriorityResponse

Имя	Путь	Тип	Описание
count	count	integer
patentFileWrapperDataBag	patentFileWrapperDataBag	array of object
applicationNumberText	patentFileWrapperDataBag.applicationNumberText	string	Бесплатный формат номера приложения
foreignPriorityBag	patentFileWrapperDataBag.foreignPriorityBag	array of ForeignPriority
requestIdentifier	requestIdentifier	string

ForeignPriority

Имя	Путь	Тип	Описание
foreignApplicationNumberText	foreignApplicationNumberText	string	Номер приложения внешнего приоритета
foreignFilingDate	foreignFilingDate	date	Дата подачи внешнего приоритета
foreignCountryCode	foreignCountryCode	string	Двухбуквенный код страны ISO для иностранной подачи
foreignCountryName	foreignCountryName	string	Имя иностранной страны
foreignPatentOffice	foreignPatentOffice	string	Идентификатор иностранного патента
kindCode	kindCode	string	Код типа для внешней публикации
relationType	relationType	string	Тип связи (например, Priority, Parent)
internationalFilingIndicator	internationalFilingIndicator	string	Указывает, была ли отправка международной (РСТ)
translationRequired	translationRequired	boolean	Указывает, требуется ли перевод

PatentTransactionResponse

Имя	Путь	Тип	Описание
count	count	integer
patentFileWrapperDataBag	patentFileWrapperDataBag	array of object
applicationNumberText	patentFileWrapperDataBag.applicationNumberText	string	Бесплатный формат номера приложения
eventDataBag	patentFileWrapperDataBag.eventDataBag	array of EventData
requestIdentifier	requestIdentifier	string

Данные события

Имя	Путь	Тип	Описание
eventCode	eventCode	string	Код или метка для события обвинения
eventDescription	eventDescription	string	Текстовое описание события
eventDate	eventDate	string	Дата возникновения события
eventCategory	eventCategory	string	Категория события
documentCode	documentCode	string	Код, определяющий связанный документ
documentName	documentName	string	Имя связанного документа
имя корреспондента	correspondentName	string	Корреспондент, связанный с событием
transactionId	transactionId	string	Уникальный идентификатор транзакции
размер файла	fileSize	integer	Размер файла в байтах связанного документа, если таковой есть
downloadUrl	downloadUrl	string	URL-адрес для скачивания связанного документа

PatentDocumentResponse

Имя	Путь	Тип
count	count	integer
Документы	documents	array of DocumentBag
requestIdentifier	requestIdentifier	string

DocumentBag

Имя	Путь	Тип	Описание
documentCode	documentCode	string	Код, определяющий тип документа
documentDescription	documentDescription	string	Описание типа документа
documentCategory	documentCategory	string	Категория документа (входящий или исходящий)
officialDate	officialDate	date	Официальная дата, связанная с документом
createDate	createDate	date	Документ date был создан в системе
размер файла	fileSize	integer	Размер файла документа в байтах
documentUrl	documentUrl	string	URL-адрес для получения или скачивания документа
documentPageCount	documentPageCount	integer	Количество страниц в документе
имя отправки	submitterName	string	Имя отправляющей стороны
examinerName	examinerName	string	Проверяющий, связанный с документом
artUnit	artUnit	string	Подразделение искусства, ответственное за документ

PatentAssociatedDocumentsResponse

Имя	Путь	Тип	Описание
count	count	integer
patentFileWrapperDataBag	patentFileWrapperDataBag	array of object
applicationNumberText	patentFileWrapperDataBag.applicationNumberText	string	Бесплатный формат номера приложения
pgpubDocumentMetaData	patentFileWrapperDataBag.pgpubDocumentMetaData	PGPubFileMetaData
grantDocumentMetaData	patentFileWrapperDataBag.grantDocumentMetaData	GrantFileMetaData
requestIdentifier	requestIdentifier	string

PGPubFileMetaData

Имя	Путь	Тип	Описание
publicationNumber	publicationNumber	string	Номер публикации для предварительной публикации
publicationDate	publicationDate	date	Дата публикации предварительного предоставления
kindCode	kindCode	string	Тип кода для публикации
title	title	string	Название публикации
имя претендента	applicantName	string	Заявитель или назначенный получатель, указанный на публикации
documentUrl	documentUrl	string	URL-адрес для получения документа публикации

GrantFileMetaData

Имя	Путь	Тип	Описание
patentNumber	patentNumber	string	Предоставленный номер патента
grantDate	grantDate	date	Дата предоставления патента
kindCode	kindCode	string	Код типа для предоставленного патента
title	title	string	Название предоставленного патента
assigneeName	assigneeName	string	Назначаемый получатель, указанный при предоставлении
issueClassification	issueClassification	string	Первичная классификация предоставленных патентов
documentUrl	documentUrl	string	URL-адрес для получения предоставленного патентного документа

StatusCodeSearchResponse

Структура ответа для результатов поиска кода состояния патента.

Имя	Путь	Тип	Описание
count	count	integer	Число возвращенных кодов состояния.
patentFileWrapperDataBag	patentFileWrapperDataBag	array of object	Массив записей кода состояния патента.
applicationStatusCode	patentFileWrapperDataBag.applicationStatusCode	integer	Уникальный числовый или буквенно-цифровой код состояния.
applicationStatusDescriptionText	patentFileWrapperDataBag.applicationStatusDescriptionText	string	Описание состояния приложения.
statusCategoryName	patentFileWrapperDataBag.statusCategoryName	string	Группирование категорий состояния, если доступно.
statusEffectiveDate	patentFileWrapperDataBag.statusEffectiveDate	date	Дата действия этого кода состояния.
statusTerminationIndicator	patentFileWrapperDataBag.statusTerminationIndicator	boolean	Указывает, представляет ли статус прекращение судебного преследования.
requestIdentifier	patentFileWrapperDataBag.requestIdentifier	string	Уникальный идентификатор запроса для вызовов API трассировки.
requestIdentifier	requestIdentifier	string	Уникальный идентификатор для всего вызова API.

BdssResponseProductBag

Подробный ответ для конкретного продукта массового набора данных USPTO.

Имя	Путь	Тип	Описание
count	count	integer	Количество возвращенных записей файла продукта.
patentFileWrapperDataBag	patentFileWrapperDataBag	array of object	Массив, содержащий метаданные продукта и необязательные сведения о файле.
productIdentifier	patentFileWrapperDataBag.productIdentifier	string	Уникальный идентификатор продукта набора данных (короткое имя).
названиеПродукта	patentFileWrapperDataBag.productName	string	Удобочитаемое человеком имя продукта.
productDescription	patentFileWrapperDataBag.productDescription	string	Описание содержимого набора данных.
productVersion	patentFileWrapperDataBag.productVersion	string	Версия набора данных.
publicationDate	patentFileWrapperDataBag.publicationDate	date	Дата публикации набора данных.
productType	patentFileWrapperDataBag.productType	string	Тип файла набора данных (например, XML, JSON, CSV).
recordCount	patentFileWrapperDataBag.recordCount	integer	Количество записей в наборе данных.
downloadUrl	patentFileWrapperDataBag.downloadUrl	string	Прямая ссылка для скачивания набора данных.
контрольная сумма	patentFileWrapperDataBag.checksum	string	Контрольная сумма файлов для проверки целостности.
includeFiles	patentFileWrapperDataBag.includeFiles	boolean	Были ли файлы продукта включены в ответ.
productFiles	patentFileWrapperDataBag.productFiles	array of object	Список связанных файлов набора данных (если они включены).
fileName	patentFileWrapperDataBag.productFiles.fileName	string	Имя файла набора данных.
размер файла	patentFileWrapperDataBag.productFiles.fileSize	integer	Размер файла в байтах.
fileDataDate	patentFileWrapperDataBag.productFiles.fileDataDate	date	Дата, связанная с содержимым набора данных файла.
fileUrl	patentFileWrapperDataBag.productFiles.fileUrl	string	Прямая ссылка для скачивания файла.
контрольная сумма	patentFileWrapperDataBag.productFiles.checksum	string	Контрольная сумма файлов для проверки.
requestIdentifier	patentFileWrapperDataBag.requestIdentifier	string	Уникальный идентификатор запроса для трассировки.

BdssResponseBag

Структура ответа для результатов поиска массового набора данных USPTO.

Имя	Путь	Тип	Описание
count	count	integer	Количество возвращаемых продуктов набора данных.
patentFileWrapperDataBag	patentFileWrapperDataBag	array of object	Массив объектов метаданных набора данных.
productCode	patentFileWrapperDataBag.productCode	string	Уникальный идентификатор продукта или набора данных.
названиеПродукта	patentFileWrapperDataBag.productName	string	Доступное для чтения имя продукта набора данных.
productDescription	patentFileWrapperDataBag.productDescription	string	Описание содержимого набора данных.
productVersion	patentFileWrapperDataBag.productVersion	string	Номер версии набора данных.
productType	patentFileWrapperDataBag.productType	string	Тип набора данных (например, XML, JSON, CSV).
publicationDate	patentFileWrapperDataBag.publicationDate	date	Дата публикации набора данных.
recordCount	patentFileWrapperDataBag.recordCount	integer	Количество записей, доступных в наборе данных.
downloadUrl	patentFileWrapperDataBag.downloadUrl	string	Прямой URL-адрес для скачивания набора данных.
контрольная сумма	patentFileWrapperDataBag.checksum	string	Контрольная сумма SHA или MD5 для проверки файла набора данных.
requestIdentifier	patentFileWrapperDataBag.requestIdentifier	string	Уникальный идентификатор запроса для трассировки.
requestIdentifier	requestIdentifier	string	Уникальный идентификатор запроса для вызова API.

ПетицияDecisionResponseBag

Ответ на поиск решения петиции.

Имя	Путь	Тип	Описание
count	count	integer	Количество соответствующих записей.
петицияDecisionDataBag	petitionDecisionDataBag	array of object	Массив записей о решении петиции.
петицияDecisionRecordIdentifier	petitionDecisionDataBag.petitionDecisionRecordIdentifier	string	Уникальный идентификатор записи о решении петиции.
patentNumber	petitionDecisionDataBag.patentNumber	string	Номер патента, связанный с петицией.
firstApplicantName	petitionDecisionDataBag.firstApplicantName	string	Имя первого заявителя.
петицияMailDate	petitionDecisionDataBag.petitionMailDate	string	Дата сообщения петиции.
decisionTypeCodeDescriptionText	petitionDecisionDataBag.decisionTypeCodeDescriptionText	string	Результат принятия решений.
decisionMailDate	petitionDecisionDataBag.decisionMailDate	string	Дата почты принятия решений.
finalDecidingOfficeName	petitionDecisionDataBag.finalDecidingOfficeName	string	Имя окончательного решения офиса.
decisionDate	petitionDecisionDataBag.decisionDate	string	Дата принятия решения.
technologyCenter	petitionDecisionDataBag.technologyCenter	string	Технологический центр, связанный с петицией.
Аспекты	facets	object	Количество фасетных полей.
requestIdentifier	requestIdentifier	string	Уникальный идентификатор запроса API.

ПетицияDecisionIdentifierResponseBag

Объект ответа, содержащий сведения о решении петиции для определенного идентификатора.

Имя	Путь	Тип	Описание
петицияDecisionRecordIdentifier	petitionDecisionRecordIdentifier	string	Уникальный идентификатор записи о решении петиции.
patentNumber	patentNumber	string	Номер патента, связанный с решением петиции.
firstApplicantName	firstApplicantName	string	Имя первого заявителя.
петицияMailDate	petitionMailDate	string	Дата сообщения петиции.
decisionDate	decisionDate	string	Дата принятия решения.
decisionMailDate	decisionMailDate	string	Дата отправки решения.
decisionTypeCodeDescriptionText	decisionTypeCodeDescriptionText	string	Описание типа решения.
finalDecidingOfficeName	finalDecidingOfficeName	string	Имя офиса или подразделения, которое принял окончательное решение.
петицияDecisionDocuments	petitionDecisionDocuments	array of object	Список метаданных документа принятия решений (в том числе, если `includeDocuments=true`).
documentName	petitionDecisionDocuments.documentName	string
documentType	petitionDecisionDocuments.documentType	string
documentSize	petitionDecisionDocuments.documentSize	string
documentUrl	petitionDecisionDocuments.documentUrl	string
requestIdentifier	requestIdentifier	string	Уникальный идентификатор запроса API.