discord-botlists.

discord-botlists docs · archived reader

Guides

Rate limit safety

How the SDK stays polite to every API.

  • Posts: 250 ms gap between lists, retries on 429 and 5xx honouring Retry-After exactly once before failing.
  • BotBlock mode: one request total, never retried inside their 120 s window.
  • Status probes: max 8 concurrent HEAD requests, browser user agent, board cached for 5 minutes.
  • Fetches: token header only on endpoints that need it, public reads stay unauthenticated.
  • Webhooks: push based, so there is zero polling traffic against any list API.