API Reference

The following section outlines the API of dbots.

Version Related Info

There are two main ways to query version information about the library.

dbots.version_info

A named tuple that is similar to sys.version_info.

Just like sys.version_info the valid values for releaselevel are ‘alpha’, ‘beta’, ‘candidate’ and ‘final’.

dbots.__version__

A string representation of the version. e.g. '1.0.0rc1'. This is based off of PEP 440.

Classes

class dbots.Poster(client_id, server_count, user_count, voice_connections, on_custom_post=None, **options)

A class that posts server count to listing sites.

Parameters

• client_id (str) – The client ID used for posting to a service.

• server_count (function or coroutine) – The function to use when retrieving the amount of servers.

• user_count (function or coroutine) – The function to use when retrieving the amount of users.

• voice_connections (function or coroutine) – The function to use when retrieving the amount of voice connections.

• on_custom_post (Optional[function or coroutine]) – The function to use when posting to a custom service. This function will be used with the named parameters being server_count, user_count and voice_connections.

• loop (Optional[asyncio.AbstractEventLoop]) – The asyncio.AbstractEventLoop to use for asynchronous operations. Defaults to None, in which case the default event loop is used via asyncio.get_event_loop().

• sharding (Optional[bool]) – Whether or not to use sharding values.

• shard_count (Optional[int]) – The amount of shards the client has.

• shard_id (Optional[int]) – The shard ID the poster us posting for.

• proxy (Optional[str]) – Proxy URL.

• proxy_auth (Optional[aiohttp.BasicAuth]) – An object that represents proxy HTTP Basic Authorization.

• api_keys (Optional[dict]) – A dictionary of API keys with the key being service keys and values being tokens.

property client_id: str

The client ID of the poster.

get_key(service: str) → str

Gets an API key.

Parameters

service (str) – The service key to get.

kill_loop()

Cancels the current posting loop.

async manual_post(server_count, service=None, user_count=None, voice_connections=None) → HTTPResponse

Manually posts a server count to a service.

Parameters

• server_count (int) – The server count to post to the service.

• service (Optional[str]) – The service to post to. Can be None to post to all services or custom to use the custom post method.

• user_count (Optional[int]) – The user count to post to the service.

• voice_connections (Optional[int]) – The voice connection count to post to the service.

async post(service=None) → HTTPResponse

Posts the current clients server count to a service.

Parameters

service (Optional[str]) – The service to post to. Can be None to post to all services or custom to use the custom post method.

remove_key(service: str) → str

Removes an API key.

Parameters

service (str) – The service key to remove.

set_key(service: str, key: str) → str

Sets an API key.

Parameters

• service (str) – The service key to set.

• key (str) – The API key to use.

property shard_count: int

The shard count of the poster.

property shard_id: int

The shard ID of the poster.

start_loop(interval=1800) → AsyncLoop

Creates a loop that posts to all services every n seconds.

Parameters

interval (Optional[int]) – The amount of time (in seconds) to post to all services again.

class dbots.Service(token=None, **options)

Represents any postable service.

Parameters

• token (Optional[str]) – The token that the class will use to authorize requests.

• proxy (Optional[str]) – Proxy URL.

• proxy_auth (Optional[aiohttp.BasicAuth]) – An object that represents proxy HTTP Basic Authorization.

BASE_URL

The base URL that the service uses for API requests.

Type

Optional[str]

token

The token that will be used for the service.

Type

str

http

The HTTP client the service is using.

Type

HTTPClient

static get(key: str)

Gets a service from a key.

Parameters

key (str) – The name of the service to get.

property has_token: bool

Whether or not the service class has a token.

class dbots.AsyncLoop(timeout, callback)

HTTP Classes

class dbots.HTTPClient(base_url=None, proxy=None, proxy_auth=None)

Represents an HTTP client that can send requests.

class dbots.HTTPResponse(response, text)

A wrapped response from an HTTPClient:.

body

The body of the response. The response is auto-parsed to json if available.

Type

dict or str

text

The text body of the response.

Type

str

raw

The raw response from aiohttp.

Type

aiohttp.ClientResponse

status

The HTTP status code of the response.

Type

int

method

The method the request used.

Type

str

url

The URL of the response.

Type

str

Services

class dbots.BladeList(token=None, **options)

Represents the BladeList service.

See also

• BladeList Website

• BladeList API Documentation

get_bot(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets a bot listed on this service.

Parameters

bot_id (str) – The bot’s ID.

class dbots.Blist(token=None, **options)

Represents the Blist service.

See also

• Blist Website

• Blist API Documentation

get_bot(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the bot listed on this service.

Parameters

bot_id (str) – The bot’s ID.

get_bot_reviews(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the bot’s reviews on this service.

Parameters

bot_id (str) – The bot’s ID.

get_bot_votes(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the list of people who voted this bot on this service.

Parameters

bot_id (str) – The bot’s ID.

get_server(server_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the server listed on this service.

Parameters

server_id (str) – The server’s ID.

get_user(user_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the user listed on this service.

Parameters

user_id (str) – The user’s ID.

get_user_bots(user_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the user’s bots listed on this service.

Parameters

user_id (str) – The user’s ID.

get_user_servers(user_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the user’s servers listed on this service.

Parameters

user_id (str) – The user’s ID.

get_widget_url(bot_id: str, widget_type: str = 'normal', **query) → str

Gets the widget URL for this bot.

Parameters

• bot_id (str) – The bot’s ID.

• widget_type (Optional[str]) – The type of widget to show.

• **query – The query string to append to the URL.

class dbots.BotsOnDiscord(token=None, **options)

Represents the Bots On Discord service.

See also

• Bots On Discord Website

• Bots On Discord API Documentation

check_review(bot_id: str, user_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Checks whether or not a user has reviewed a bot.

Parameters

• bot_id (str) – The bot’s ID.

• user_id (str) – The user’s ID.

get_widget_url(bot_id: str, **query) → str

Gets the widget URL for this bot.

Parameters

• bot_id (str) – The bot’s ID.

• **query – The query string to append to the URL.

class dbots.Carbon(token=None, **options)

Represents the Carbonitex service.

See also

• Carbonitex Website

get_bots() → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets a list of bots on this service.

class dbots.DBots(token=None, **options)

Represents the DBots service.

See also

• DBots Website

• DBots API Documentation

get_audit(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the bot’s audit logs.

Parameters

bot_id (str) – The bot’s ID.

regen_token(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Regenerates the bot API token.

Parameters

bot_id (str) – The bot’s ID.

class dbots.DiscordBoats(token=None, **options)

Represents the Discord Boats service.

See also

• Discord Boats Website

• Discord Boats API Documentation

get_bot(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the bot listed on this service.

Parameters

bot_id (str) – The bot’s ID.

get_user(user_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the user listed on this service.

Parameters

user_id (str) – The user’s ID.

get_widget_url(bot_id: str, **query) → str

Gets the widget URL for this bot.

Parameters

• bot_id (str) – The bot’s ID.

• **query – The query string to append to the URL.

user_voted(bot_id: str, user_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Checks whether or not a user has reviewed a bot.

Parameters

• bot_id (str) – The bot’s ID.

• user_id (str) – The user’s ID.

class dbots.DiscordBotList(token=None, **options)

Represents the Discord Bot List service.

See also

• Discord Bot List Website

• Discord Bot List API Documentation

class dbots.DiscordBotlistEU(token=None, **options)

Represents the DiscordBotlistEU service.

See also

• DiscordBotlistEU Website

• DiscordBotlistEU API Documentation

get_analytics() → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets this bot’s analytics.

get_bot() → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets this bot’s data.

get_votes() → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets this bot’s votes.

class dbots.DiscordBotsGG(token=None, **options)

Represents the Discord Bots service.

See also

• Discord Bots Website

• Discord Bots API Documentation

get_bot(bot_id: str, **query) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the bot listed on this service.

Parameters

• bot_id (str) – The bot’s ID.

• **query – The query string to append to the URL.

get_bots(**query) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets a list of bots on this service.

Parameters

**query – The query string to append to the URL.

class dbots.DiscordExtremeList(token=None, **options)

Represents the Discord Extreme List service.

See also

• Discord Extreme List Website

• Discord Extreme List API Documentation

get_bot(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the bot listed on this service.

Parameters

bot_id (str) – The bot’s ID.

get_statistics() → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the statistics of this service.

get_user(user_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the user listed on this service.

Parameters

user_id (str) – The user’s ID.

class dbots.DiscordLabs(token=None, **options)

Represents the Discord Labs service.

See also

• Discord Labs Website

• Discord Labs API Documentation

get_bot(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the bot listed on this service.

Parameters

bot_id (str) – The bot’s ID.

get_bot_votes(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the votes for this bot.

Parameters

bot_id (str) – The bot’s ID.

class dbots.DiscordListSpace(token=None, **options)

Represents the discordlist.space service.

See also

• discordlist.space Website

• discordlist.space API Documentation

get_audit_log(bot_id: str, **query) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the bot listing audit log.

Parameters

• bot_id (str) – The bot’s ID.

• **query – The query string to append to the URL.

get_bot(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the bot listed on this service.

Parameters

bot_id (str) – The bot’s ID.

get_bot_analytics(bot_id: str, **query) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the analytics on a bot.

Parameters

• bot_id (str) – The bot’s ID.

• **query – The query string to append to the URL.

get_bot_owners(bot_id: str, **query) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the owners of the bot listing.

Parameters

• bot_id (str) – The bot’s ID.

• **query – The query string to append to the URL.

get_bot_reviews(bot_id: str, **query) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the reviews of a bot.

Parameters

• bot_id (str) – The bot’s ID.

• **query – The query string to append to the URL.

get_bot_votes(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the list of people who voted this bot on this service.

Parameters

bot_id (str) – The bot’s ID.

get_bots(**query) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets a list of bots on this service.

Parameters

**query – The query string to append to the URL.

get_languages(**query) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets all the available languages that bots or servers can set as their language.

Parameters

**query – The query string to append to the URL.

get_statistics() → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the statistics of this service.

get_tags(**query) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets all available tags for use on bots or servers.

Parameters

**query – The query string to append to the URL.

get_upvote_leaderboard(bot_id: str, **query) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the top upvoters of this month.

Parameters

• bot_id (str) – The bot’s ID.

• **query – The query string to append to the URL.

get_user(user_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the user listed on this service.

Parameters

user_id (str) – The user’s ID.

get_user_bots(user_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the user’s bots listed for this service.

Parameters

user_id (str) – The user’s ID.

get_user_upvote(bot_id: str, user_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Checks if a specific user has upvoted the bot.

Parameters

• bot_id (str) – The bot’s ID.

• user_id (str) – The user’s ID.

get_widget_url(bot_id: str, style: int = 1, **query) → str

Gets the widget URL for this bot.

Parameters

• bot_id (str) – The bot’s ID.

• style (Optional[int]) – The style of the widget.

• **query – The query string to append to the URL.

class dbots.DiscordListology(token=None, **options)

Represents the DiscordListology service.

See also

• DiscordListology Website

• DiscordListology API Documentation

get_bot_stats(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the bot’s stats listed on this service. :param bot_id: The bot’s ID. :type bot_id: str

get_guild_stats(guild_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the guild’s stats listed on this service. :param guild_id: The guild’s ID. :type guild_id: str

user_voted_bot(bot_id: str, user_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Checks whether or not a user has voted for a bot on this service. :param bot_id: The bot’s ID. :type bot_id: str :param user_id: The user’s ID. :type user_id: str

user_voted_guild(guild_id: str, user_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Checks whether or not a user has voted for a guild on this service. :param guild_id: The guild’s ID. :type guild_id: str :param user_id: The user’s ID. :type user_id: str

class dbots.DiscordServices(token=None, **options)

Represents the DiscordServices service.

See also

• DiscordServices Website

• DiscordServices API Documentation

post_commands(bot_id: str, commands: list) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Posts commands info to your bot page.

Parameters

• bot_id (str) – The bot’s ID.

• commands (list) – The command info to post.

post_news(bot_id: str, title: str, content: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Posts news to your bot page.

Parameters

• bot_id (str) – The bot’s ID.

• title (str) – The title of the post.

• content (str) – The content of the post.

class dbots.DiscordsCom(token=None, **options)

Represents the Discords.com service (formerly Bots For Discord).

See also

• Discords.com Website

• Discords.com API Documentation

get_bot(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the bot listed on this service.

Parameters

bot_id (str) – The bot’s ID.

get_bot_votes(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the list of people who voted a bot.

Parameters

bot_id (str) – The bot’s ID.

get_bot_votes_12h(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the list of people who voted a bot in the last 12 hours.

Parameters

bot_id (str) – The bot’s ID.

get_user(user_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the user listed on this service.

Parameters

user_id (str) – The user’s ID.

get_user_bots(user_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the user’s bots listed for this service.

Parameters

user_id (str) – The user’s ID.

get_widget_url(bot_id: str, **query) → str

Gets the widget URL for this bot.

Parameters

• bot_id (str) – The bot’s ID.

• **query – The query string to append to the URL.

class dbots.Disforge(token=None, **options)

Represents the Disforge service.

See also

• Disforge Website

• Disforge API Documentation

get_homepage() → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Retreives the data shown on the homepage.

get_stats() → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Retreives statistics about Disforge.

class dbots.FatesList(token=None, **options)

Represents the FatesList service.

See also

• FatesList Website

• FatesList API Documentation

add_bot_command(bot_id: str, command: dict, **query) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Adds a bot promotion.

Parameters

• bot_id (str) – The bot’s ID.

• command (dict) – The command payload.

• **query – The query string to append to the URL.

add_promotion(bot_id: str, promotion: dict) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Adds a bot promotion.

Parameters

• bot_id (str) – The bot’s ID.

• promotion (dict) – The promotion payload.

delete_bot_command(bot_id: str, command_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Deletes a bot’s command.

Parameters

• bot_id (str) – The bot’s ID.

• command_id (str) – The command ID.

delete_promotion(bot_id: str, promotion_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Deletes a bot promotion.

Parameters

• bot_id (str) – The bot’s ID.

• promotion_id (str) – The promotion ID.

edit_bot_command(bot_id: str, command: dict) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Edits a bot’s command.

Parameters

• bot_id (str) – The bot’s ID.

• command (dict) – The command payload.

edit_promotion(bot_id: str, promotion: dict) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Edits a bot promotion.

Parameters

• bot_id (str) – The bot’s ID.

• promotion (dict) – The promotion payload.

get_bot(bot_id: str, **query) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets a bot from the API.

Parameters

• bot_id (str) – The bot’s ID.

• **query – The query string to append to the URL.

get_bot_commands(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Get a bot’s commands.

Parameters

bot_id (str) – The bot’s ID.

get_bot_promotion(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets a bot promotion.

Parameters

bot_id (str) – The bot’s ID.

get_random_bot() → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets a random bot.

get_votes(bot_id: str, user_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the number of votes a user gave to a bot.

Parameters

• bot_id (str) – The bot’s ID.

• user_id (str) – The user’s ID.

get_votes_timestamped(bot_id: str, user_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the number of votes a user gave to a bot with timestamps.

Parameters

• bot_id (str) – The bot’s ID.

• user_id (str) – The user’s ID.

regenerate_token(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Regenerates the API token.

Parameters

bot_id (str) – The bot’s ID.

class dbots.InfinityBotList(token=None, **options)

Represents the Infinity Bot List service.

See also

• Infinity Bot List Website

• Infinity Bot List API Documentation

get_bot(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the bot listed on this service.

Parameters

bot_id (str) – The bot’s ID.

get_user(user_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the user listed on this service.

Parameters

user_id (str) – The user’s ID.

class dbots.Listcord(token=None, **options)

Represents the Listcord service.

See also

• Listcord Website

• Listcord API Documentation

get_bot(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the bot listed on this service.

Parameters

bot_id (str) – The bot’s ID.

get_bot_pack(pack_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets a bot pack.

Parameters

pack_id (str) – The pack’s ID.

get_bot_packs() → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets all botpacks.

get_bot_reviews(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets a bot’s reviews.

Parameters

bot_id (str) – The bot’s ID.

user_voted(bot_id: str, user_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets whether a user has voted for a bot.

Parameters

• bot_id (str) – The bot’s ID.

• user_id (str) – The user’s ID.

class dbots.MotionBotlist(token=None, **options)

Represents the MotionBotlist service.

See also

• MotionBotlist Website

• MotionBotlist API Documentation

get_bot(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets a bot.

Parameters

bot_id (str) – The bot’s ID.

get_bot_votes(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets a bot’s reviews.

Parameters

bot_id (str) – The bot’s ID.

class dbots.SpaceBotsList(token=None, **options)

Represents the Space Bots List service.

See also

• Space Bots List Website

• Space Bots List API Documentation

get_bot(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the bot listed on this service.

Parameters

bot_id (str) – The bot’s ID.

class dbots.TopCord(token=None, **options)

Represents the TopCord service.

See also

• TopCord Website

• TopCord API Documentation

get_bot(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the bot listed on this service.

Parameters

bot_id (str) – The bot’s ID.

get_bots() → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Lists every bot on this service.

class dbots.TopGG(token=None, **options)

Represents the Top.gg service.

See also

• Top.gg Website

• Top.gg API Documentation

get_bot(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the bot listed on this service.

Parameters

bot_id (str) – The bot’s ID.

get_bot_stats(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the bot’s stats listed on this service.

Parameters

bot_id (str) – The bot’s ID.

get_bot_votes(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the list of people who voted this bot on this service.

Parameters

bot_id (str) – The bot’s ID.

get_bots(**query) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets a list of bots on this service.

Parameters

**query – The query string to append to the URL.

get_user(user_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the user listed on this service.

Parameters

user_id (str) – The user’s ID.

get_widget_url(bot_id: str, small_widget: Optional[str] = None, **query) → str

Gets the widget URL for this bot.

Parameters

• bot_id (str) – The bot’s ID.

• small_widget (Optional[str]) – The sub-path name to turn the widget into a badge. (i.e. owner)

• **query – The query string to append to the URL.

user_voted(bot_id: str, user_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the list of people who voted this bot on this service.

Parameters

• bot_id (str) – The bot’s ID.

• user_id (str) – The user’s ID.

class dbots.VoidBots(token=None, **options)

Represents the Void Bots service.

See also

• Void Bots Website

• Void Bots API Documentation

get_bot(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the bot listed on this service.

Parameters

bot_id (str) – The bot’s ID.

get_bot_analytics(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the bot’s analytics on this service.

Parameters

bot_id (str) – The bot’s ID.

get_bot_reviews(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the bot’s reviews on this service.

Parameters

bot_id (str) – The bot’s ID.

user_voted(bot_id: str, user_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Checks whether or not a user has voted for a bot on this service.

Parameters

• bot_id (str) – The bot’s ID.

• user_id (str) – The user’s ID.

class dbots.WonderBotList(token=None, **options)

Represents the Wonder Bot List service.

See also

• Wonder Bot List Website

• Wonder Bot List API Documentation

get_bot(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the bot listed on this service.

Parameters

bot_id (str) – The bot’s ID.

get_user(user_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the user listed on this service.

Parameters

user_id (str) – The user’s ID.

class dbots.YABL(token=None, **options)

Represents the YABL service.

See also

• YABL Website

• YABL API Documentation

get_bot(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the bot listed on this service.

Parameters

bot_id (str) – The bot’s ID.

get_bots() → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets a list of bots on this service.

get_bots_by_page(**query) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets a page of bots on this service.

Parameters

**query – The query string to append to the URL.

get_random_bots() → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets 20 random bots from this service.

get_unverified_bots() → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets a list of unverified bots on this service.

get_user_bots(user_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Gets the user’s bots listed for this service.

Parameters

user_id (str) – The user’s ID.

invalidate(bot_id: str) → HTTPResponse

This function is a coroutine returning a HTTPResponse.

Invalidates the token being used in the request.