> ## Documentation Index
> Fetch the complete documentation index at: https://sportsindex.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Leaderboard

> Creator, topic, and post rankings

## Overview

The leaderboard API ranks creators, topics, and posts by engagement metrics. All endpoints are public. Rankings can be filtered by time period and topic.

***

## Endpoints

### Creator Leaderboard

```
GET /api/leaderboard/
```

Returns creators ranked by engagement score.

**Query Parameters:**

| Parameter   | Type    | Default | Description                          |
| ----------- | ------- | ------- | ------------------------------------ |
| `period`    | string  | `all`   | `all`, `month`, `week`, or `today`   |
| `sort`      | string  | `score` | `score`, `posts`, or `contributions` |
| `topic`     | string  | —       | Filter by topic name                 |
| `page`      | integer | 1       | Page number                          |
| `page_size` | integer | 20      | Results per page                     |

***

### Topic Leaderboard

```
GET /api/leaderboard/topics
```

Returns topics ranked by activity.

**Query Parameters:**

| Parameter      | Type    | Default | Description                        |
| -------------- | ------- | ------- | ---------------------------------- |
| `period`       | string  | `all`   | `all`, `month`, `week`, or `today` |
| `sort`         | string  | `posts` | `posts` or `contributors`          |
| `parent_topic` | string  | —       | Filter by parent topic             |
| `page`         | integer | 1       | Page number                        |
| `page_size`    | integer | 20      | Results per page                   |

***

### Post Leaderboard

```
GET /api/leaderboard/posts
```

Returns posts ranked by views or shares.

**Query Parameters:**

| Parameter   | Type    | Default | Description                        |
| ----------- | ------- | ------- | ---------------------------------- |
| `period`    | string  | `all`   | `all`, `month`, `week`, or `today` |
| `sort`      | string  | `views` | `views` or `shares`                |
| `topic`     | string  | —       | Filter by topic name               |
| `page`      | integer | 1       | Page number                        |
| `page_size` | integer | 20      | Results per page                   |

***

### Platform Stats

```
GET /api/leaderboard/stats
```

Returns aggregate platform-wide statistics (total posts, creators, views, etc.).