{ "openapi": "3.0.1", "info": { "title": "USPTO New Trademark Filings — Leads with Contacts", "description": "Daily US trademark application leads from USPTO TSDR. Owner name & address, attorney, correspondent email & phone, pro-se flag, classes and goods — for IP law firms, brand protection and filing services. Date presets, polite official-source access, no key required.", "version": "0.1", "x-build-id": "CciUU7sYvss8bhOqs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/foxlabs~uspto-trademark-leads/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-foxlabs-uspto-trademark-leads", "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/foxlabs~uspto-trademark-leads/runs": { "post": { "operationId": "runs-sync-foxlabs-uspto-trademark-leads", "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/foxlabs~uspto-trademark-leads/run-sync": { "post": { "operationId": "run-sync-foxlabs-uspto-trademark-leads", "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": "Mode", "enum": [ "new_filings", "serial_range", "serial_list" ], "type": "string", "description": "New filings walks the freshest applications by date (the lead feed). Serial range / serial list fetch specific applications by US serial number.", "default": "new_filings" }, "datePreset": { "title": "Which filings", "enum": [ "freshest", "custom" ], "type": "string", "description": "Freshest = the newest applications published in TSDR, walking back from the publication frontier — the same freshness every 'daily trademark leads' service actually has (USPTO publishes new applications with a ~7-10 day capture delay after filing; ~1,700-2,000 filings/business day). Custom = an explicit filing-date range for backfills.", "default": "freshest" }, "onlyNewSinceLastRun": { "title": "Only new since last run", "type": "boolean", "description": "For scheduled daily feeds: stop when reaching the serials already fetched by the previous run, so each run returns exactly the new batch. First run just uses Max results.", "default": false }, "dateFrom": { "title": "Custom from date", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$", "type": "string", "description": "YYYY-MM-DD filing date. Only used when Date range = Custom." }, "dateTo": { "title": "Custom to date", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$", "type": "string", "description": "YYYY-MM-DD filing date. Only used when Date range = Custom. Leave empty for 'today'." }, "filerType": { "title": "Filer type", "enum": [ "all", "pro_se_only", "attorney_only" ], "type": "string", "description": "Pro-se applicants filed WITHOUT an attorney — their own contact email is on the application (the classic IP-firm lead). Attorney-represented applications expose the attorney/correspondent contact instead.", "default": "all" }, "serialFrom": { "title": "Serial from", "minimum": 60000000, "maximum": 99999999, "type": "integer", "description": "First US serial number (8 digits, e.g. 99900000). Only used in 'Serial number range' mode." }, "serialTo": { "title": "Serial to", "minimum": 60000000, "maximum": 99999999, "type": "integer", "description": "Last US serial number. Only used in 'Serial number range' mode." }, "serialNumbers": { "title": "Serial numbers", "type": "array", "description": "Specific 8-digit US serial numbers to fetch. Only used in 'Specific serial numbers' mode.", "default": [], "items": { "type": "string" } }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 2500, "type": "integer", "description": "Hard cap on dataset rows per run. Capped at 2,500 (about one full filing day) to keep access to the official source polite and reliable. At the polite pace this is roughly 100 records per 5-6 minutes.", "default": 300 }, "includeGoodsServices": { "title": "Include goods & services text", "type": "boolean", "description": "Add the full goods/services description per class. Adds detail; off makes rows leaner.", "default": true }, "requestDelayMs": { "title": "Request delay (ms)", "minimum": 2500, "type": "integer", "description": "Delay between requests to USPTO. Minimum 2500 ms is enforced — TSDR rate-protects bursts, and this actor deliberately stays low-rate and polite to the official source (~2 min per 100 records is expected).", "default": 3000 } } }, "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 } } } } } } } } } }