{ "openapi": "3.0.1", "info": { "title": "USPTO Trademark Watch: New Filings for Your Brand", "description": "Get alerted to new US trademark filings that match your brand, product name or slogan. Schedule it and each run reports only filings it has not shown you before, by class, with owners and links.", "version": "0.1", "x-build-id": "gyJ4CTr69VKFBCXV5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/reaperoak~uspto-trademark-watch-new-filings/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-reaperoak-uspto-trademark-watch-new-filings", "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/reaperoak~uspto-trademark-watch-new-filings/runs": { "post": { "operationId": "runs-sync-reaperoak-uspto-trademark-watch-new-filings", "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/reaperoak~uspto-trademark-watch-new-filings/run-sync": { "post": { "operationId": "run-sync-reaperoak-uspto-trademark-watch-new-filings", "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": [ "terms" ], "properties": { "terms": { "title": "Brand names or phrases to watch", "type": "array", "description": "One per line, up to 120 characters. You are told about new live filings that are identical to, contain, or sit inside the term.", "items": { "type": "string" } }, "classes": { "title": "Trademark classes to watch", "type": "array", "description": "Only filings in these classes are reported. Leave empty to watch every class.", "items": { "type": "string", "enum": [ "25", "21", "18", "9", "16", "20", "24", "26", "28", "14", "35", "41", "42", "43" ], "enumTitles": [ "25: Clothing, shirts, hats", "21: Mugs, drinkware, home goods", "18: Bags, totes, wallets", "9: Phone cases, electronics, software", "16: Stickers, posters, paper goods", "20: Pillows, furniture, frames", "24: Blankets, towels, fabric", "26: Patches, pins, badges", "28: Toys, games, sporting goods", "14: Jewelry, watches", "35: Online store and retail services", "41: Entertainment, education", "42: Software as a service", "43: Restaurants and food service" ] } }, "lookbackDays": { "title": "First run: look back this many days", "minimum": 1, "maximum": 3650, "type": "integer", "description": "On the first run for a term, report matching filings from this many days back. Later runs report only filings not reported before.", "default": 90 }, "onlyNew": { "title": "Only report filings not reported before", "type": "boolean", "description": "Remembers what each term has already reported and returns only new filings. Turn this on when you schedule the Actor. Off by default so a first manual run always shows results.", "default": true }, "includeOwners": { "title": "Include trademark owner names", "type": "boolean", "description": "Owner names come from public USPTO records.", "default": true } } }, "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 } } } } } } } } } }