{ "openapi": "3.0.1", "info": { "title": "Espacenet Patent Scraper", "description": "Search global patent data from Espacenet (EPO) by keyword, applicant, inventor, IPC code, publication country or date range. Returns publication number, title, publication date, applicant, country and abstract for each matching patent.", "version": "1.0", "x-build-id": "FWBLrCNxb5uggPbuQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~espacenet-patent-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-espacenet-patent-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/jungle_synthesizer~espacenet-patent-scraper/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-espacenet-patent-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/jungle_synthesizer~espacenet-patent-scraper/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-espacenet-patent-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": { "sp_intended_usage": { "title": "What is the intended usage of this data?", "minLength": 1, "type": "string", "description": "What will this data feed? E.g. lead lists, KYB checks, price tracking." }, "sp_improvement_suggestions": { "title": "How can we improve this crawler for you?", "minLength": 1, "type": "string", "description": "Provide any feedback or suggestions for improvements." }, "sp_contact": { "title": "Contact email (optional)", "minLength": 1, "type": "string", "description": "We'll personally help with your use case. No spam." }, "searchQuery": { "title": "Search Query", "type": "string", "description": "Keyword search across patent titles and abstracts. Accepts plain text (searched as title+abstract) or raw EPO CQL syntax (e.g. ti=\"neural network\"). Leave empty when searching only by applicant, inventor or IPC code." }, "applicant": { "title": "Applicant / Company Name", "type": "string", "description": "Filter by patent applicant organization name (e.g. 'Siemens', 'Samsung Electronics')." }, "inventor": { "title": "Inventor Name", "type": "string", "description": "Filter by inventor name, format 'Last name, First name' (e.g. 'Mueller, Hans')." }, "ipcCode": { "title": "IPC Classification Code", "type": "string", "description": "Filter by International Patent Classification code (e.g. 'H04L', 'G06F')." }, "publicationCountries": { "title": "Publication Countries", "type": "array", "description": "Keep only patents whose publication number starts with one of these office/country codes (e.g. EP, WO, US). Leave empty for all countries. Applied after the search, over this actor's own extracted data.", "items": { "type": "string", "enum": [ "EP", "WO", "US", "DE", "FR", "GB", "JP", "CN", "KR", "CA", "AU", "IN", "BR", "RU" ], "enumTitles": [ "European Patent Office (EP)", "WIPO/PCT (WO)", "United States (US)", "Germany (DE)", "France (FR)", "United Kingdom (GB)", "Japan (JP)", "China (CN)", "South Korea (KR)", "Canada (CA)", "Australia (AU)", "India (IN)", "Brazil (BR)", "Russia (RU)" ] }, "default": [] }, "dateFrom": { "title": "Publication Date From", "type": "string", "description": "Keep only patents published on or after this date (YYYY-MM-DD or YYYY). Applied after the search, over this actor's own extracted publication date." }, "dateTo": { "title": "Publication Date To", "type": "string", "description": "Keep only patents published on or before this date (YYYY-MM-DD or YYYY). Applied after the search, over this actor's own extracted publication date." }, "maxItems": { "title": "Max Items", "type": "integer", "description": "Maximum number of patent records to return. Espacenet's public search shows at most 20 results per query (its own anonymous-access limit) — for broader coverage, run additional, more specific queries (narrower IPC code, applicant, or date range) rather than raising this above 20.", "default": 20 } } }, "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 } } } } } } } } } }