USPTO Trademark Status & Office Action Scraper

Trademark teams, IP operations, brand protection teams, and legal ops use this actor to turn Official USPTO TSDR API with a user-provided API key into a clean dataset for Regulatory Trigger Pack. Provide focused source inputs, keep the first run small, and expand only after the output shape is useful. Each emitted row includes source context, timestamps, and fields designed for monitoring, QA, research, or workflow handoff.

Store Quickstart

Start with one serial number and a user-provided key, then seed a watchlist baseline for recurring status changes.

Recommended first run:

{
  "serialNumbers": [
    "88713620"
  ],
  "includeDocumentMetadata": true,
  "usptoApiKey": "YOUR_USPTO_API_KEY",
  "limit": 25,
  "firstRunMode": "emit_all",
  "delivery": "dataset",
  "dryRun": false
}

Input examples

Trademark status

{
  "serialNumbers": [
    "88713620"
  ],
  "includeDocumentMetadata": true,
  "usptoApiKey": "YOUR_USPTO_API_KEY",
  "limit": 25,
  "firstRunMode": "emit_all",
  "delivery": "dataset",
  "dryRun": false
}

Status only

{
  "serialNumbers": [
    "88713620"
  ],
  "includeDocumentMetadata": false,
  "usptoApiKey": "YOUR_USPTO_API_KEY",
  "limit": 10,
  "firstRunMode": "emit_all",
  "delivery": "dataset",
  "dryRun": false
}

Baseline seed

{
  "serialNumbers": [
    "88713620"
  ],
  "includeDocumentMetadata": true,
  "usptoApiKey": "YOUR_USPTO_API_KEY",
  "limit": 25,
  "firstRunMode": "seed_only",
  "delivery": "dataset",
  "dryRun": false
}

Sample output

{
  "meta": {
    "actorName": "uspto-trademark-status-office-action-scraper",
    "actorTitle": "USPTO Trademark Status & Office Action Scraper",
    "bundle": "Regulatory Trigger Pack",
    "fetchedAt": "2026-05-06T00:00:00.000Z",
    "totalRows": 1
  },
  "rows": [
    {
      "actorName": "uspto-trademark-status-office-action-scraper",
      "rowType": "trademark_status",
      "eventType": "trademark_status_seen",
      "serialNumber": "88713620",
      "markLiteral": "EXAMPLE",
      "ownerName": "Example Owner LLC",
      "statusDescription": "Example status",
      "sourceUrl": "https://tsdrapi.uspto.gov/ts/cd/casestatus/sn88713620/info.xml",
      "fetchedAt": "2026-05-06T00:00:00.000Z"
    }
  ],
  "warnings": []
}

Output fields

• rowType
• eventType
• serialNumber
• registrationNumber
• markLiteral
• ownerName
• statusDescription
• documentDescription
• sourceUrl

Rows also include source URLs, fetch timestamps, warnings when a source is partial, and stable IDs when the workflow supports recurring change detection.

Pricing and no-change runs

$0.001 actor start and $0.030 per emitted trigger row. Missing-key and unchanged runs suppress dataset rows.

The default dataset is the billable surface. Dry runs, validation-only runs, missing-key warnings, and unchanged recurring polls should not write payable default-dataset rows.

Compliance guardrails

• Requires the user's own USPTO API key.
• The actor does not use a platform-owned key or download PDF/ZIP bundles.
• No legal advice or provider-approval language.
• Do not use provider emblems or wording that implies approval by an upstream data provider.

See also

• sec-form-d-offering-notices-scraper
• courtlistener-public-docket-opinion-watch-scraper