USPTO

USPTO PatentsView API

USPTO research-oriented patent data API with inventor disambiguation, assignee, location, CPC/USPC classification, and citation endpoints. The database integrates the best available tools for inventor disambiguation and data quality control, supporting bibliometric and innovation research. PatentsView migrated into the USPTO Open Data Portal on March 20, 2026 — clients should obtain an ODP API key and use the ODP-hosted endpoints going forward.

USPTO PatentsView API is one of 6 APIs that USPTO publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Patents, Inventors, Research, Disambiguation, and Government. The published artifact set on APIs.io includes API documentation and an OpenAPI specification.

Documentation GitHub OpenAPI

Documentation

📖

Documentation

https://developer.uspto.gov/api-catalog/patentsview

📖

Documentation

https://patentsview.org/apis/api-endpoints

Specifications

⚙

OpenAPI

https://raw.githubusercontent.com/api-evangelist/uspto-gov/refs/heads/main/openapi/uspto-patentsview-openapi.yml

OpenAPI Specification

openapi: 3.0.3
info:
  title: USPTO PatentsView API
  version: '1.0'
  description: |
    USPTO research-focused patent data API with inventor disambiguation, assignee, location,
    CPC/USPC classification, and citation endpoints. Original endpoints at PatentsView.org;
    migrated to the USPTO Open Data Portal (data.uspto.gov) on March 20, 2026. Clients should
    use an ODP API key going forward.
  contact: {name: USPTO API Help, email: [email protected]}
servers:
- url: https://api.uspto.gov
  description: USPTO Open Data Portal
- url: https://search.patentsview.org
  description: Legacy PatentsView
security:
- ApiKeyAuth: []
paths:
  /api/v1/patentsview/patents:
    get:
      summary: Query Patents
      operationId: queryPatents
      parameters:
      - {name: q, in: query, schema: {type: string}, description: JSON query expression}
      - {name: f, in: query, schema: {type: string}, description: Comma-separated field list}
      - {name: s, in: query, schema: {type: string}, description: Sort spec}
      - {name: o, in: query, schema: {type: string}, description: Pagination options}
      responses:
        '200':
          description: Patent records
          content:
            application/json:
              schema: {$ref: '#/components/schemas/PatentsViewResponse'}
  /api/v1/patentsview/inventors:
    get:
      summary: Query Inventors
      operationId: queryInventors
      parameters:
      - {name: q, in: query, schema: {type: string}}
      - {name: f, in: query, schema: {type: string}}
      - {name: o, in: query, schema: {type: string}}
      responses:
        '200':
          description: Inventor records (with disambiguation IDs)
          content:
            application/json:
              schema: {type: object}
  /api/v1/patentsview/assignees:
    get:
      summary: Query Assignees
      operationId: queryAssignees
      parameters:
      - {name: q, in: query, schema: {type: string}}
      - {name: f, in: query, schema: {type: string}}
      - {name: o, in: query, schema: {type: string}}
      responses:
        '200':
          description: Assignee records
          content:
            application/json:
              schema: {type: object}
  /api/v1/patentsview/locations:
    get:
      summary: Query Locations
      operationId: queryLocations
      parameters:
      - {name: q, in: query, schema: {type: string}}
      - {name: f, in: query, schema: {type: string}}
      responses:
        '200':
          description: Location records
          content:
            application/json:
              schema: {type: object}
  /api/v1/patentsview/cpc_subsections:
    get:
      summary: Query CPC Subsections
      operationId: queryCpcSubsections
      parameters:
      - {name: q, in: query, schema: {type: string}}
      - {name: f, in: query, schema: {type: string}}
      responses:
        '200':
          description: CPC subsection records
          content:
            application/json:
              schema: {type: object}
components:
  securitySchemes:
    ApiKeyAuth: {type: apiKey, in: header, name: X-API-KEY}
  schemas:
    PatentsViewResponse:
      type: object
      properties:
        count: {type: integer}
        total_patent_count: {type: integer}
        patents:
          type: array
          items:
            type: object
            properties:
              patent_number: {type: string}
              patent_title: {type: string}
              patent_date: {type: string, format: date}
              patent_type: {type: string}
              inventors:
                type: array
                items:
                  type: object
                  properties:
                    inventor_id: {type: string}
                    inventor_first_name: {type: string}
                    inventor_last_name: {type: string}
              assignees:
                type: array
                items:
                  type: object
                  properties:
                    assignee_id: {type: string}
                    assignee_organization: {type: string}