Bots
getBot
https://api.disq.ink/v1/bots/:id
Gather information about a specific bot.
Path Parameters
IDREQUIREDstringID of the bot you are looking for.
{
"id": "abc123",
"discordId": "876543210987654321",
"username": "Example Bot",
"avatar": "a_1234567890abcdef",
"tagline": "A short description of this bot",
"longDescription": "A longer description with more details about the bot and its features.",
"prefix": "!",
"languages": [
{
"language": {
"id": "en",
"name": "English",
"code": "en"
}
}
],
"tags": [
{
"tag": {
"id": "mod",
"name": "Moderation",
"slug": "moderation"
}
}
],
"owners": [
{
"discordId": "123456789012345678",
"username": "owner_username",
"avatar": "abcdef1234567890",
"donator": false
}
],
"links": {
"invite": "https://discord.com/oauth2/authorize?client_id=876543210987654321&scope=bot&permissions=0",
"supportCode": "abcdef",
"website": "https://example.com",
"github": "exampleuser/example-bot"
},
"vanity": null,
"approved": true,
"analytics": {
"_count": {
"votes": 42
},
"serverCount": [
{
"count": 1250
}
]
},
"createdAt": "2023-01-15T12:00:00.000Z",
"updatedAt": "2023-05-01T09:30:00.000Z"
}{
"error": {
"status": 404,
"message": "The bot you are looking for does not exist on our website."
}
}getBot votes
https://api.disq.ink/v1/bots/:id/votes
Gather the people who voted for the bot during the current month.
Path Parameters
IDREQUIREDstringID of the bot you are looking for.
Headers
AuthorizationREQUIREDstringThe bot's API token.
{
"votes": [
{
"user": {
"id": "usr123",
"discordId": "123456789012345678",
"username": "user_one",
"avatar": "abcdef1234567890"
},
"timestamp": "2023-05-01T08:45:12.000Z"
},
{
"user": {
"id": "usr456",
"discordId": "234567890123456789",
"username": "user_two",
"avatar": "1234567890abcdef"
},
"timestamp": "2023-05-02T10:22:35.000Z"
}
]
}{
"error": {
"status": 401,
"message": "Missing 'Authorization' header"
}
}{
"error": {
"status": 403,
"message": "An invalid Authorization token was provided."
}
}{
"error": {
"status": 404,
"message": "The bot you are looking for does not exist on our website."
}
}postBot stats
https://api.disq.ink/v1/bots/:id
Update your bot's statistics on our website.
Path Parameters
IDREQUIREDstringID of the bot you are looking for.
Headers
AuthorizationREQUIREDstringThe bot's API token.
Content-TypeREQUIREDstringapplication/json
Body Parameters
serverCountOPTIONALstringThe amount of servers the bot is in.
shardsOPTIONALstringAn array of numbers containing the amount of servers the bot is in per shard.
{
"status": 200,
"message": "Successfully updated your bot stats."
}{
"error": {
"status": 400,
"message": "One or more shards have invalid server counts (must be between 1-3000)"
}
}{
"error": {
"status": 401,
"message": "Missing 'Authorization' header"
}
}{
"error": {
"status": 403,
"message": "An invalid Authorization token was provided."
}
}{
"error": {
"status": 404,
"message": "The bot you are looking for does not exist on our website."
}
}