{ "openapi": "3.0.1", "info": { "title": "Trademark Watch & Monitoring: Opposition Deadline Alerts", "description": "Trademark monitoring and search across USPTO, EUIPO, WIPO and 70+ national offices. Monitor your brand terms and get an alert for each new conflicting application, with Nice classes, applicant, status and opposition deadline. Built for brand owners, IP professionals and AI agents.", "version": "0.2", "x-build-id": "4NfiX5aAncaej5p66" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jdepablos~trademark-watch-tmview/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jdepablos-trademark-watch-tmview", "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/jdepablos~trademark-watch-tmview/runs": { "post": { "operationId": "runs-sync-jdepablos-trademark-watch-tmview", "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/jdepablos~trademark-watch-tmview/run-sync": { "post": { "operationId": "run-sync-jdepablos-trademark-watch-tmview", "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": { "query": { "title": "Brand term to watch", "type": "string", "description": "Trademark text to search for, e.g. your brand name. For multiple terms use 'terms'." }, "terms": { "title": "Watchlist (optional)", "type": "array", "description": "Up to 25 terms per run. Each entry: {\"query\": \"...\"} plus any per-term overrides (offices, niceClasses, ...)." }, "offices": { "title": "IP offices", "type": "array", "description": "TMview office codes. EM = EUIPO, US = USPTO, WO = WIPO, GB, JP, KR, CN, CA, MX, BR, ES, FR, DE, IT and 70+ more.", "default": [ "EM", "US", "WO" ] }, "statuses": { "title": "Status filter", "type": "array", "description": "e.g. [\"Filed\"] for new applications only (the watch use-case), [\"Registered\"] for granted marks. Empty = all.", "items": { "type": "string", "enum": [ "Filed", "Registered", "Ended", "Expired" ], "enumTitles": [ "Filed (application pending)", "Registered", "Ended", "Expired" ] } }, "niceClasses": { "title": "Nice classes", "type": "array", "description": "Restrict to Nice classification classes, e.g. [25] apparel, [9, 42] software. Empty = all." }, "filedSince": { "title": "Filed since", "type": "string", "description": "YYYY-MM-DD. Only return marks applied for on or after this date. Optional: the Actor already tells you what is new since your last run (isNew / newMarks). Widening this window surfaces older filings you had not seen: they are shown, but filings applied for before your watch started never count as new and are never charged." }, "maxResultsPerTerm": { "title": "Max marks per term", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap per watched term. It limits what is shown, not what is watched: only the filings actually returned to you are remembered as seen.", "default": 100 } } }, "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 } } } } } } } } } }