# USPTO patents, trademarks and assignments · Trademark search

Find companies, people and contact details with USPTO patents, trademarks and assignments · Trademark search from Alexandria through one Spiral API key. Find trademark serial numbers by mark text; for brand screening use `match: phrase` with `status` and `classes` to isolate live marks in the relevant classes. Pass `hits[].serial_number` to `trademark_status` or `assignments`. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Alexandria
- Category: Lead Gen
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `uspto-gov/intellectual-property/trademark_search`
- Page: https://spiral.ai/tools/alexandria/uspto-gov/intellectual-property/trademark_search

## Pricing

$0.00873 per call.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 5 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `text` (required) | text |  | — | Word mark text to search, e.g. `firecrawl`. Wrapping it in double quotes (`"night hand"`) defaults `match` to `phrase`; the quotes are not sent. |
| `from` | number | 0 to 9900 | 0 | Zero-based offset; pass the previous page's `next_from`. |
| `size` | number | 1 to 100 | 25 | size |
| `alive` | true or false |  | — | Older live/dead filter: true is `status: live`, false is `status: dead`. Prefer `status`; when both are given they must agree. |
| `match` | one of | basic, phrase | — | `basic`: the site's basic word-mark search (phrase or any word in the mark, phrase in the pseudo mark). `phrase`: only marks whose word mark or pseudo mark contains the text as a phrase, e.g. `galaxy sports` finds GALAXY SPORTS but not SPORTS GALAXY. Default: `phrase` for a quoted text, else `basic`. |
| `owner` | text |  | — | Owner (applicant or registrant) name phrase, matched with up to two words between terms as the site's owner search does, e.g. `samsung electronics`. |
| `status` | one of | live, registered, pending, dead, cancelled, abandoned | — | Status filter as the site defines it: `live` (registered or pending), `registered` (live with a registration number), `pending` (live application without one), `dead` (cancelled or abandoned), `cancelled` (dead with a cancellation date), `abandoned` (dead with an abandonment date). Omitted: all. |
| `classes` | list |  | — | Nice international classes; a mark matches when it lists any of them, e.g. `[41]` (education and entertainment) or `[9, 16, 41]` (books and publishing). Classes the registration has since deleted, shown as `(CANCELLED) IC 041`, still match, as on the site. |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "uspto-gov/intellectual-property/trademark_search",
    "input": {
      "text": "<text>"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=uspto-gov%2Fintellectual-property%2Ftrademark_search

## Common questions

### USPTO patents, trademarks and assignments · Trademark search

**How much does USPTO patents, trademarks and assignments · Trademark search cost?**

$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use USPTO patents, trademarks and assignments · Trademark search through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "uspto-gov/intellectual-property/trademark_search"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with Alexandria to use USPTO patents, trademarks and assignments · Trademark search?**

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

**Can my AI agent use USPTO patents, trademarks and assignments · Trademark search?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

