discord-botlists.

discord-botlists docs · archived reader

Guides

Custom lists

Self-hosted or missing lists.

const lists = new Botlists({
  lists: [{
    id: 'my-list.dev',
    name: 'My List',
    website: 'https://my-list.dev',
    apiPost: 'https://api.my-list.dev/bots/:id/stats',
    postField: 'server_count',
    postMethod: 'POST',
    authHeader: 'Authorization',
    tokenEnvKey: 'DBL_MYLIST',
    webhook: { header: 'Authorization', voterField: 'user_id', eventField: null },
    supports: { post: true, get: false, widget: false, webhook: true },
    apiDocs: null, apiGet: null, viewBot: null, widget: null,
    shardField: null, shardIdField: null, shardsArrayField: null,
  }],
});

Custom lists work everywhere built-in ones do: posting, webhooks, parsing, status probing and the env token pattern. Request built-in support for any live list through the list-request issue template.