{ "openapi": "3.0.1", "info": { "title": "Google Patents Scraper", "description": "Google Patents Scraper: Extract patent titles, inventors, assignees, filing dates, publication numbers, classifications, abstracts, claims, citations, and patent URLs. Build structured datasets for patent research, technology analysis, competitor monitoring, and intellectual property intelligence.", "version": "1.1", "x-build-id": "4B9RwGObeSrvjq2Nm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapier~google-patents-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapier-google-patents-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/scrapier~google-patents-scraper/runs": { "post": { "operationId": "runs-sync-scrapier-google-patents-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/scrapier~google-patents-scraper/run-sync": { "post": { "operationId": "run-sync-scrapier-google-patents-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": { "urls": { "title": "๐Ÿ”— Patent & search links", "type": "array", "description": "โœ… One entry per line: patent URLs, search URLs (q=), or plain keywords (e.g. machine learning). Plain lines are search phrases. All entries OR-merge with the Keywords field.", "items": { "type": "string" } }, "searchQuery": { "title": "๐Ÿ”ค Keywords", "type": "string", "description": "๐Ÿ’ก Main keyword search. Works together with URLs: your text is OR-merged with any q= from search URLs and with publication numbers from patent URLs so you get a broad combined result.", "default": "" }, "patentNumbers": { "title": "๐Ÿ”ข Publication numbers", "type": "array", "description": "๐Ÿ“‹ Specific patent IDs. Combined with keywords using OR so you still get broad results when both are set.", "default": [], "items": { "type": "string" } }, "assignee": { "title": "๐Ÿข Assignee", "type": "string", "description": "๐Ÿญ Focus on patents owned by a particular organization.", "default": "" }, "inventor": { "title": "๐Ÿ‘ค Inventor", "type": "string", "description": "๐Ÿง‘โ€๐Ÿ”ฌ Find patents listing a specific inventor.", "default": "" }, "country": { "title": "๐ŸŒ Patent office / region", "enum": [ "ANY", "US", "EP", "WO", "CN", "JP", "KR", "DE", "GB", "FR", "CA", "AU", "IN", "BR", "TW", "RU", "IT", "ES", "NL", "SE", "CH", "AT", "HK", "SG", "MX", "NO", "DK", "FI", "PL", "IL", "NZ", "ZA", "SA", "AR", "TH", "MY", "PH", "ID", "VN" ], "type": "string", "description": "๐Ÿ—บ๏ธ Pick a country or office โ€” or **Any** to search everywhere.", "default": "ANY" }, "dateFrom": { "title": "๐Ÿ“… Published after", "pattern": "^$|^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$|^(\\d+)\\s*(day|week|month|year)s?$", "type": "string", "description": "โณ Pick a **calendar date** or a **relative** range (e.g. *30 days*, *6 months*). Leave empty for no lower bound.", "default": "" }, "dateTo": { "title": "๐Ÿ“… Published before", "pattern": "^$|^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$|^(\\d+)\\s*(day|week|month|year)s?$", "type": "string", "description": "โณ Same as above โ€” absolute or relative. Leave empty for no upper bound.", "default": "" }, "patentType": { "title": "๐Ÿ“„ Document kind", "enum": [ "ANY", "PATENT", "APPLICATION", "DESIGN" ], "type": "string", "description": "๐Ÿ“‘ Limit to grants, applications, or designs โ€” or **Any** for all types.", "default": "ANY" }, "maxResults": { "title": "๐Ÿ”ข Max results", "minimum": 0, "type": "integer", "description": "๐ŸŽš๏ธ Cap how many patents to collect. Use **0** for no limit (be mindful of run time).", "default": 10 }, "includeFullText": { "title": "๐Ÿ“– Full description", "type": "boolean", "description": "๐Ÿ“œ Adds the full written description (large text).", "default": false }, "includeClaims": { "title": "โš–๏ธ Claims", "type": "boolean", "description": "๐Ÿ“‹ Adds the patent claims text.", "default": true }, "includeCitations": { "title": "๐Ÿ”— Citations", "type": "boolean", "description": "โ†ฉ๏ธ Adds backward and forward citation lists where available.", "default": true }, "includePatentFamily": { "title": "๐Ÿ‘จโ€๐Ÿ‘ฉโ€๐Ÿ‘ง Patent family", "type": "boolean", "description": "๐ŸŒ Adds related publications in the same family.", "default": true }, "includeClassifications": { "title": "๐Ÿท๏ธ CPC / IPC codes", "type": "boolean", "description": "๐Ÿงฎ Adds classification codes for analytics and filtering.", "default": true }, "proxyConfiguration": { "title": "๐Ÿ” Proxy", "type": "object", "description": "๐Ÿ›Ÿ Optional Apify Proxy settings. Leave default off if you donโ€™t need it." } } }, "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 } } } } } } } } } }