Quickstart
Register, create an API key and get your first trademark search result in five minutes.
27 jurisdictions and 137 million trademark records, all queryable with a single API key. This page walks you through registration, authentication and your first search result in under five minutes.
1. Get an API key
Sign up in the console (this also creates your organisation), then open API Keys and create a key. The full key is shown exactly once — save it immediately:
lgr_live_a1b2c3d4e5f6...Free tier
The Free plan includes 1,000 credits per month with no card required. A search costs 10 credits per page, a detail lookup 1 credit per record, and reference data is free.
2. Your first search
curl https://api.lagrange.so/v1/trademarks/search \
-H "Authorization: Bearer $LGR_KEY" \
-d '{
"q": "LAGRANGE",
"offices": ["US", "EM", "WO"],
"similarity": ["identical", "fuzzy"],
"nice_classes": [9, 42]
}'Expected response (real structure, not abridged):
{
"total": 3,
"results": [
{
"id": "tm_us_5821044",
"mark_text": "LAGRANGIAN",
"office": "US",
"reg_no": "5821044",
"status": { "primary": "registered", "stage": "live" },
"nice_classes": [9],
"similarity": { "tier": "similar", "via": "fuzzy", "score": 0.87 },
"office_record_id": "5821044-US-REG-20260115",
"office_url": "https://tmsearch.uspto.gov/..."
}
],
"page": { "size": 20, "number": 1 },
"credits_charged": 10
}3. Next steps
- Authentication & keys: scopes, expiration and key rotation
- Data model: field semantics of each record
- Trademark search: every filter parameter and pagination
Conventions
- Boolean parameters accept only
true/false; passing"1"returns 400 - All dates are ISO 8601 (
2026-10-31); timestamps are rejected - Every response includes
credits_charged; failed requests cost nothing