Bots

Ping Uptime

POST /bot/:id/uptime

Allows you to ping the API - Displays the last time you pinged on your bot profile i.e "Last Ping: 2 minutes ago"

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Response

429

{
    "message": "Bot has been temporarily blocked due to sending too many requests"
}

{
    "error": "Ping blocked, cannot be within 2 minutes of last."
    
}

400

200

Post Commands

POST /bot/:id/commands

Allows you to list your slash or text commands on your page

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

Name	Type	Description
commands	array	Array of your commands - slash or text

Response

200

{
  "message": "Success"
}

400

Post Stats

POST /bot/:id/stats

Allows you to post your Guild and Shard count to your bot's page Recommended: Put post request in your bot's ready event

Path Parameters

Name	Type	Description
id	string	ID of your Bot

Headers

Name	Type	Description
Authentication/Authorization	string	Your API key

Request Body

Name	Type	Description
shards	integer	Amount of shards your bot has
guilds*	integer	Amount of servers your bot is in

200: OK

{
    message: "Success"
}

400: Bad Request

Find Individual Bot

GET /bot/:id/

Path Parameters

Name	Type	Description
id/vanity*	string	The ID or Vanity of Specific Bot

200

{
  "longdescription": "Setup a channel and send your ad, Global Advertising will echo your ad across many servers.\n\nUse g!link to get started!",
  "shortdescription": "Global Advertising is the perfect way to get your ad more exposure",
  "prefix": "g!",
  "category": "Ad",
  "ownerid": "381710555096023061",
  "id": "843661607346765864",
  "name": "Global Advertising",
  "votes": 0,
  "website": "",
  "guilds": "???",
  "verified": true
}

404: Not Found

400: Bad Request

Vote Notification

POST

200: OK

 {
          "user": <ID of user that voted>,
          "type": 'vote',
          "bot": <ID of your bot>
}

Fetch Individual Bot Reviews

GET /:id/reviews

Path Parameters

Name	Type	Description
id	string	ID of Specific Bot

200: OK

{
  "reviews": [
    {
      "content": "Works like a charm. Best Minecraft bot you can invite",
      "stars": "5",
      "botid": "712808436588347443",
      "userid": "381710555096023061"
    },
    {
      "botid": "712808436588347443",
      "content": "Good bot",
      "stars": "4",
      "userid": "704790614755246212"
    }
  ]
}

204: No Content

404: Not Found