# EUIPO Trademark Scraper - EU Trademark Search & Monitoring (`jungle_synthesizer/euipo-trademark-scraper`) Actor Scrape EUIPO trademark database via eSearch API. Extract records: application/registration numbers, status, applicant, Nice classes, goods and services, opposition data, and mark type. Search by name, applicant, Nice class, date range, and status. For brand-protection teams and trademark attorneys. - **URL**: https://apify.com/jungle\_synthesizer/euipo-trademark-scraper.md - **Developed by:** [BowTiedRaccoon](https://apify.com/jungle_synthesizer) (community) - **Categories:** Other, Business, Lead generation - **Stats:** 2 total users, 1 monthly users, 77.8% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## EUIPO Trademark Scraper - EU Trademark Search & Monitoring Scrapes the EUIPO (EU Intellectual Property Office) trademark database via the eSearch internal API. Extract trademark records including application and registration numbers, status, applicant details, Nice classifications, goods and services descriptions, opposition data, Vienna figurative codes, and publication history. ### Features - Search by trademark name / word mark - Filter by applicant/owner name (exact match or wildcard, e.g. `Apple Inc.` or `Apple*`) - Filter by Nice classification class (1-45) - Filter by legal status (Registered, Application filed, Withdrawn, etc.) - Filter by application date range - Retrieves full detail via the `/copla/trademark/data/` API including: - Goods and services description (English) - Opposition filed count - Vienna figurative element codes - Priority claims - Madrid Protocol designations - Publication history ### Use Cases - **Brand protection** - monitor new filings that may conflict with your mark - **Trademark due diligence** - M&A and IP portfolio analysis - **Competitive analysis** - track trademark activity by applicant - **Trademark attorneys** - bulk data extraction for EUIPO filings ### Input | Field | Type | Description | |---|---|---| | `query` | String | Trademark name / word mark (e.g. `apple`) | | `applicationNumber` | String | Specific EUTM application number (e.g. `018123456`) | | `applicantName` | String | Applicant/owner name - exact match (e.g. `Apple Inc.`) or wildcard (e.g. `Apple*`) | | `niceClass` | Integer | Nice classification class (1-45). Use 0 for all classes | | `status` | Select | Filter by legal status | | `applicationDateFrom` | String | ISO date (YYYY-MM-DD) - earliest filing date | | `applicationDateTo` | String | ISO date (YYYY-MM-DD) - latest filing date | | `maxItems` | Integer | Maximum records to return (0 = unlimited) | At least one search criterion (query, applicationNumber, applicantName, niceClass, status, or date range) is required. ### Output Each record contains: | Field | Description | |---|---| | `application_number` | EUTM application number | | `registration_number` | Registration number (when registered) | | `office_code` | Office code (EM = EUIPO, WO = WIPO Madrid) | | `trademark_name` | Trademark name / word mark | | `trademark_type` | Mark type (Word, Figurative, 3D, Sound, etc.) | | `status` | Current legal status | | `application_date` | Filing date (ISO) | | `registration_date` | Registration date (ISO) | | `expiry_date` | Renewal/expiry date (ISO) | | `publication_date` | Last publication date (ISO) | | `applicant_name` | Applicant / owner name | | `applicant_country` | Applicant country code | | `applicant_address` | Full postal address | | `representative_name` | Representative / agent name | | `representative_country` | Representative country code | | `nice_classes` | Nice classes as comma-separated string | | `goods_and_services` | Full G&S description (English) | | `vienna_codes` | Vienna figurative element codes | | `image_url` | Trademark image URL | | `opposition_filed` | Whether any opposition was filed | | `opposition_count` | Number of oppositions | | `priority_claim` | Priority claim details | | `designations` | Madrid Protocol designated parties | | `url` | Permalink to EUIPO eSearch record | ### Technical Notes - Uses EUIPO's undocumented eSearch API (`/copla/ctmsearch/json`) via Chrome TLS fingerprint (impit) - Rate-limited to ~1-2 requests/second out of politeness - Applicant name search requires an exact name or wildcard suffix (`*`) - partial names without wildcards return 0 results - EUIPO application numbers are 9-digit strings prefixed with `018` (EUTM) or `WO` (Madrid) # Actor input Schema ## `sp_intended_usage` (type: `string`): Please describe how you plan to use the data extracted by this crawler. ## `sp_improvement_suggestions` (type: `string`): Provide any feedback or suggestions for improvements. ## `sp_contact` (type: `string`): Provide your email address so we can get in touch with you. ## `query` (type: `string`): Trademark name or word mark to search (e.g. 'apple', 'nike'). ## `applicationNumber` (type: `string`): Specific EUTM application number (e.g. 018123456). Leave blank to search by name. ## `applicantName` (type: `string`): Filter by applicant/owner name (exact match, e.g. 'Apple Inc.'). Use wildcard suffix e.g. 'Apple*' for partial match. ## `niceClass` (type: `integer`): Filter by Nice classification class (1-45). Set to 0 for all classes. ## `status` (type: `string`): Filter by trademark status. ## `applicationDateFrom` (type: `string`): ISO date filter (YYYY-MM-DD) — earliest application date. ## `applicationDateTo` (type: `string`): ISO date filter (YYYY-MM-DD) — latest application date. ## `maxItems` (type: `integer`): Maximum number of trademark records to return. Set to 0 for unlimited. ## Actor input object example ```json { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "query": "apple", "niceClass": 0, "maxItems": 10 } ```` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "query": "apple", "applicationNumber": "", "applicantName": "", "niceClass": 0, "status": "", "applicationDateFrom": "", "applicationDateTo": "", "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("jungle_synthesizer/euipo-trademark-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "query": "apple", "applicationNumber": "", "applicantName": "", "niceClass": 0, "status": "", "applicationDateFrom": "", "applicationDateTo": "", "maxItems": 10, } # Run the Actor and wait for it to finish run = client.actor("jungle_synthesizer/euipo-trademark-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "query": "apple", "applicationNumber": "", "applicantName": "", "niceClass": 0, "status": "", "applicationDateFrom": "", "applicationDateTo": "", "maxItems": 10 }' | apify call jungle_synthesizer/euipo-trademark-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=jungle_synthesizer/euipo-trademark-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "EUIPO Trademark Scraper - EU Trademark Search & Monitoring", "description": "Scrape EUIPO trademark database via eSearch API. Extract records: application/registration numbers, status, applicant, Nice classes, goods and services, opposition data, and mark type. Search by name, applicant, Nice class, date range, and status. For brand-protection teams and trademark attorneys.", "version": "0.1", "x-build-id": "aqIEfrr10l0Yb7scp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~euipo-trademark-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-euipo-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/jungle_synthesizer~euipo-trademark-scraper/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-euipo-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/jungle_synthesizer~euipo-trademark-scraper/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-euipo-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", "required": [ "sp_intended_usage", "sp_improvement_suggestions" ], "properties": { "sp_intended_usage": { "title": "What is the intended usage of this data?", "minLength": 1, "type": "string", "description": "Please describe how you plan to use the data extracted by this crawler." }, "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", "minLength": 1, "type": "string", "description": "Provide your email address so we can get in touch with you." }, "query": { "title": "Trademark Name Search", "type": "string", "description": "Trademark name or word mark to search (e.g. 'apple', 'nike')." }, "applicationNumber": { "title": "Application Number", "type": "string", "description": "Specific EUTM application number (e.g. 018123456). Leave blank to search by name." }, "applicantName": { "title": "Applicant Name", "type": "string", "description": "Filter by applicant/owner name (exact match, e.g. 'Apple Inc.'). Use wildcard suffix e.g. 'Apple*' for partial match." }, "niceClass": { "title": "Nice Class", "type": "integer", "description": "Filter by Nice classification class (1-45). Set to 0 for all classes.", "default": 0 }, "status": { "title": "Status Filter", "enum": [ "", "Registered", "Application filed", "Application published", "Registration expired", "Registration cancelled", "Registration surrendered", "Application withdrawn", "Application refused", "Application opposed" ], "type": "string", "description": "Filter by trademark status." }, "applicationDateFrom": { "title": "Application Date From", "type": "string", "description": "ISO date filter (YYYY-MM-DD) — earliest application date." }, "applicationDateTo": { "title": "Application Date To", "type": "string", "description": "ISO date filter (YYYY-MM-DD) — latest application date." }, "maxItems": { "title": "Max Items", "type": "integer", "description": "Maximum number of trademark records to return. Set to 0 for unlimited.", "default": 10 } } }, "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 } } } } } } } } } } ```