{ "openapi": "3.0.1", "info": { "title": "USPTO Patent & Trademark Scraper", "description": "[💰 $3.50 / 1K] Search and extract US patent and trademark records from the USPTO. Look up by keyword, inventor, assignee, or classification, or pull specific patent and trademark numbers — get titles, abstracts, owners, inventors, dates, status, and classifications.", "version": "1.0", "x-build-id": "LRMAkWcZcFJqQ1Zso" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~uspto-patent-trademark-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-uspto-patent-trademark-scraper", "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/solidcode~uspto-patent-trademark-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-uspto-patent-trademark-scraper", "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/solidcode~uspto-patent-trademark-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-uspto-patent-trademark-scraper", "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": { "dataType": { "title": "What to search", "enum": [ "patents", "trademarks", "both" ], "type": "string", "description": "Choose whether to collect patents, trademarks, or both. Patents and trademarks are returned as separate record types in your results.", "default": "patents" }, "searchQuery": { "title": "Search keywords", "type": "string", "description": "Words to search for in patent titles, abstracts and claims (e.g. 'solar panel coating'). For trademarks, this matches the mark wording (e.g. 'Nike'). Leave empty if you are looking up specific patent or trademark numbers instead." }, "patentNumbers": { "title": "Patent numbers", "type": "array", "description": "Look up specific granted patents by number (e.g. '10123456' or 'US10123456B2'). One per line. Overrides the keyword search when provided.", "items": { "type": "string" } }, "trademarkNumbers": { "title": "Trademark serial or registration numbers", "type": "array", "description": "Look up specific trademarks by serial number (e.g. '78787878') or registration number (e.g. '2345678'). One per line. Overrides the keyword search when provided.", "items": { "type": "string" } }, "inventor": { "title": "Inventor name", "type": "string", "description": "Only return patents listing this inventor (e.g. 'Jane Smith'). Applies to patents only." }, "assignee": { "title": "Owner / assignee", "type": "string", "description": "Only return patents owned by or assigned to this company or person (e.g. 'Apple Inc'). Applies to patents only." }, "cpcClass": { "title": "Classification code (CPC)", "type": "string", "description": "Only return patents in this Cooperative Patent Classification code (e.g. 'H04L' for digital data transmission). Applies to patents only." }, "dateFrom": { "title": "Date from", "type": "string", "description": "Only include patents granted on or after this date. Format: YYYY-MM-DD (e.g. '2020-01-01')." }, "dateTo": { "title": "Date to", "type": "string", "description": "Only include patents granted on or before this date. Format: YYYY-MM-DD (e.g. '2023-12-31')." }, "maxResults": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Maximum number of records to return per search. Set to 0 to collect every match — but note that broad searches can have hundreds of thousands of results, so set a number to cap how many are returned. Tip: start with 10-50 to test, then increase.", "default": 100 } } }, "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 } } }, "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 } } } } } } } } } }