> For the complete documentation index, see [llms.txt](/llms.txt)

# GS2-Ranking API Reference

Ranking feature




**⚠️ Warning**

GS2-Ranking2 is now available.

Please use [GS2-Ranking2]() for new users unless there is a special reason.

It realizes the ranking process of scores and clear times.

There are two types of ranking: global ranking, which refers to the same data for everyone, and
Scoped ranking is a ranking among friends or within a guild, where the content of the ranking is different depending on the user.

Global rankings are processed at specified intervals between 15 minutes and 24 hours.
Requests from game users are responded to with pre-tabulated results.
This is designed to ensure that response times remain the same even in the presence of a large number of game players.

Scoped ranking is a game where each game player has a score bucket, and scores are added to the score bucket as subscribed game players register their scores.
Each game player uses the scores in his or her score bucket to process the ranking.

Both Global Ranking and Scoped Ranking can be configured to hold one score per user ID or multiple scores.
You can specify whether you want only the last score registered when registering a ranking to be included in the ranking or all registered scores.
If you want all scores to be included in the ranking, the data volume will tend to grow. As a result, the GS2 usage fee will be affected.
Unless there is a major reason to do so in the game system, it is recommended to set only the last score registered to be included in the ranking.

[Introduction to Microservices / GS2-Ranking](../../microservices/ranking)




- [GS2-Ranking Deploy/CDK Reference](/api_reference/ranking/deploy/)
  
- [GS2-Ranking Master Data Reference](/api_reference/ranking/master_data/)
  
- [GS2-Ranking SDK API Reference](/api_reference/ranking/sdk/)
  
- [GS2-Ranking SDK for Game Engine API Reference](/api_reference/ranking/game_engine/)