osu!Server List

https://osu-server-list.com/api/v1/servers

Test data List

                                
[
{
    "id":1,
    "name":"Ripple",
    "url":"ripple.moe",
    "logo_loc":"https://ripple.moe/static/logos/logo.svg",
    "created":"7 days ago",
    "votes":4,
    "players":30,
    "safe_name":"ripple",
    "safe_categories":"1",
    "timestamp":"2024-01-06 00:00:00",
    "list_categories":[
        "Relax"
    ]
},
{
    "id":2,
    "name":"Akatsuki",
    "url":"akatsuki.gg",
    "logo_loc":"https://i.ibb.co/BVWxFdV/45724130.png",
    "created":"7 days ago",
    "votes":5,
    "players":120,
    "safe_name":"akatsuki",
    "safe_categories":"1,2,6,3",
    "timestamp":"2024-01-06 00:00:00",
    "list_categories":[
        "Relax",
        "AutoPilot",
        "Clans",
        "AntiCheat"
    ]
}
]
                            

https://osu-server-list.com/api/v1/banchopy/stats

Input: id : int

Test data

                                
{
    "id": 20,
    "maps": 423861,
    "plays": 1763798,
    "clans": 10
}
                                
                            

https://osu-server-list.com/api/v1/chart/types

Input: id : int

Test data

                                
[
    "REGISTERED_PLAYERS",
    "PLAYERCHECK",
    "MAPS",
    "CLANS",
    "PLAYS"
]
                                
                            

https://osu-server-list.com/api/v1/chart/data

Input: id : int type : string (get type from /chart/types)

Test data

                                
[
    {
        "date": "2024-02-12",
        "value": 319595
    },
    {
        "date": "2024-02-13",
        "value": 331905
    },
    {
        "date": "2024-02-14",
        "value": 344460
    },
    {
        "date": "2024-02-15",
        "value": 358247
    },
    {
        "date": "2024-02-16",
        "value": 361072
    },
    {
        "date": "2024-02-17",
        "value": 0
    },
    {
        "date": "2024-02-18",
        "value": 0
    }
]
                                
                            

https://osu-server-list.com/api/v1/server

Input: id : int

Test data

                                
{
    "id": 1,
    "name": "Ripple",
    "url": "ripple.moe",
    "logo_loc": "https://ripple.moe/static/logos/logo.svg",
    "created": "7 days ago",
    "votes": 4,
    "players": 32,
    "safe_name": "ripple",
    "safe_categories": "1",
    "timestamp": "2024-01-06 00:00:00",
    "list_categories": [
        "Relax"
    ]
}
                                
                            

https://osu-server-list.com/api/v1/categories

Test data List

                                
[
{
    "id": 1,
    "name": "Relax",
    "color": ""
},
{
    "id": 2,
    "name": "AutoPilot",
    "color": ""
}
]
                                
                            

Integrations

Vote rewards Encourage voting

Discord Webhooks

If you've successfully claimed a server on our Discord platform, you have the option to enhance user engagement by adding a webhook to your server. This feature allows you to receive real-time notifications whenever someone votes. Each notification includes the voter's username along with a link to the server page. Utilizing this webhook functionality can serve as a powerful incentive for increased voting participation, as users are reminded and encouraged to engage in the voting process through timely notifications.

GETBack v1

Upon successfully claiming a server, you have the option to activate the "GetBack" feature. Simply enter a URL, and each time a user casts a vote, the server will automatically dispatch a GET Request. This request includes essential information such as the GetBack API Key and the username of the voted player. To ensure seamless integration, please verify that the provided API Key matches your server configuration. The GetBack feature initiates a request to %your_url%?username=%username%&key=%key%, providing you with valuable user data for further analysis and engagement.

If you have more question visit the #dev channel on our Discord