topbotgg Dart Package

topbotgg is a Dart package made for users to interact with the topbot.gg API.

This package was designed so your Discord bot can use any Discord API package. This package has been tested with nyxx v6.

Installation

Before using, make sure you are using Dart v3.1 or newer.

Method 1: Install via git

Add the following to your pubspec.yaml file

dependencies:
	topbotgg:
		git: https://codeberg.org/ahsokasoftware/topbotgg.git
	# Your other dependencies here

Method 2: Install via pub.dev

Add the following to your pubspec.yaml file

dependencies:
	topbotgg: 1.0.0-beta.1
	# Your other dependencies here

Usage

You can refer to the example directory for examples on using this package.

Support Checklist:

  • /api/v1/bots = No
  • /api/v1/bots/{id} = WORKING
  • /api/v1/search = WORKING
  • /api/v1/bots/{id}/reviews = WORKING
  • /api/v1/bots/{id}/history = No
  • /api/v1/bots/{id}/votes = WORKING
  • /api/v1/bots/{id}/check/{userId} = WORKING
  • /api/v1/bots/{id}/premium/{userId} = Partially untested
  • /api/v1/bots/{id}/premium/guild/{guildId} = Partially untested
  • /api/v1/bots/{id}/stats = WORKING!
  • English text logs = WORKING!
  • German text logs = No

Release Dates:

  • V1.0.0-beta.1: October 2nd, 2026
  • Started on: September 19th, 2026

Libraries

topbotgg