USPTO Trademarks Search, Status and Watch

Search US trademarks, retrieve application status and prosecution events, and watch for matching new filings or publications. Matching uses text and class filters. This actor does not provide similarity scoring, legal clearance, legal advice, or trademark infringement detection. It does not send email or other notifications; schedule watch runs and consume their dataset rows for alerts.

Search by word mark text, owner name phrase, international class, live/dead status and filing date. Status lookups accept serial or registration numbers. Watch rows explain which terms, owners, classes and dates matched.

Input

The default returns up to 10 marks containing ORCHARD:

{"mode":"search","terms":["ORCHARD"],"wordMatch":"contains","maxItems":10}

Word matching is case insensitive: exact matches the whole mark; contains matches a literal substring. Owner names use phrase matching, including the source's punctuation and word normalization. Values within each list are alternatives; different fields combine as AND filters. internationalClasses accepts three-digit strings 001–045. status is all, live or dead. filingDateFrom and filingDateTo are inclusive YYYY-MM-DD bounds. maxItems is 1–10,000. Without explicit terms, ORCHARD is used only for a search with no owner or class filter.

{"mode":"status","serialNumbers":["78787878"],"maxItems":10}

Alternatively use registrationNumbers. Clear search filters when selecting status mode. Each number returns one status row, including classes, goods/services, attorney and dated prosecution events when supplied. Missing registration numbers are confirmed twice; unavailable status details are reported as failed targets. This actor returns event text, without downloading document files.

{"mode":"watch","terms":["ORCHARD"],"internationalClasses":["030"],"since":"2026-01-01","watchName":"orchard-class030","maxItems":1000}

A watch matches a filing or publication on or after since. For later runs, omit since to resume the same named watch. An explicit since replays that range. watchName accepts 1–80 letters, digits, underscores or hyphens. State is stored in the named uspto-trademark-watches key-value store under that name. Use distinct names for distinct filters and run a given watch sequentially. Without a name, watch mode is a date-filtered one-off export.

A complete run saves the newest matched event date and remembers the marks already delivered on that date. Truncated, interrupted or failed scans retain their checkpoint, so retries can repeat rows. Deduplicate by serial number and matched event date. Raising maxItems or narrowing the filters may be necessary to finish a watch. Late indexing of older filings/publications can fall behind a saved date; periodically replay an earlier since when completeness matters. Checkpoints are not a complete historical audit or a guarantee against missed changes. Status-only changes to existing marks are not watched.

Output example

Rows use rowType values searchResult, status or watchHit. Common fields include serial/registration numbers, word mark, owners, status, live flag, filing/publication/registration dates, international classes, goods/services, attorney and a canonical TSDR sourceUrl. Numbers that serve as identifiers remain strings to preserve leading zeros. Search rows have null statusDate and empty detailed classes/prosecutionEvents; status rows populate them when available. Watch hits include matchReasons. Dates are ISO 8601 calendar dates; missing source fields are null or empty arrays.

{
  "rowType": "searchResult",
  "serialNumber": "50012306",
  "registrationNumber": null,
  "wordMark": "HILLWOOD ORCHARDS WHERE HILLS NURTURE, FLAVOR THRIVES",
  "owners": [
    "PRODUCTORA INTERNACIONAL DE BEBIDAS, S.A. DE C.V. (CORPORATION; Mexico)"
  ],
  "status": "NEW APPLICATION - ASSIGNED TO EXAMINER",
  "statusDate": null,
  "live": true,
  "filingDate": "2026-07-24",
  "publicationDate": null,
  "registrationDate": null,
  "internationalClasses": [
    "029"
  ],
  "goodsAndServices": [
    "IC 029: Snack mix consisting primarily of processed nuts, and also including dried fruit, processed seeds and chocolate."
  ],
  "classes": [],
  "attorney": "BRUCE  MARGULIES",
  "prosecutionEvents": [],
  "sourceUrl": "https://tsdr.uspto.gov/#caseNumber=50012306&caseSearchType=US_APPLICATION&caseType=DEFAULT&searchType=statusSearch",
  "matchReasons": []
}

This example includes the complete common field set.

Limits

Each search is limited to the source's first 10,000 results, ordered by serial number. The actor reports truncation explicitly. Date/class filters can narrow a search. Source data and indexing can lag official events. A row is a source snapshot, not a legal determination.

Rows save as pages finish. A run with saved rows succeeds and names failed or unfinished targets in its status. A confirmed empty result succeeds; an unavailable source with zero rows fails. Named watches do not advance on partial results. No account or API key is required.

Local use

Install requirements-dev.txt in a virtual environment, then run python -m unittest discover -s tests. Run the actor with python -m src. Input and results use the standard Apify storage interface.

For any per-start billing, starts are counted per GB of memory; a default 512 MB run is one start. See the Store listing for current pricing.