Bot Structures

Bot Structure

Field

Type

Description

id

Snowflake

The id of the bot

username

String

The username of the bot

discriminator

String

The discriminator of the bot

avatar?

String

The avatar hash of the bot's avatar

defAvatar

String

The cdn hash of the bot's avatar if the bot has none

lib

String

The library of the bot

prefix

String

The prefix of the bot

shortdesc

String

The short description of the bot

longdesc?

String

The long description of the bot. Can contain HTML and/or Markdown

tags

Array of Strings

The tags of the bot

website?

String

The website url of the bot

support?

String

The support server invite code of the bot

github?

String

The link to the github repo of the bot

owners

Array of Snowflakes

The owners of the bot. First one in the array is the main owner

guilds

Array of Snowflakes

The guilds featured on the bot page

invite?

String

The custom bot invite url of the bot

date

Date

The date when the bot was approved

certifiedBot

Boolean

The certified status of the bot

vanity?

String

The vanity url of the bot

points

Number

The amount of upvotes the bot has

monthlyPoints

Number

The amount of upvotes the bot has this month

donatebotguildid

Snowflake

The guild id for the donatebot setup

Get Bots

Use this endpoint to gain information about different bots

GET/bots

Query String Params

Field

Type

Discription

Default

limit

Number

The amount of bots to return. Max. 500

50

offset

Number

Amount of bots to skip

0

search

String

A search string in the format of field: value field2: value2

sort

String

The field to sort by. Prefix with - to reverse the order

fields

String

A comma separated list of fields to show.

All fields

Response fields

Field

Type

Description

results

Array of bot objects

The matching bots

limit

Number

The limit used

offset

Number

The offset used

count

Number

The length of the results array

total

Number

The total number of bots matching your search

Get Bot

Use this endpoint to gain information about a specific bot

GET/bots/{bot.id}

Get Bot's Last 1000 Votes

IF YOU HAVE OVER 1000 VOTES PER MONTH YOU HAVE TO USE THE WEBHOOKS AND CAN NOT USE THIS

Use this endpoint to see who have upvoted your bot

GET/bots/{bot.id?}/votes

returns An Array of simple user objects

Individual User Id Voting Check for the past 24 hours.

Use this endpoint to see who have upvoted your bot in the past 24 hours. It is safe to use this even if you have over 1k votes.

GET/bots/{bot.id?}/check

Query STring Params

Field

Type

Description

userId

Number

User id of the discord user

returns{voted: 1} or {voted: 0}

Get Bot's Stats

Use this endpoint to gain information about a specific bot's stats

GET/bots/{bot.id}/stats

Response Fields

Field

Type

Description

server_count?

Number

The amount of servers the bot is in

shards

Array

The amount of servers the bot is in per shard. Always present but can be empty

shard_count?

Number

The amount of shards a bot has

Post Bot's Stats

Use this endpoint to post your bot's stats

POST/bots/{bot.id?}/stats

JSON Params

Field

Type

Description

Required

server_count

Number or Array of Numbers

The amount of servers the bot is in. If an Array it acts like shards

Yes (or shards)

shards

Array of Numbers

The amount of servers the bot is in per shard.

No (unless server_count is not set)

shard_id

Number

The zero-indexed id of the shard posting. Makes server_count set the shard specific server count

No

shard_count

Number

The amount of shards the bot has

No