Your browser doesn't support javascript!

Introduction

Welcome to the documentation of Wonderbotlist.com

The Wonderbotlist.com API allows you to easily programmatically access the data of bots and others.

Support

If you need help accessing the Wonderbotlist.com API, feel free to discuss it in our Discord Server

If you receive a response 503 from our servers, it means that we have reached an unexpected peak in API access traffic and that we would generally be operational within the next 5 minutes. If the failure persists or if you receive another form of error 5XX, please inform us via Discord Server.

Terms of Service

For more information on the terms of use and privacy of APIs, please refer to our policy document at https://wonderbotlist.com/tos

Authentication

An API key must be required for each request to the Wonderbotlist.com API, in the form of a header X_TOKEN_DBLFR or api_key

If you do not have an API Key, you can get one by posting your bot on the site Wonderbotlist.com.

API key error message

If your API key is missing, badly formed or invalid, you will receive a response code 401 Unauthorized and the following JSON response:

{
    "status": 401,
    "message": "La Clé API est manquant. Vous devez posseder une clé api pour envoyer une demande."
}
                
            

Using the API key as a request parameter

Any request that contains the API Key X_TOKEN_DBLFR or api_key in the header will be accepted.

The API key send in the header at a higher priority if you send it using both the header and query parameter.

Rate Limits

The API access rate limits are applied by key, IP and time. Access to the API using a key is limited to 20 requests per minute In addition, each API response is accompanied by the following set of headers to identify the status of your consumption

Route Requests Allowed Per Hour Punishment if Exceeded
/v1/bots/* 500 1 Hour Block
/v1/user/* 400 1 Hour Block
Header Description
X-RateLimit-Limit The maximum number of requests that the user is allowed to make per minute.
X-RateLimit-Remaining The number of requests remaining before reaching the ratelimit
X-RateLimit-Reset Time at which the limit is reset in seconds UTC

Once the limit is reached, you will receive a response similar to the following JSON with a status code 429 Too Many Requests

You have exceeded the rate limit, you are banned for 1 hour

Bots

Access the contents of a bot via its identifier (id)

POST STATS

https://api.wonderbotlist.com/v1/bot/:id
HEADERS

Authorization
Authorization_token (Optional if api-key or X-TOKEN-WBL entered)
X-TOKEN-DBLFR
Authorization_token (Optional if api-key or X-TOKEN-WBL entered)
api-key
Authorization_token (Optional if api-key or X-TOKEN-WBL entered)
Content-Type
application/x-www-form-urlencoded
PARAMS

shard
Number of shards the bot currently has (You can use shards)
serveurs
Number of servers that the bot currently has (You can use serveur)
STATS OK
{
  "status": 200,
  "message": "Les stats du bots on bien été mis à jour"
}

STATS ERROR
{
  "status": 400,
  "message": "Aucun paramètre trouvé en paramètres ou n'est valide"
}

GET STATS

https://api.wonderbotlist.com/v1/bot/:BOTID
HEADERS

Authorization
Authorization_token (Optional if api-key or X-TOKEN-WBL entered)
X-TOKEN-DBLFR
Authorization_token (Optional if api-key or X-TOKEN-WBL entered)
api-key
Authorization_token (Optional if api-key or X-TOKEN-WBL entered)
Content-Type
application/x-www-form-urlencoded
{
    "id": 337997289484451840,
    "username": "Celestia",
    "owner": "193090359700619264",
    "owners": [
        "359767845762236436",
        "160868823887511552"
    ],
    "github": null,
    "descriptcourt": "Bot de modération et de fun",
    "descriptlong": "yolo je get les infos",
    "descriptvideo": null,
    "approuved": false,
    "lib": "discord.js",
    "prefix": "!",
    "invitelink": "https://b.wonderbotlist.com/invite/337997289484451840",
    "supportserver": null,
    "siteweb": null,
    "shards": 0,
    "server": 0,
    "vote": 0,
    "avatar": "https://cdn.discordapp.com/avatars/337997289484451840/8a9696c309c80a73c02efb74e0a72862.png?size=256",
    "langue": [],
    "tags": [],
    "changelog": [],
    "date": {
        "date": "2019-04-22 00:41:31.000000",
        "timezone_type": 3,
        "timezone": "Europe/Berlin"
    },
    "botstatus": "online",
    "status": 200
}
                

User

Access a user's content via their username ( id )

GET STATS

https://api.wonderbotlist.com/v1/user/:USERID
HEADERS

Authorization
Authorization_token (Optional if api-key or X-TOKEN-WBL entered)
X-TOKEN-DBLFR
Authorization_token (Optional if api-key or X-TOKEN-WBL entered)
api-key
Authorization_token (Optional if api-key or X-TOKEN-WBL entered)
Content-Type
application/x-www-form-urlencoded
{
    "id": 193090359700619264,
    "username": "Ten-No-Kami-Sama7777",
    "bio": "",
    "website": null,
    "facebook": null,
    "github": null,
    "twitter": null,
    "youtube": null,
    "linkedin": null,
    "avatar": "https://cdn.discordapp.com/avatars/193090359700619264/1575890721026ce092188702dd69ccd3.png?size=256",
    "isProfilPublic": true,
    "langue": "fr",
    "roles": [
        "ROLE_ADMIN",
        "ROLE_USER"
    ],
    "nitro": true
}