{
  "openapi": "3.0.1",
  "info": {
    "title": "USPTO Patent Search — New Patent Alerts",
    "description": "Search USPTO's official US patent index by keyword, assignee, inventor or CPC class — publication number, title, assignee, inventor, filing/publication/priority dates, application number, CPC codes and the official USPTO PDF. Monitoring mode: only-new US patents. $0.004 per patent, no start fee.",
    "version": "0.0",
    "x-build-id": "Vjm5h8KSAENc6TEHI"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/magnova~uspto-patent-search/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-magnova-uspto-patent-search",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/magnova~uspto-patent-search/runs": {
      "post": {
        "operationId": "runs-sync-magnova-uspto-patent-search",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/magnova~uspto-patent-search/run-sync": {
      "post": {
        "operationId": "run-sync-magnova-uspto-patent-search",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "assignees": {
            "title": "Assignees (optional — empty = all)",
            "type": "array",
            "description": "Optional assignee filter: only patents whose recorded assignee matches one of these names (USPTO's assignee name search — organisation names as recorded, e.g. \"Toyota\", \"Samsung Electronics\"). Several names are combined with OR. One honest limit: the filter matches the recorded assignee, so a brand-new application that lists only an applicant is not matched by it until an assignee is recorded. Leave empty for all assignees.",
            "items": {
              "type": "string"
            }
          },
          "backfillDays": {
            "title": "Publication days back",
            "minimum": 1,
            "maximum": 92,
            "type": "integer",
            "description": "How many publication days back the run covers, counting back from yesterday (the last complete publication day — a closed window keeps repeat runs over it identical). The window is ignored when Date from / Date to are set. Scheduled monitoring runs typically use 2-3 days of lookback plus a monitor store, so a missed day never loses patents."
          },
          "cpcCodes": {
            "title": "CPC codes (optional — empty = all)",
            "type": "array",
            "description": "Optional filter: only patents classified under one of these CPC (Cooperative Patent Classification) symbols, e.g. \"G06N\" (the whole subclass), \"G06N20/00\" (machine learning — a main group also returns its subgroups, e.g. G06N20/10), \"H04L9/00\" (cryptographic mechanisms). Leave empty for all classes.",
            "items": {
              "type": "string"
            }
          },
          "dateFrom": {
            "title": "Date from (optional, overrides days back)",
            "type": "string",
            "description": "Optional explicit window start (ISO date, e.g. \"2026-10-01\"). Must be given together with Date to, and overrides Publication days back. Useful for one-off corpus pulls (e.g. a quarter of publications)."
          },
          "dateTo": {
            "title": "Date to (optional)",
            "type": "string",
            "description": "Optional explicit window end (ISO date, e.g. \"2026-10-31\"). Must be given together with Date from. Maximum window: 366 days."
          },
          "inventors": {
            "title": "Inventors (optional — empty = all)",
            "type": "array",
            "description": "Optional inventor filter: only patents whose first-listed inventor matches one of these names (USPTO's inventor name search). The index stores inventors surname-first, so \"Goodenough\" or \"Goodenough John\" work best; a \"First Last\" entry is also tried surname-first automatically. Several names are combined with OR. Leave empty for all inventors.",
            "items": {
              "type": "string"
            }
          },
          "maxResults": {
            "title": "Maximum patents per run",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Hard cap on patents delivered (and charged) in one run, across all searches in the run. Patents a capped run could not deliver stay unseen in monitoring mode and are delivered by the next run if they still fall in its window."
          },
          "maxTotalChargeUsd": {
            "title": "Maximum total charge per run (USD)",
            "minimum": 0.01,
            "type": "number",
            "description": "Optional hard stop for this run's charges: delivery stops as soon as the charged patents reach this amount (checked conservatively at the highest per-patent price, so the run may stop slightly early on discounted tiers), and the SUMMARY record reports stoppedByMaxCharge. Undelivered new patents stay unseen, so the next run delivers them. Leave empty for no cap. The run-level maximum charge in the run options is also honoured exactly."
          },
          "monitorOnlyNew": {
            "title": "Start monitoring silently (skip the first baseline)",
            "type": "boolean",
            "description": "Off (default): the first run delivers the window's current patents as a baseline batch (charged), later runs deliver only new ones. On: the first run silently remembers the current patents without delivering or charging anything, and only patents published afterwards are ever delivered. Only applies when a monitor store is selected; without a store every run is a baseline run."
          },
          "monitorStore": {
            "title": "Monitor state store (for only-new delivery)",
            "type": "string",
            "description": "A key-value store this Actor may read and write to remember which patents it has already seen — this is what makes only-new delivery work across runs. Pick any store you own; the Actor keeps one small state record in it. Without a store, every run delivers the window's patents as a baseline and remembers nothing. If the store is missing or cannot be opened, the run continues in baseline mode and the SUMMARY record says so — it never crashes. The Actor remembers every patent it processed (including ones outside the window), so widening the window later does not re-deliver old patents."
          },
          "publishedSince": {
            "title": "Published on/after (stateless cursor)",
            "type": "string",
            "description": "Optional stateless cursor for workflow tools (Make, Zapier, your own scheduler) that hold state themselves: only patents published on this ISO date or later are delivered — for example \"2026-11-01\" or \"2026-11-01T00:00:00Z\". Publication dates are day-granular, so the cursor compares by day, boundary-inclusive. The cursor raises the window start; it does not extend the window end. Leave empty for the normal window behavior."
          },
          "queries": {
            "title": "Keyword queries",
            "type": "array",
            "description": "Keyword searches, one search per entry (e.g. \"machine learning\", \"solid state battery electrolyte\"). Every other filter in the run (assignees, inventors, CPC codes, window) applies to each search. A patent found by several searches is delivered — and charged — once. Leave empty to search by filters alone (e.g. one assignee's whole output). At least the publication window always bounds the run.",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}