Core Concepts
Fetching data
fetchBot, fetchVotes, hasVoted, searchBots, widgets.
const bot = await lists.fetchBot('discord.bots.gg', '557628352828014614');
bot.name; // 'Ticket Tool'
bot.prefix; // '$ (Customizable)'
bot.library; // 'discord.js'
const votes = await lists.fetchVotes('top.gg'); // number | null
const voted = await lists.hasVoted('top.gg', userId); // boolean | null
const found = await lists.searchBots('botlist.me', 'music', 5);
lists.widgetUrl('top.gg'); // widget image url
lists.viewBotUrl('top.gg'); // listing page urlNotetop.gg and voidbots require a token even for reads. Lists without a public bot endpoint throw a BotlistsError with listId attached; catch it and fall back.