# Rankings

View marketplace rankings by various metrics

## Get marketplace rankings

> Retrieves ranked lists of marketplace entities based on various metrics and timeframes.\
> \
> Entity types:\
> \- collections: Top-performing collections\
> \- creators: Most active or highest-earning creators\
> \- items: Best-selling items\
> \- sellers: Top sellers by volume\
> \
> Timeframes:\
> \- day: Last 24 hours\
> \- week: Last 7 days\
> \- month: Last 30 days\
> \- all: All-time rankings\
> \
> Rankings are calculated based on sales volume, transaction count, and other relevant metrics.<br>

```json
{"openapi":"3.1.0","info":{"title":"Decentraland Marketplace Server API","version":"1.0.0"},"tags":[{"name":"Rankings","description":"View marketplace rankings by various metrics"}],"servers":[{"url":"https://marketplace-api.decentraland.org","description":"Production server"},{"url":"https://marketplace-api.decentraland.zone","description":"Development server"}],"security":[],"paths":{"/v1/rankings/{entity}/{timeframe}":{"get":{"tags":["Rankings"],"summary":"Get marketplace rankings","description":"Retrieves ranked lists of marketplace entities based on various metrics and timeframes.\n\nEntity types:\n- collections: Top-performing collections\n- creators: Most active or highest-earning creators\n- items: Best-selling items\n- sellers: Top sellers by volume\n\nTimeframes:\n- day: Last 24 hours\n- week: Last 7 days\n- month: Last 30 days\n- all: All-time rankings\n\nRankings are calculated based on sales volume, transaction count, and other relevant metrics.\n","operationId":"getRankings","parameters":[{"name":"entity","in":"path","required":true,"schema":{"type":"string","enum":["collections","creators","items","sellers"]},"description":"Type of entity to rank (collections, creators, items, sellers)"},{"name":"timeframe","in":"path","required":true,"schema":{"type":"string","enum":["day","week","month","all"]},"description":"Time period for rankings (day, week, month, all)"}],"responses":{"200":{"description":"Rankings data","content":{"application/json":{"schema":{"type":"object","properties":{"entity":{"type":"string","description":"Entity type"},"timeframe":{"type":"string","description":"Timeframe"},"rankings":{"type":"array","items":{"type":"object"},"description":"Rankings data"}},"required":["entity","timeframe","rankings"]}}}}}}}}}
```
