API Documentation

All information about the API.

API

Tokens

Tokens are provided on a per-bot basis. View your bot's token by finding your bot and clicking the token button

  • All requests use JSON.
  • Please send POST requests with Content-Type: application/json with valid JSON in the body.
  • When a token is required (When token needed is shown), please add your token to your HTTP Authorization header.
  • Example: Authorization: dd8c7533eabfa62174a549f7b11678962ec00f8727537

Base URL: https://listmybots.com/api

GET /bot/:id

Obtain JSON encoded information about a specific bot.

GET /bot/:id/widget

Obtain a widget that can be added to a website through HTML or Markdown.

A present widget on a Github page or Website is required for verification.

Widget failed to load.

GET /bot/:id/widget/status

Obtain a status SVG image that can be added to a website through HTML or Markdown.

Widget failed to load.

GET /user/:id

Obtain JSON encoded information about a specific user.

GET /bots/:id

Obtain JSON encoded information about a users bots.

POST /bot/:id (Authorization Required!)

Update your bot guild count.

JSON body Key Info

count     The guild count for your bot
server_count  The guild count for your bot