Universe List NPM Package

The offical Node SDK to interact with Universe List's API.

npm i universe-list.js

Getting Started

To post your bot's stats to Universe List, you will need a Discord client and the universe-list.js package defined.

const { Client, Events, GatewayIntentBits } = require('discord.js');
const universeList = require('universe-list.js');

const client = new Client({ intents: [GatewayIntentBits.Guilds] });

POSTing bot's stats

First, define your Discord client, and then provide your Universe List API Key found in your bot's edit page.

const Discord = require('discord.js');
const client = new Discord.Client();
const API_KEY = 'YOUR_API_KEY';

// Login to your bot
client.login('BOT_TOKEN')

// Post stats 
 client.on('ready', () => {
setInterval(async () => {
  try {
    await postStats(client, API_KEY);
  } catch (error) {
    console.error(`Failed to post stats: ${error}`);
  }
}, 5 * 60 * 1000); // Posts every 5 minutes
});

Debug Mode

If you want to log the response message to the console, add true as parameter. await postStats(client, API_KEY, true);

GETing bot's info

Provide a Discord bot ID of a bot that is on Universe List.

const botId = '123456789'; // Replace this with the ID of the bot.

universeList.fetchBot(botId)
  .then((botData) => {
    console.log(botData);
  })
  .catch((err) => {
    console.error(err);
  });

GETing server's info

Provide a Discord server ID of a server that is on Universe List.

const serverId = '123456789'; // Replace this with the ID of the server.

universeList.fetchServer(serverId)
  .then((serverData) => {
    console.log(serverData);
  })
  .catch((err) => {
    console.error(err);
  });

GETing bots's votes

Provide a Discord bot ID of a bot that is on Universe List.

const botId = '123456789'; // Replace this with the ID of the bot.

universeList.fetchVotes(botId)
  .then((votes) => {
    console.log(votes);
  })
  .catch((err) => {
    console.error(err);
  });

Check Vote from user

Provide a Discord bot ID of a bot that is on Universe List and a Discord user ID.

const botId = '123456789'; // Replace this with the ID of the bot.
const userId = '987654321'; // Replace this with the ID of the user.

universeList.checkVote(botId, userId)
  .then((voteData) => {
    console.log(voteData);
  })
  .catch((err) => {
    console.error(err);
  });

Credits

This API was originally created by Ishaan Garg and was later modified by Tejas Lamba.