Important: This API is currently in BETA. Some features may change, please report any issues you encounter.

API Documentation

Learn how to interact with our API and get started with the integration process.

Base URL

All API requests are made to the following base URL:

https://topserver.live/api/

Endpoints

Important: It is very important to use a valid email address because when the user is created, the details are sent to that email and are required to log in.

This endpoint allows you to create a new server and will create a user as well. You need to provide the server details such as its name, description, URL, language, and version. The user will receive the details via email. Here's an example:

Available Game Versions
World of Warcraft
The Burning Crusade
Wrath of the Lich King
Cataclysm
Mists of Pandaria
Warlords of Draenor
Legion
Battle for Azeroth
Shadowlands
Dragonflight

POST /add-server


POST https://topserver.live/api/add-server

{
    "name": "Top Server Live",
    "description": "Best World of Warcraft Servers Ranking",
    "url": "https://topserver.live/",
    "language": "en",
    "version_name": "Wrath of the Lich King",
    "realmlist": "topserver.live",
    "realmlist_port": 8085,
    "socials": [
        {"social": "facebook", "url": "https://facebook.com/example"},
        {"social": "twitter", "url": "https://twitter.com/example"}
    ],
    "banner_url": "https://topserver.live/images/banner.png"
}

Example Response:

Response


{
    "message": "Server added successfully!",
    "server": {
        "name": "Top Server Live",
        "description": "Best World of Warcraft Servers Ranking",
        "url": "https://topserver.live/",
        "language": "en",
        "version_name": "Wrath of the Lich King",
        "realmlist": "topserver.live",
        "realmlist_port": 8085,
        "socials": [
            {"social": "facebook", "url": "http://facebook.com/example"},
            {"social": "twitter", "url": "http://twitter.com/example"}
        ],
        "banner_url": "http://example.com/banner.jpg"
    }
}