tm-search

US Trademark Search Skill (tm-search)

This skill enables an agent to search, validate, and analyze US trademarks via USPTO APIs.

Important: API Access Reality

The USPTO trademark search system (tmsearch.uspto.gov) uses AWS WAF bot protection on its Elasticsearch search backend. Direct keyword search via HTTP is not possible without browser automation. However, the TSDR details API (case lookup by serial number) works without authentication and returns JSON.

For keyword search, use one of these approaches:

1. Playwright/browser automation — drive the tmsearch.uspto.gov web UI (most reliable)
2. Third-party API — RapidAPI USPTO wrapper (requires API key, simpler to use)

For case status lookup by serial number, the built-in TSDR API works directly.

API Overview

Use Case	Approach
Keyword/name text search	Browser automation on tmsearch.uspto.gov or RapidAPI
Case status by serial number	TSDR Details API (no auth, JSON)
Batch keyword validation	Browser automation + delays or RapidAPI
Case documents / images	TSDR API (requires API key since Oct 2024)

---

API 1: TSDR Details API (No auth required — JSON)

Look up trademark case details by serial number. This endpoint is hosted on the tmsearch site and returns JSON without authentication.

Endpoint

GET https://tmsearch.uspto.gov/tsdr-api-v1-0-0/tsdr-api?serialNumber={SERIAL_NUMBER}

Serial numbers are 8 digits (no dashes). Example:

curl -s "https://tmsearch.uspto.gov/tsdr-api-v1-0-0/tsdr-api?serialNumber=78787878" \
  -H "Accept: application/json"

Response Structure

{
  "metadata": {
    "caseStatus": "Abandoned because the applicant failed to respond...",
    "statusDate": "2007-09-25",
    "owners": [
      {
        "ipInfo": {
          "name": "OWNER NAME",
          "legalEntity": "3",
          "contactAddress": {
            "mailingAddresses": [
              {
                "cityName": "City",
                "geographicRegionName": "STATE",
                "postalCode": "12345",
                "countryName": "UNITED STATES OF AMERICA"
              }
            ]
          },
          "citizenship": {
            "countryName": "UNITED STATES OF AMERICA",
            "geographicRegionName": "STATE"
          }
        }
      }
    ],
    "attorney": {
      "ipInfo": { "name": "Attorney Name" }
    },
    "correspondent": {
      "ipInfo": {
        "name": "Correspondent Name",
        "contactAddress": { "mailingAddresses": [...], "electronicAddresses": [...] }
      }
    },
    "markDetails": {
      "isStandardCharClaimed": false
    },
    "tm5Status": {
      "tm5StatusDescription": "...",
      "tm5StatusCode": "10",
      "tm5StatusDescriptor": "DEAD/APPLICATION/Refused/Dismissed or Invalidated",
      "tm5LiveDead": "dead"
    },
    "classes": [
      { "classNumber": "009", "firstUseAnywhereDate": null, "firstUseInCommerceDate": null }
    ],
    "docketNumber": "..."
  },
  "maintenance": {},
  "prosecutionHistory": [
    {
      "historyDate": "2026-03-06",
      "historyDescription": "Amended Drawing",
      "documentId": "https://tsdr.uspto.gov/documentviewer?caseId=sn78787878&docId=..."
    }
  ],
  "assignments": [...],
  "proceedings": [...],
  "international": {}
}