Top.gg SDK for C++

The official C++ SDK for the Top.gg API.

Building from source

Linux (Debian-like):

# install D++
wget -O dpp.deb https://dl.dpp.dev/latest
dpkg -i dpp.deb

# build topgg
cmake -B build .
cmake --build build --config Release

Linux (CentOS-like):

# install D++
yum install wget
wget -O dpp.rpm https://dl.dpp.dev/latest/linux-x64/rpm
yum localinstall dpp.rpm

# build topgg
cmake -B build .
cmake --build build --config Release

macOS:

# install D++
brew install libdpp
brew link libdpp

# build topgg
cmake -B build .
cmake --build build --config Release

Windows:

cmake -B build .
cmake --build build --config Release

Examples

Fetching a bot from its Discord ID

#include <topgg/topgg.h>
#include <dpp/dpp.h>
#include <iostream>

int main() {
  dpp::cluster bot{"your bot token"};
  topgg::client topgg_client{&bot, "your top.gg token"};

  topgg_client.get_bot(264811613708746752, [](const auto& result) {
    try {
      const auto topgg_bot = result.get();
    
      std::cout << topgg_bot.username << std::endl;
    } catch (const std::exception& ext) {
      std::cout << "error: " << ext.what() << std::endl;
    }
  });

  return 0;
}

Fetching a user from its Discord ID

#include <topgg/topgg.h>
#include <dpp/dpp.h>
#include <iostream>

int main() {
  dpp::cluster bot{"your bot token"};
  topgg::client topgg_client{&bot, "your top.gg token"};

  topgg_client.get_user(661200758510977084, [](const auto& result) {
    try {
      const auto user = result.get();
    
      std::cout << user.username << std::endl;
    } catch (const std::exception& ext) {
      std::cout << "error: " << ext.what() << std::endl;
    }
  });

  return 0;
}

Posting your bot's statistics

#include <topgg/topgg.h>
#include <dpp/dpp.h>
#include <iostream>

int main() {
  dpp::cluster bot{"your bot token"};
  topgg::client topgg_client{&bot, "your top.gg token"};

  const size_t server_count = 12345;

  topgg_client.post_stats(topgg::stats{server_count}, []() {
    std::cout << "stats posted!" << std::endl;
  });

  return 0;
}

Checking if a user has voted your bot

#include <topgg/topgg.h>
#include <dpp/dpp.h>
#include <iostream>

int main() {
  dpp::cluster bot{"your bot token"};
  topgg::client topgg_client{&bot, "your top.gg token"};

  topgg_client.has_voted(661200758510977084, [](const auto& result) {
    try {
      if (result.get()) {
        std::cout << "checks out" << std::endl;
      }
    } catch (const std::exception& ext) {
      std::cout << "error: " << ext.what() << std::endl;
    }
  });

  return 0;
}

Cached autoposting

If you want for the SDK to automatically retrieve the server count itself by listening to Discord's gateway events, use topgg::autoposter::cached!

#include <topgg/topgg.h>
#include <dpp/dpp.h>

int main() {
  std::shared_ptr<dpp::cluster> bot{new dpp::cluster{"your bot token"}};
  
  topgg::autoposter::cached autoposter{bot, "your top.gg token", std::chrono::minutes(15)};

  // your bot's code...

  return 0;
}

Stats-fed autoposting

If you want to use your own function (e.g: retrieve the server count on your own by making an SQL query), then you can use topgg::autoposter::custom!

#include <topgg/topgg.h>
#include <dpp/dpp.h>

static topgg::stats fetch_stats(dpp::cluster* bot) {
  // fetch server count here...
}

int main() {
  std::shared_ptr<dpp::cluster> bot{new dpp::cluster{"your bot token"}};
  
  topgg::autoposter::custom autoposter{bot, "your top.gg token", std::chrono::minutes(15), fetch_stats};

  // your bot's code...

  return 0;
}