Skip to main content

Dotnet Library

The community-maintained .NET Library for Top.gg. If you experience any issues please submit an issue on Github.

Installation​

Nuget​

If you're using Nuget you can use and/or find it with the ID DiscordBotsList.Api or use.

Install-Package DiscordBotsList.Api

Usage​

Unauthorized API Usage​

Setting Up​

DiscordBotListApi DblApi = new DiscordBotListApi();

Getting Bots​

//                            discord id
IBot bot = DblApi.GetBotAsync(160105994217586689);

Getting Users​

//                              discord id
IUser bot = DblApi.GetUserAsync(121919449996460033);

Authorized API Usage​

Setting Up​

AuthDiscordBotListApi DblApi = new AuthDiscordBotListApi(BOT_DISCORD_ID, YOUR_TOKEN);

Updating Stats​

ISelfBot me = await DblApi.GetMeAsync();
await me.UpdateStatsAsync(
  // indexShard
  24,
  // shardCount
  50,
  // shards
  new[] { 12, 421, 62, 241, 524, 534 }
);

// Update stats           guildCount
await me.UpdateStatsAsync(2133);

Widgets​

string widgetUrl = new SmallWidgetOptions()
	.SetType(WidgetType.OWNER)
	.SetLeftColor(255, 255, 255)
	.Build(160105994217586689);

Generates the following: