Leaderboard - Sports Index

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.).