Developer docs

ClaimGuard API reference.

Connect trademark monitoring to the tools your team already uses. This reference covers the authenticated query endpoint for your ClaimGuard workspace.

GET

/api/trademarksTrademark queries

Query trademark records

Search the trademark records available to your workspace. Every request must include an API key in the Authorization header.

Authentication

Send the required bearer credential with every request:

Authorization: Bearer <API_KEY>

Query parameters

ParameterDescription

keywordId

Optional keyword identifier to narrow results. Maximum 200 characters.

q

Optional text search across trademark records. Maximum 200 characters.

Request examples

cURL

curl 'https://app.claimguard.com/api/trademarks?keywordId=kw_acme&q=acme%20cloud' \
  -H 'Authorization: Bearer <API_KEY>'

JavaScript

const response = await fetch(
  'https://app.claimguard.com/api/trademarks?keywordId=kw_acme&q=acme%20cloud',
  {
    headers: {
      Authorization: 'Bearer <API_KEY>',
    },
  },
);

const data = await response.json();

200 response

{
  "items": [
    {
      "id": "tm_01j8q3f7k2",
      "markText": "ACME CLOUD",
      "owner": "Acme Cloud, Inc.",
      "registrationNumber": "6123456",
      "status": "live",
      "sourceKeyword": "acme",
      "filedAt": "2024-09-18T00:00:00.000Z",
      "riskScore": 72,
      "litigationIndicator": false
    }
  ]
}

Error responses

Error bodies are JSON. A rate-limited response also includes Retry-After.

400

Invalid query

{ "error": "Invalid query" }

Returned when keywordId or q is longer than 200 characters.

401

Unauthorized

{ "error": "Unauthorized" }

Returned when the bearer credential is missing or invalid.

429

Rate limited

{ "error": "Rate limit exceeded" }

Returned when the account has exceeded its request allowance. Check Retry-After before retrying.