{ "openapi": "3.0.1", "info": { "title": "EPO Patent Search & Monitor – European Patents, No API Key", "description": "Search new European patent applications and EP grants by title keyword, applicant or CPC class, using the EPO's official Linked Open EP Data. No API key, no login, no scraping. Monitor mode returns only new publications for weekly competitor or technology watches. $2 per 1,000.", "version": "0.1", "x-build-id": "zSB4ScAnX6iU78oJI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mabun~epo-patent-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mabun-epo-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/mabun~epo-patent-search/runs": { "post": { "operationId": "runs-sync-mabun-epo-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/mabun~epo-patent-search/run-sync": { "post": { "operationId": "run-sync-mabun-epo-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": { "keywords": { "title": "Title keywords (OR)", "type": "array", "description": "Any of these words must appear in the title of the invention (English, German or French title; case-insensitive substring match, so 'batter' matches 'battery'). Use EN and DE terms, e.g. hydrogen, Wasserstoff.", "items": { "type": "string" } }, "applicants": { "title": "Applicant names (OR)", "type": "array", "description": "Any of these strings must appear in an applicant name (case-insensitive substring), e.g. Siemens, Bosch, Fraunhofer.", "items": { "type": "string" } }, "cpcCodes": { "title": "CPC class prefixes (OR)", "type": "array", "description": "Cooperative Patent Classification prefixes, e.g. H01M (batteries), G06N (AI), Y02E (clean energy), A61K 31/ . Prefix match on inventive and additional CPC symbols.", "items": { "type": "string" } }, "publishedWithinDays": { "title": "Published within the last N days", "minimum": 1, "maximum": 366, "type": "integer", "description": "Time window ending today. Ignored if dateFrom is set. EP documents are published every Wednesday.", "default": 30 }, "dateFrom": { "title": "Published from (YYYY-MM-DD)", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Optional start of the publication date range. Max range 366 days per run." }, "dateTo": { "title": "Published to (YYYY-MM-DD)", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Optional end of the publication date range (default: today)." }, "publicationKinds": { "title": "Publication kinds", "enum": [ "all", "applications", "grants" ], "type": "string", "description": "Filter by document kind.", "default": "all" }, "titleLanguage": { "title": "Preferred title language", "enum": [ "en", "de", "fr" ], "type": "string", "description": "Language used for the 'title' field. All three titles are also returned separately.", "default": "en" }, "includeApplicants": { "title": "Include applicant names", "type": "boolean", "description": "Applicants are usually companies but can be natural persons. Turn off to omit applicant names. Inventors and representatives are never returned.", "default": true }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of publications returned (and charged) per run.", "default": 50 }, "onlyNew": { "title": "Monitor mode: only new publications", "type": "boolean", "description": "Remember returned publications and skip them in later runs with the same monitor ID. Combine with a schedule for a weekly patent watch.", "default": false }, "monitorId": { "title": "Monitor ID", "type": "string", "description": "Separate memory per watch, e.g. 'competitor-bosch'.", "default": "default" } } }, "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 } } } } } } } } } }