Bot reference

class topstats.bot.PartialBot

A Discord bot’s brief information.

property created_at: datetime

When this bot was created.

id: int

This bot’s Discord ID.

monthly_votes: Ranked

The amount of votes this bot has this month.

name: str

This bot’s username.

review_count: Ranked | None

The amount reviews this bot has.

server_count: Ranked

The amount servers this bot is in.

total_votes: Ranked

The amount of votes this bot has.

class topstats.bot.Bot

A Discord bot’s detailed information.

avatar: str

This bot’s avatar URL.

property created_at: datetime

When this bot was created.

daily_difference: float | None

Difference percentage from the previous day.

id: int

This bot’s Discord ID.

is_deleted: bool

Whether this bot is deleted or not.

monthly_difference: float | None

Difference percentage from the previous month.

monthly_votes: Ranked

The amount of votes this bot has this month.

name: str

This bot’s username.

owners: list[int]

This bot’s owner IDs.

prefix: str

This bot’s prefix.

review_count: Ranked | None

The amount reviews this bot has.

server_count: Ranked

The amount servers this bot is in.

short_description: str

This bot’s short description.

submitted_at: datetime

When this bot was submitted on Top.gg.

tags: list[str]

This bot’s tags.

timestamp: datetime

When this bot was updated by topstats.gg.

topgg_id: int | None

This bot’s Top.gg ID.

total_votes: Ranked

The amount of votes this bot has.

website: str

This bot’s website URL.

class topstats.bot.TimestampedBotStats

A Discord bot’s timestamped stats. This class contains several data points and their dated timestamps.

monthly_votes: Ranked

The amount of votes this bot has this month.

review_count: Ranked | None

The amount reviews this bot has.

server_count: Ranked

The amount servers this bot is in.

timestamp: datetime

When this stats was retrieved.

total_votes: Ranked

The amount of votes this bot has.

class topstats.bot.RecentBotStats

A Discord bot’s recent stats for the past 30 hours and past month.

daily: list[TimestampedBotStats]

This bot’s stats for the past month.

hourly: list[TimestampedBotStats]

This bot’s stats for the past 30 hours.

class topstats.data.Ranked

A ranked data point. This class contains a value and its rank compared to others and/or difference compared to its previous data point.

difference: int | None

This data point’s change difference compared to its previous data point.

rank: int | None

This data point’s rank compared to others.

value: int | None

This data point’s value.

class topstats.data.Timestamped

A timestamped data point. This class contains a value and its dated timestamp.

timestamp: datetime

When this data point was retrieved.

value: int | None

This data point’s value.