Bots

📌

All endpoints use Dynamic Ratelimits

This page only describes API v5, not API v4

A autogenerated (and sometimes more up to date version of these docs can be found here


Get Bot

GET

bots/:BOT_ID

Fetch some information about a specific bot from our API.

If you wish to fetch based on vanity or bot name, set the resolve query parameter to true


Example Response

Bot Structure or 400 Structure


POST Bot Stats

POST

bots/stats

Post Headers

FieldTypeDescriptionRequired
authorizationStringThe Bots Infinity Bots API Token✔️

Post Body

FieldTypeDescriptionRequired
serversNumberAmount of servers the bot is in.✔️
shardsNumberAmount of shards the bot has.
usersNumberAmount of users the bot has.
  • For the sake of convenience, the API accepts several other keys to allow maximum compatibility with other bot lists. See here for the full list of supported keys

Bot Structure

The below list of keys is not complete and only includes the most commonly used and stable keys, see here for the full list

FieldTypeDescription
nameStringDiscord Username of the Bot.
tagsArray[String]List of the Bots Tags (Moderation etc).
prefixStringThe Bots Prefix used to trigger Discord Messages.
ownerStringUsername of the Bots Main Owner/Developer.
additional_ownersArray[String]Array of Additional Owner IDs.
staff_botBooleanThe Bots Staff Status in our Discord Server.
shortStringThe Bots Short Description displayed on our Website.
longStringThe Bots Long Description displayed on our Website.
nsfwBooleanIf the Bot contains NSFW Features (True or False).
libraryStringThe Lib/Library that the Bot is made in (Ex: Javascript).
premiumBooleanThe Bots Premium Status on our Website.
certifiedBooleanThe Bots Certified Status on our Website.
serversIntegerNumber of Servers the Bot is in.
shardsIntegerNumbet of Shards the Bot has.
votesNumberNumber of Upvotes that the Bot has.
viewsNumberNumber of Views the Bot has (Not Unique).
invitesNumberNumber of Invites the Bot has.
websiteString?The Bots Official Website:l/Dashboard.
donateString?The Bots Patreon, PayPal or Other Donation Link.
supportString?The Bots Support Server Invite Link.
githubString?The Bot or Developers GitHub Page.
bannerString?The Bots Custom Banner Link.
inviteString?The Bots Discord Invite URL.
typeStringThe Bots type (certified, approved etc.

Example Structure

{
"name":"Infinity Bot List",
"tags":"Customizable Prefix, Configuration, Crypto, Soundboard, Media",
"prefix":"ibl.",
"owner":"Connor200024",
"additional_owners":[],
"staff_bot":true,
"short":"The manager bot for this bot list.",
"long":"815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850815553000470478850v",
"library":"Jarvis.djs",
"nsfw":true,
"premium":false,
"certified":true,
"servers":"0",
"shards":"0",
"votes":4,
"views":54,
"invites":"0",
"website":"https://infinitybotlist.com",
"donate":"None",
"support":"https://infinitybotlist.com/discord",
"github":"None",
"banner":"https://i.imgur.com/lNdMzuW.png",
"invite":"https://discord.com/api/oauth2/authorize?client_id=765088908773818378&permissions=402517239&redirect_uri=https%3A%2F%2Fapi.striderbot.net%2Ffrom_discord&response_type=code&scope=bot%20applications.commands%20applications.commands.update"
}

Example 400 Structure

{
"message":"Unable to find that bot! Has it been approved?",
"error": true
}