# USPTO Trademark Assignment Scraper - Ownership Transfer API (`pink_comic/uspto-trademark-assignment-search`) Actor Search official USPTO trademark assignment records by assignee, assignor, serial or registration number, international registration, and reel/frame. Export source-linked transfers, security interests, releases, parties, marks, dates, and recorded documents. - **URL**: https://apify.com/pink\_comic/uspto-trademark-assignment-search.md - **Developed by:** [Ava Torres](https://apify.com/pink_comic) (community) - **Categories:** Business - **Stats:** 2 total users, 1 monthly users, 80.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 uspto trademark assignment rows This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## USPTO Trademark Assignment Scraper - Ownership Transfer API Search the official, public **USPTO Assignment Center** for recorded US trademark transactions. Find assignees, assignors, serial and registration numbers, international registrations, reel/frame identifiers, marks, security interests, releases, mergers, and complete source-linked assignment details. ### What this actor returns Each assignment row includes: - recordation, receipt, mail, and assignor-execution dates - reel/frame and official recorded-document URL - conveyance text and code - receiving parties (assignees) and conveying parties (assignors) - public party entity type, citizenship, and recorded address fields - every trademark property attached to the assignment - mark, serial number, registration number, filing date, and reported current owner - source totals, assignments scanned, and an explicit scan-limit flag ### Example input ```json { "assigneeName": "APPLE INC.", "nameMatch": "contains", "fetchDetails": true, "sortBy": "latest", "maxResults": 10, "maxAssignmentsScanned": 25 } ```` Exact reel/frame lookup: ```json { "assigneeName": "", "reelFrame": "9150/0184", "fetchDetails": true, "maxResults": 1 } ``` ### Important interpretation boundary USPTO states that assignment recordation is a ministerial function. It records documents presented to the agency but does **not** verify their validity, determine the legality of a transaction, or decide title. A result is source-backed transaction evidenceβ€”not a current trademark-status report, legal opinion, or complete ownership determination. Later assignments, corrections, cancellations, or unrecorded interests may exist. The Assignment Center database covers recorded trademark assignments from 1955 to present. Records before 1955 are maintained by the National Archives. ### Source and pricing Source: [USPTO Assignment Center](https://assignmentcenter.uspto.gov/) Pricing: pay per event β€” `$0.0001` per start plus `$0.002` per default-dataset item. # Actor input Schema ## `query` (type: `string`): Convenient alias for assigneeName. Used only when no specific search field is supplied. ## `assigneeName` (type: `string`): Name receiving the recorded interest. The deterministic first-run example uses APPLE INC. ## `assignorName` (type: `string`): Name conveying or releasing the recorded interest. ## `serialNumber` (type: `string`): USPTO trademark application serial number; punctuation is ignored. ## `registrationNumber` (type: `string`): USPTO trademark registration number; leading zeroes and punctuation are normalized. ## `internationalRegistrationNumber` (type: `string`): Madrid Protocol international registration number. ## `reelFrame` (type: `string`): Official assignment identifier in REEL/FRAME format, for example 9150/0184. ## `nameMatch` (type: `string`): Contains finds variants; exact limits party-name matching. ## `startRecordationDate` (type: `string`): Optional inclusive YYYY-MM-DD client-side filter after source retrieval. ## `endRecordationDate` (type: `string`): Optional inclusive YYYY-MM-DD client-side filter after source retrieval. ## `conveyanceKeyword` (type: `string`): Case-insensitive filter such as ASSIGNS, SECURITY INTEREST, RELEASE, MERGER, or CHANGE OF NAME. ## `fetchDetails` (type: `boolean`): Fetch all listed properties, party addresses, recordation dates, and official document URLs for each bounded assignment. ## `sortBy` (type: `string`): Sort matched assignments by official recordation date. ## `maxResults` (type: `integer`): Total output cap after filters and sorting. ## `maxAssignmentsScanned` (type: `integer`): Bounds detail requests and client-side date/conveyance filtering. Output discloses when the source result was only partly scanned. ## Actor input object example ```json { "query": "", "assigneeName": "APPLE INC.", "assignorName": "", "nameMatch": "contains", "conveyanceKeyword": "", "fetchDetails": true, "sortBy": "latest", "maxResults": 10, "maxAssignmentsScanned": 25 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "query": "", "assigneeName": "APPLE INC.", "maxResults": 10, "maxAssignmentsScanned": 25 }; // Run the Actor and wait for it to finish const run = await client.actor("pink_comic/uspto-trademark-assignment-search").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "query": "", "assigneeName": "APPLE INC.", "maxResults": 10, "maxAssignmentsScanned": 25, } # Run the Actor and wait for it to finish run = client.actor("pink_comic/uspto-trademark-assignment-search").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "query": "", "assigneeName": "APPLE INC.", "maxResults": 10, "maxAssignmentsScanned": 25 }' | apify call pink_comic/uspto-trademark-assignment-search --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=pink_comic/uspto-trademark-assignment-search", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "USPTO Trademark Assignment Scraper - Ownership Transfer API", "description": "Search official USPTO trademark assignment records by assignee, assignor, serial or registration number, international registration, and reel/frame. Export source-linked transfers, security interests, releases, parties, marks, dates, and recorded documents.", "version": "0.1", "x-build-id": "KoaYvgdm82tGYmMJZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/pink_comic~uspto-trademark-assignment-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-pink_comic-uspto-trademark-assignment-search", "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/pink_comic~uspto-trademark-assignment-search/runs": { "post": { "operationId": "runs-sync-pink_comic-uspto-trademark-assignment-search", "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/pink_comic~uspto-trademark-assignment-search/run-sync": { "post": { "operationId": "run-sync-pink_comic-uspto-trademark-assignment-search", "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": "Generic Assignee Query", "type": "string", "description": "Convenient alias for assigneeName. Used only when no specific search field is supplied.", "default": "" }, "assigneeName": { "title": "Receiving Party / Assignee Name", "type": "string", "description": "Name receiving the recorded interest. The deterministic first-run example uses APPLE INC.", "default": "APPLE INC." }, "assignorName": { "title": "Conveying Party / Assignor Name", "type": "string", "description": "Name conveying or releasing the recorded interest.", "default": "" }, "serialNumber": { "title": "Exact Trademark Serial Number", "pattern": "^[0-9 .-]*$", "type": "string", "description": "USPTO trademark application serial number; punctuation is ignored." }, "registrationNumber": { "title": "Exact Registration Number", "pattern": "^[0-9 .-]*$", "type": "string", "description": "USPTO trademark registration number; leading zeroes and punctuation are normalized." }, "internationalRegistrationNumber": { "title": "Exact International Registration Number", "pattern": "^[0-9 .-]*$", "type": "string", "description": "Madrid Protocol international registration number." }, "reelFrame": { "title": "Exact Reel / Frame", "pattern": "^$|^[0-9]+/[0-9]+$", "type": "string", "description": "Official assignment identifier in REEL/FRAME format, for example 9150/0184." }, "nameMatch": { "title": "Name Matching", "enum": [ "contains", "exact" ], "type": "string", "description": "Contains finds variants; exact limits party-name matching.", "default": "contains" }, "startRecordationDate": { "title": "Recordation Start Date", "pattern": "^$|^[0-9]{4}-[0-9]{2}-[0-9]{2}$", "type": "string", "description": "Optional inclusive YYYY-MM-DD client-side filter after source retrieval." }, "endRecordationDate": { "title": "Recordation End Date", "pattern": "^$|^[0-9]{4}-[0-9]{2}-[0-9]{2}$", "type": "string", "description": "Optional inclusive YYYY-MM-DD client-side filter after source retrieval." }, "conveyanceKeyword": { "title": "Conveyance Type Keyword", "type": "string", "description": "Case-insensitive filter such as ASSIGNS, SECURITY INTEREST, RELEASE, MERGER, or CHANGE OF NAME.", "default": "" }, "fetchDetails": { "title": "Fetch Complete Assignment Details", "type": "boolean", "description": "Fetch all listed properties, party addresses, recordation dates, and official document URLs for each bounded assignment.", "default": true }, "sortBy": { "title": "Sort Assignments", "enum": [ "latest", "oldest" ], "type": "string", "description": "Sort matched assignments by official recordation date.", "default": "latest" }, "maxResults": { "title": "Maximum Assignment Rows", "minimum": 1, "maximum": 500, "type": "integer", "description": "Total output cap after filters and sorting.", "default": 10 }, "maxAssignmentsScanned": { "title": "Maximum Assignments to Inspect", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Bounds detail requests and client-side date/conveyance filtering. Output discloses when the source result was only partly scanned.", "default": 25 } } }, "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 } } } } } } } } } } ```