Trademark API
Last updated: August 1, 2026
TLDR: A REST API over USPTO trademark data. Create a key, send it as a Bearer token, and call JSON endpoints. Billed on usage credits: a search page costs 1, a full clearance report costs 25. Base URL https://wikitrademarks.com/index.php/api/v1.
How do I authenticate?
Send your key as a Bearer token (or an X-Api-Key header). The key is shown once when you create it; we store only a hash.
curl https://wikitrademarks.com/index.php/api/v1/ping \
-H "Authorization: Bearer wtk_your_key_here"What endpoints are available?
| Endpoint | What it does | Credits |
|---|---|---|
GET /search?q=&class= | Text/wildcard search, paginated | 1 / page |
GET /marks/{serial} | Mark status + detail | 1 |
GET /owners/{name}/marks | All marks for an owner | 3 |
GET /clearance?q=&class= | Knockout: phonetic + fuzzy + class | 10 |
GET /clearance/report?q=&class= | Scored risk report | 25 |
POST /watches | Create a keyword watch (Scale / Agency) | gated |
Example: search and clearance
# Search marks containing "acme" in NICE class 9
curl "https://wikitrademarks.com/index.php/api/v1/search?q=acme&class=9" \
-H "Authorization: Bearer wtk_your_key_here"
# Run a clearance knockout before you file
curl "https://wikitrademarks.com/index.php/api/v1/clearance?q=acme&class=9" \
-H "Authorization: Bearer wtk_your_key_here"Every response includes credits_used, credits_remaining, and a disclaimer field.
How is it priced?
| Plan | Monthly credits | Rate limit | Overage |
|---|---|---|---|
| Free | 250 | 30/min | hard cap |
| Starter ($29/mo) | 10,000 | 120/min | $3.00 / 1k |
| Growth ($99/mo) | 50,000 | 300/min | $2.50 / 1k |
| Scale ($299/mo) | 200,000 | 600/min | $2.00 / 1k |
Out of credits returns 402. Free hard-caps with no overage. Pay-as-you-go packs add 5,000 non-expiring credits for $10.
Common questions
How do I authenticate with the trademark API?
Create an API key in the developer dashboard and send it as a Bearer token in the Authorization header, or as an X-Api-Key header. Keys are shown once at creation and only a hash is stored.
How is the trademark API priced?
On usage credits. Each plan grants a monthly credit allotment; each endpoint costs a fixed number of credits per call, from 1 for a search page to 25 for a full clearance report. Free hard-caps at 250 credits per month.
What can the trademark API do?
Search USPTO marks by text and NICE class, fetch a mark by serial number, list all marks for an owner, and run clearance knockouts that score existing look-alike and sound-alike marks by risk.
What are the rate limits?
Rate limits are per API key and scale with plan, from 30 requests per minute on Free to 600 on Scale. Exceeding the limit returns HTTP 429 with a Retry-After header.
Informational only, not a legal opinion. Consult a trademark attorney before filing or enforcing.