---
openapi: 3.1.0
info:
  title: Google Patents — SearchApi
  version: 3.1.0
  description: Generated from the SearchApi engine catalog. Parameters marked in the
    catalog as unverified are described from its records rather than from the vendor's
    specification.
servers:
- url: https://www.searchapi.io/api/v1
paths:
  "/search":
    get:
      operationId: google_patents
      summary: Google Patents
      parameters:
      - name: engine
        in: query
        required: true
        description: Engine that retrieves the data; fixed per API (see Apis::BY_ENGINE
          keys).
        schema:
          type: string
          const: google_patents
      - name: api_key
        in: query
        required: true
        description: 'SearchApi.io API key; alternatively send ''Authorization: Bearer
          <key>''.'
        schema:
          type: string
      - name: zero_retention
        in: query
        required: false
        description: 'Enterprise-only: disables all logging and persistent storage
          of the search.'
        schema:
          type: boolean
          default: false
      - name: q
        in: query
        required: true
        description: Search query; most engines accept native operators and advanced
          filters.
        schema:
          type: string
      - name: sort
        in: query
        required: false
        description: Order of the patent results.
        schema:
          type: string
          enum:
          - relevance
          - new
          - old
      - name: country
        in: query
        required: false
        description: Comma-separated patent office country codes, e.g. US,WO.
        schema:
          type: string
      - name: status
        in: query
        required: false
        description: Patent status filter.
        schema:
          type: string
          enum:
          - GRANT
          - APPLICATION
      - name: inventor
        in: query
        required: false
        description: Filter by inventor name.
        schema:
          type: string
      - name: assignee
        in: query
        required: false
        description: Filter by assignee name.
        schema:
          type: string
      - name: page
        in: query
        required: false
        description: Page number of the results.
        schema:
          type: integer
          default: 1
      - name: num
        in: query
        required: false
        description: Number of results per page.
        schema:
          type: integer
      responses:
        '200':
          description: A Google Patents result envelope.
