Botlister - NodeJS library for discordbotlist.com

Botlister is an easy to use, zero-dependency NodeJS library for the discordbotlist.com

const botlister = new (require('botlister'))({ apiToken: 'abcdef', defaultBotId: '371840836423385101' })
botlister.updateBotStatistics({
    guilds: bot.guilds.size,
    users: bot.users.size,
}).catch(console.error);

// OR
const dblBot = await botlister.fetchBot('1111');
console.log(dblBot.statistics);
dblBot.updateStatistics({ guilds: 1 });

// read docs for more coolness

• Examples
• Getting a API token
• Documentation

Need an example? Check out the example folder

back to top

Go to your bots page and select one of your bots, then click generate token

back to top

• Core
  • Parameters
  • fetchPopularBots
  • fetchAllBots
    • Parameters
  • searchBots
    • Parameters
  • fetchMyBots
    • Parameters
  • fetchBot
    • Parameters
  • fetchUpvoters
    • Parameters
  • generateBotToken
    • Parameters
  • updateBotStatistics
    • Parameters
  • resetBotStatistics
    • Parameters
  • deleteBot
    • Parameters
  • upvoteBot
    • Parameters
  • updateBotInformation
    • Parameters
  • addBot
    • Parameters
  • fetchUser
    • Parameters
  • banUser
    • Parameters
  • unbanUser
    • Parameters
  • refreshUser
    • Parameters
  • fetchUninvitedBots
  • verifyBot
    • Parameters
  • unverifyBot
    • Parameters
  • refreshBot
    • Parameters
  • fetchConfiguration
  • lockDatabase
  • unlockDatabase
• Bot
  • Parameters
  • Properties
  • getUpvoters
  • regenerateToken
  • updateStatistics
    • Parameters
  • resetStatistics
  • delete
  • upvote
  • editInformation
    • Parameters
  • verify
  • unverify
  • refresh
• User
  • Parameters
  • Properties
  • ban
  • unban
  • refresh

Represents main library

• options Object? Botlister options (all options are optional)
  • options.apiToken String bot api token (optional, default null)
  • options.defaultBotId String Default bot ID to use when calling bot-related functions (optional, default null)
  • options.userToken String user account token (optional, default null)

Fetch an array of "hot" or "popular" bots

Returns Promise<Array<Bot>> Resolves with an array of Bot objects

Fetch an array of all bots on the website. Use lightly.

• skip Number Amount of bots to skip (optional, default 0)

Returns Promise<Array<Bot>> Resolves with an array of Bot objects

Search through all bots with a search term.

• searchTerm String? The search term to use (optional, default '')

Returns Promise<Array<Bot>> Resolves with an array of Bot objects

Fetch the current user's bots. Requires a userToken.

• skip Number Amount of bots to skip (optional, default 0)

Returns Promise<Array<Bot>> Resolves with an array of Bot objects

Fetch a bot

• id String? The ID of the bot to fetch, defaults to the defaultBotId (if one is set) (optional, default this.defaultBotId)

Returns Promise<Bot> Resolves with a Bot object

Fetch an array of users who upvoted the bot

• id String? The ID of the bot to fetch upvoters for, defaults to the defaultBotId (if one is set) (optional, default this.defaultBotId)

Returns Promise<Array<User>> Resolves with an array of User objects

Re-generates the bot API token. Requires a userToken.

• id String? The ID of the bot, defaults to the defaultBotId (if one is set) (optional, default this.defaultBotId)

Returns Promise<String> Resolves with a new apiToken

Updates bot statistics. Requires an apiToken.

• id String? The ID of the bot, defaults to the defaultBotId (if one is set) (optional, default this.defaultBotId)
• statistics Object Statistics to send
  • statistics.shardId Number? Shard ID to send data for
  • statistics.guilds Number? Amount of guilds
  • statistics.users Number? Amount of users
  • statistics.voiceConnections Number? Amount of voice connections

Returns Promise

Resets bot statistics. Requires an apiToken.

• id String? The ID of the bot, defaults to the defaultBotId (if one is set) (optional, default this.defaultBotId)

Returns Promise

Deletes the bot. Requires a userToken.

• id String? The ID of the bot, defaults to the defaultBotId (if one is set) (optional, default this.defaultBotId)

Returns Promise

Upvotes the bot with the user's account. Requires a userToken.

• id String? The ID of the bot, defaults to the defaultBotId (if one is set) (optional, default this.defaultBotId)

Returns Promise

Updates/edits the bot information on the website. Requires a userToken.

• id String? The ID of the bot, defaults to the defaultBotId (if one is set) (optional, default this.defaultBotId)
• info Object Updated bot information
  • info.shortDescription String? Short description
  • info.longDescription String? Long description
  • info.prefix String? Bot prefix
  • info.website String? Bot website
  • info.botInvite String? Bot invite
  • info.serverInvite String? Server invite

Returns Promise

Submits a new bot to the website. Requires a userToken.

• info Object Bot information
  • info.id String The ID of the bot, defaults to the defaultBotId (if one is set)
  • info.shortDescription String Short description
  • info.longDescription String? Long description
  • info.prefix String Bot prefix
  • info.website String? Bot website
  • info.botInvite String Bot invite
  • info.serverInvite String? Server invite

Returns Promise

Fetch a user

• id String The ID of the user

Returns Promise<User>

Ban a user. Requires a userToken. Requires admin.

• id String The ID of the user

Returns Promise

Unban a user. Requires a userToken. Requires admin.

• id String The ID of the user

Returns Promise

Refresh a user. Requires a userToken. Requires admin.

• id String The ID of the user

Returns Promise

Fetch an array of bots that are not in the DBL server. Requires a userToken. Requires admin.

Returns Promise<Array<Bot>> Resolves with an array of Bot objects

Verify a bot. Requires a userToken. Requires admin.

• id String The ID of the bot

Returns Promise

Unverify a bot. Requires a userToken. Requires admin.

• id String The ID of the user

Returns Promise

Refresh a bot. Requires a userToken. Requires admin.

• id String The ID of the user

Returns Promise

Fetch DBL configuration. Requires a userToken. Requires admin.

Returns Promise<Object> {"db_locked": true}

Lock database. Requires a userToken. Requires admin.

Returns Promise

Unlock database. Requires a userToken. Requires admin.

Returns Promise

Represents a DBL bot

• data
• core

• id String The ID of the bot
• createdAt Timestamp Timestamp of when the bot was added to DBL
• lastUpdatedAt Timestamp Timestamp of when the bot was last updated
• avatar String? The hash of the bot's avatar, or null if no avatar
• defaultAvatarURL String The URL of the bot's default avatar
• avatarURL String The URL of the bot's avatar
• username String The username of the bot
• discriminator String The discriminator of the bot
• shortDescription String The short description of the bot
• longDescription String The long description of the bot
• prefix String The bot prefix
• website String The bot website
• botInvite String The invite to the bot
• serverInvite String Server invite
• verified Boolean Whether the bot is verified or not
• upvotes Number Number of upvotes the bot has
• upvoted Boolean Whether the bot has been upvoted or not
• owner User The user object of the bot owner
• statistics Object? The bot statistics

Get an array of users who have upvoted the bot

Returns Promise<Array<User>> Resolves with an array of User objects

Regenerate the bot token. Requires a userToken.

Returns Promise<String> Resolves with the new bot token

Updates bot statistics. Requires an apiToken.

• statistics Object Statistics to send
  • statistics.shardId Number? Shard ID to send data for
  • statistics.guilds Number? Amount of guilds
  • statistics.users Number? Amount of users
  • statistics.voiceConnections Number? Amount of voice connections
• id String? The ID of the bot, defaults to the defaultBotId (if one is set)

Returns Promise

Resets bot statistics

Returns Promise

Deletes bot. Requires a userToken.

Returns Promise

Upvotes bot. Requires a userToken.

Returns Promise

Updates/edits the bot information on the website. Requires a userToken.

• info Object Updated bot information
  • info.shortDescription String? Short description
  • info.longDescription String? Long description
  • info.prefix String? Bot prefix
  • info.website String? Bot website
  • info.botInvite String? Bot invite
  • info.serverInvite String? Server invite
• id String? The ID of the bot, defaults to the defaultBotId (if one is set)

Returns Promise

Verifies bot. Requires a userToken.

Returns Promise

Unverifies bot. Requires a userToken.

Returns Promise

Refresh bot. Requires a userToken.

Returns Promise

Represents a DBL user

• data
• core

• id String The ID of the user
• createdAt Timestamp Timestamp of when the user was added to DBL
• avatar String? The hash of the user's avatar, or null if no avatar
• defaultAvatarURL String The URL of the user's default avatar
• avatarURL String The URL of the user's avatar
• username String The username of the user
• discriminator String The discriminator of the user
• admin Boolean Whether the user is an administrator or not
• banned Boolean Whether the user is banned or not
• bots Array<Bot> Array of Bot objects that belong to the user

Ban user. Requires userToken.

Returns Promise

Unban user. Requires userToken.

Returns Promise

Refresh user. Requires userToken.

Returns Promise

back to top

Maintained by Wright

Contact me on Discord wright#0666

back to top