{ "openapi": "3.0.1", "info": { "title": "UK Trademark Scraper - UK IPO Register, Owners & Journal", "description": "Search the UK trade mark register (UK IPO) by mark, owner, number, Nice class, status or date: mark text, status, filing, registration and renewal dates, classes, goods and services, owner. Plus the IPO's weekly Trade Marks Journal with representatives, addresses and logos. No login.", "version": "0.1", "x-build-id": "KUTKKb1HVht3faX0O" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapersdelight~uk-trademark-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapersdelight-uk-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/scrapersdelight~uk-trademark-scraper/runs": { "post": { "operationId": "runs-sync-scrapersdelight-uk-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/scrapersdelight~uk-trademark-scraper/run-sync": { "post": { "operationId": "run-sync-scrapersdelight-uk-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", "properties": { "mode": { "title": "What to read", "enum": [ "register", "journal" ], "type": "string", "description": "Register = search all 3.6 million UK marks (live, pending and dead). Journal = the IPO's weekly Trade Marks Journal: every newly published application, with its representative and address.", "default": "register" }, "searchQueries": { "title": "Mark text", "type": "array", "description": "One or more marks, e.g. \"nike\", \"apple\", \"brewdog\". Register: searched on the mark text. Journal: filters the issue's marks by mark text.", "items": { "type": "string" } }, "matchMode": { "title": "Match", "enum": [ "contains", "exact", "beginsWith", "word", "fuzzy" ], "type": "string", "description": "How the mark text must match. Measured for \"nike\" on the register: contains 249, exact 57, begins with 121, whole word 99, similar spelling 3,365.", "default": "contains" }, "ownerNames": { "title": "Owner / applicant", "type": "array", "description": "Owner names, e.g. \"Nike Innovate C.V.\", \"Diageo\". Register: owner search (alone or with a mark). Journal: applicant name contains.", "items": { "type": "string" } }, "trademarkNumbers": { "title": "Trade mark numbers", "type": "array", "description": "Look up numbers, e.g. UK00003904654, 3904654, UK00912101689 (cloned EU mark). Journal mode also takes international registrations, e.g. WO0000001939971.", "items": { "type": "string" } }, "niceClasses": { "title": "Nice classes", "type": "array", "description": "Only marks covering any of these classes (1-45), e.g. 25 (clothing), 9 (software), 35 (retail), 42 (SaaS).", "items": { "type": "string" } }, "statuses": { "title": "Status", "type": "array", "description": "Registered, Filed (pending), Expired or Ended. Empty = all. On 2026-10-16: 2,325,043 registered, 72,398 pending, 1,265,253 expired, 11,725 ended.", "items": { "type": "string", "enum": [ "Registered", "Filed", "Expired", "Ended" ], "enumTitles": [ "Registered", "Filed (pending application)", "Expired", "Ended (refused, withdrawn, surrendered, invalidated)" ] } }, "markTypes": { "title": "Mark type", "type": "array", "description": "Word, Figurative (logo), 3D shape, Colour, Sound and so on. Empty = all.", "items": { "type": "string", "enum": [ "Word", "Figurative", "3D shape", "Colour", "Sound", "Position", "Pattern", "Motion", "Multimedia", "Hologram", "Other" ] } }, "viennaCodes": { "title": "Vienna codes", "type": "array", "description": "Figurative-element codes for logo searches, e.g. 27.05.21 (letters forming a monogram), 03.01 (cats, dogs). Register only.", "items": { "type": "string" } }, "filingDateFrom": { "title": "Filed from", "type": "string", "description": "Only marks filed on or after this date (YYYY-MM-DD)." }, "filingDateTo": { "title": "Filed until", "type": "string", "description": "Only marks filed on or before this date (YYYY-MM-DD)." }, "filedInLastDays": { "title": "Filed in the last N days", "minimum": 0, "maximum": 36500, "type": "integer", "description": "Rolling window for schedules, e.g. 7 = marks filed in the last week. Overrides \"Filed from\" when later. 0 = off.", "default": 0 }, "registrationDateFrom": { "title": "Registered from", "type": "string", "description": "Only marks entered in the register on or after this date (YYYY-MM-DD). Register only." }, "registrationDateTo": { "title": "Registered until", "type": "string", "description": "Only marks entered in the register on or before this date (YYYY-MM-DD). Register only." }, "openToOppositionOnly": { "title": "Open to opposition now", "type": "boolean", "description": "Only marks whose opposition period is running today (27,853 on the register on 2026-10-16). In journal mode: published less than two months ago.", "default": false }, "sortBy": { "title": "Sort", "enum": [ "relevance", "newest", "oldest", "name" ], "type": "string", "description": "Register order. Journal rows come in the IPO's own order.", "default": "relevance" }, "journalWeeks": { "title": "Latest issues", "minimum": 1, "maximum": 52, "type": "integer", "description": "How many of the latest weekly issues to read (1 = this week's; the IPO lists about a year, 51 issues on 2026-10-16). One issue holds about 3,600 marks.", "default": 1 }, "journalIssues": { "title": "Specific issues", "type": "array", "description": "Read these issues instead of the latest ones, e.g. 2026/042, 2026/041.", "items": { "type": "string" } }, "origin": { "title": "Origin", "enum": [ "all", "uk", "international" ], "type": "string", "description": "UK applications, international registrations designating the UK, or both.", "default": "all" }, "representation": { "title": "Representative", "enum": [ "any", "with", "without" ], "type": "string", "description": "Keep marks filed with a representative (attorney firm), without one (applicant filed alone), or both.", "default": "any" }, "representativeContains": { "title": "Representative contains", "type": "array", "description": "Representative name or address contains any of these, e.g. \"Marks & Clerk\", \"London\", \"EC4M\".", "items": { "type": "string" } }, "goodsServicesContains": { "title": "Goods & services contain", "type": "array", "description": "Goods and services text contains any of these, e.g. \"software\", \"gin\", \"cosmetics\".", "items": { "type": "string" } }, "includeGoodsAndServices": { "title": "Goods & services", "type": "boolean", "description": "Register: read each mark's goods and services specification (one small extra request per mark). Journal rows always carry it.", "default": true }, "includeImages": { "title": "Mark images (journal)", "type": "boolean", "description": "Journal: save each logo / figurative mark image the journal carries and give its link (imageUrl). The register source has no images.", "default": true }, "includeIpoRecord": { "title": "IPO case record", "type": "boolean", "description": "Also read the IPO's own page for each UK mark: owner postal address, country of incorporation, company number, representative and address, renewal date, publications, image. ~1.2 s per mark.", "default": false }, "monitorMode": { "title": "Only new or changed marks", "type": "boolean", "description": "Deliver only marks not delivered by an earlier run of the same search, or whose status or dates changed. Pairs with a daily or weekly schedule.", "default": false }, "monitorKey": { "title": "Monitor name", "type": "string", "description": "Optional name for the monitor memory, e.g. \"my-brand-watch\". Empty = one memory per distinct search." }, "maxResults": { "title": "Max results", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Stop after this many marks in total. 0 = no limit (the register search reads past TMview's 10,000-per-query window by date).", "default": 100 }, "maxResultsPerSearch": { "title": "Max per search", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Cap per mark text / owner search (register) or per journal issue (journal). 0 = no per-search cap.", "default": 0 }, "compact": { "title": "Compact output", "type": "boolean", "description": "Core fields only (number, mark, status, classes, owner, representative, key dates, IPO link) - trimmed for spreadsheets and AI agents.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. By default the run connects directly and falls back to Apify residential proxy (GB) only if the register search refuses the connection.", "default": { "useApifyProxy": false } }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 10, "type": "integer", "description": "Goods & services requests in flight at once (register mode).", "default": 6 } } }, "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 } } } } } } } } } }