---
title: "Trademark Rankings"
method: GET
path: "/trademarks/rankings"
tags: ["Trademarks"]
---

# Trademark Rankings

`GET /trademarks/rankings`

## Request

- Base URL: `https://api.dataporium.io`
- URL: `https://api.dataporium.io/trademarks/rankings`
- Auth: API key in query parameter `apikey`

Top trademark filers in a period and class, ranked by applications or registrations: each trademark owner, or listed companies with all their owners together.

The answer is {group_by, period, class_code, class_name, by, total, rows, totals_all_filers, data_through, about}. Demo keys get at most 10 rows.

## Query parameters

- `group_by` string
- `year_from` integer
- `year_to` integer
- `class` integer
- `by` string
- `ticker` string
- `listed_only` boolean
- `country` string
- `limit` integer
- `offset` integer

## Response `200`

Successful response (JSON).

- object

## Other responses

- `401`: No API key in the request.
- `403`: The API key is not valid or has expired.

---

[API](https://skmtc.dev/dataporium/apis/dataporium-data-api.md) · [All operations](https://skmtc.dev/dataporium/apis/dataporium-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dataporium/apis/dataporium-data-api/revisions/8bc593179dc8?raw)