---
title: "Get Board"
method: GET
path: "/api/public/rankings/{country}"
tags: ["public"]
---

# Get Board

`GET /api/public/rankings/{country}`

## Request

- Base URL: `https://api.kolens.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.kolens.ai/api/public/rankings/{country}`
- Auth: none declared

## Path parameters

- `country` string, required

## Query parameters

- `window` string: Trailing window: 7d | 30d | 120d
- `limit` integer

## Response `200`

Successful Response

- RankingBoardOut
  - `country` string, required
  - `window` string, required
  - `total` integer, required
  - `updated_at` string, date-time, nullable
  - `free_rows` integer, required
  - `contactable` integer, required
  - `members` RankingMemberOut[], required
    - `rank` integer, required
    - `username` string, required
    - `display_name` string, required
    - `profile_url` string, required
    - `avatar_url` string, nullable
    - `follower_count` integer, nullable
    - `growth_rate` number, nullable
    - `engagement_rate` number, nullable
    - `sampled_videos` integer, nullable
    - `avg_views` number, nullable
    - `verified` boolean
    - `category` string, nullable
    - `has_contact` boolean
    - `in_index` boolean

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kolens/apis/kolens-api.md) · [All operations](https://skmtc.dev/kolens/apis/kolens-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kolens/apis/kolens-api/revisions/5d6865ab0a24?raw)