{ "openapi": "3.0.1", "info": { "title": "Global Trademark Search Scraper - 77 Offices Worldwide", "description": "Search 145M+ trademarks from 77 national and regional registers at once: mark text, owner name and address, representative, status, Nice classes, goods and services wording, oppositions, priority and seniority claims. JSON, CSV, Excel.", "version": "0.1", "x-build-id": "UAWtDzeFH1KFMnJWf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~tmview-global-trademarks-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-tmview-global-trademarks-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/scrapers_lat~tmview-global-trademarks-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-tmview-global-trademarks-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/scrapers_lat~tmview-global-trademarks-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-tmview-global-trademarks-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": { "maxTrademarks": { "title": "Max Trademarks", "minimum": 1, "maximum": 5000000, "type": "integer", "description": "Maximum number of trademarks to collect. The combined registers hold over 145 million marks, so for large pulls narrow the search with the filters below." }, "markTexts": { "title": "Trademark Text", "type": "array", "description": "One or more brand names or mark words to search for. Each entry runs as its own search and the results are merged and de-duplicated.", "items": { "type": "string" } }, "applicantNames": { "title": "Owner / Applicant Name", "type": "array", "description": "One or more trademark owners to search for, for example \"Nestle\" or \"Siemens\". Each entry runs as its own search.", "items": { "type": "string" } }, "matchMode": { "title": "Match Mode", "enum": [ "contains", "exact", "beginsWith", "word", "fuzzy" ], "type": "string", "description": "How the trademark text is matched. \"Contains\" is the widest, \"Exact\" the narrowest, \"Fuzzy\" also catches near-identical spellings used in clearance searches.", "default": "contains" }, "offices": { "title": "Trademark Offices", "type": "array", "description": "Restrict the search to specific registers. Leave empty to search all 77 offices at once. Use the two-letter office code, for example US, EM (European Union), CN, GB, DE, BR, JP, WO (Madrid international).", "items": { "type": "string", "enum": [ "AL", "AR", "AT", "AU", "BA", "BG", "BN", "BR", "BX", "BZ", "CA", "CH", "CL", "CN", "CO", "CR", "CU", "CY", "CZ", "DE", "DK", "DO", "EE", "EG", "EM", "ES", "FI", "FR", "GB", "GE", "GR", "HR", "HU", "IE", "IL", "IN", "IS", "IT", "JO", "JP", "KH", "KR", "LA", "LI", "LT", "LV", "MA", "MC", "MD", "ME", "MK", "MT", "MX", "MY", "NO", "NZ", "PE", "PH", "PL", "PT", "PY", "RO", "RS", "RU", "SE", "SI", "SK", "SM", "TH", "TN", "TR", "TT", "UA", "US", "UY", "VN", "WO" ], "enumTitles": [ "Albania", "Argentina", "Austria", "Australia", "Bosnia and Herzegovina", "Bulgaria", "Brunei", "Brazil", "Benelux", "Belize", "Canada", "Switzerland", "Chile", "China", "Colombia", "Costa Rica", "Cuba", "Cyprus", "Czechia", "Germany", "Denmark", "Dominican Republic", "Estonia", "Egypt", "European Union (EUIPO)", "Spain", "Finland", "France", "United Kingdom", "Georgia", "Greece", "Croatia", "Hungary", "Ireland", "Israel", "India", "Iceland", "Italy", "Jordan", "Japan", "Cambodia", "South Korea", "Laos", "Liechtenstein", "Lithuania", "Latvia", "Morocco", "Monaco", "Moldova", "Montenegro", "North Macedonia", "Malta", "Mexico", "Malaysia", "Norway", "New Zealand", "Peru", "Philippines", "Poland", "Portugal", "Paraguay", "Romania", "Serbia", "Russia", "Sweden", "Slovenia", "Slovakia", "San Marino", "Thailand", "Tunisia", "Turkiye", "Trinidad and Tobago", "Ukraine", "United States", "Uruguay", "Vietnam", "WIPO (Madrid international)" ] } }, "territories": { "title": "Protected In (Territory)", "type": "array", "description": "Keep only marks that are in force in these territories. Useful for EU-wide and Madrid marks, whose protection reaches far beyond the office that issued them. Two-letter country codes.", "items": { "type": "string" } }, "niceClasses": { "title": "Nice Classes", "type": "array", "description": "Restrict to these Nice classification classes (1-45), for example 9 for software, 25 for clothing, 35 for advertising and business services.", "items": { "type": "string" } }, "trademarkStatus": { "title": "Status", "type": "array", "description": "Restrict to marks in these states. Leave empty for all.", "items": { "type": "string", "enum": [ "Registered", "Filed", "Expired", "Ended" ], "enumTitles": [ "Registered", "Filed (pending)", "Expired", "Ended / withdrawn" ] } }, "trademarkTypes": { "title": "Mark Type", "type": "array", "description": "Restrict to these kinds of mark, for example word marks only or figurative marks only.", "items": { "type": "string", "enum": [ "Word", "Figurative", "Combined", "3D shape", "Stylized characters", "Sound", "Colour", "Combination of colours", "Hologram", "Motion", "Multimedia", "Position", "Pattern", "General mark", "Other" ], "enumTitles": [ "Word", "Figurative", "Combined", "3D shape", "Stylized characters", "Sound", "Colour", "Combination of colours", "Hologram", "Motion", "Multimedia", "Position", "Pattern", "General mark", "Other" ] } }, "viennaCodes": { "title": "Vienna Codes", "type": "array", "description": "Restrict figurative marks to these Vienna classification codes, for example 26.11.12 for horizontal stripes.", "items": { "type": "string" } }, "applicationDateFrom": { "title": "Filed From", "type": "string", "description": "Only marks filed on or after this date (YYYY-MM-DD)." }, "applicationDateTo": { "title": "Filed To", "type": "string", "description": "Only marks filed on or before this date (YYYY-MM-DD)." }, "registrationDateFrom": { "title": "Registered From", "type": "string", "description": "Only marks registered on or after this date (YYYY-MM-DD)." }, "registrationDateTo": { "title": "Registered To", "type": "string", "description": "Only marks registered on or before this date (YYYY-MM-DD)." }, "fetchFullRecord": { "title": "Fetch Full Record", "type": "boolean", "description": "Open each mark's full register record for goods and services wording, priority and seniority claims, oppositions with grounds and earlier marks, publications and status history. Turn off for a faster, lighter list-only run.", "default": true }, "fetchPartyDetails": { "title": "Fetch Owner & Representative Details", "type": "boolean", "description": "Also look up the owner and representative postal address at the publishing office. Available for many offices; a few publish party details only through a channel that refuses automated requests, and those rows are flagged instead of guessed.", "default": true }, "goodsServicesLanguage": { "title": "Goods & Services Language", "type": "string", "description": "Preferred language for the goods and services wording, as a two-letter code. Falls back to English, then to whatever the office published.", "default": "en" }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "The registers throttle datacenter traffic, so residential proxies are used by default. Leave as is unless you know you need something different.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }