botblock.org

What It Is

BotBlock is a bot list aggregation project for the Discord Bot ecosystem, and also provides a centralized guild/server count API. Its goal is to help developers discover all list sites where Discord bots can be published, and to sync a bot’s server count to multiple supported lists through a unified API, reducing the maintenance burden of integrating with each list API separately.

Core Capabilities and Ecosystem

Its core endpoint is POST /api/count: developers submit server_count, bot_id, and the API keys for each list, and BotBlock forwards the data to the corresponding bot lists. It also provides GET /api/bots/{id} for aggregated bot information, plus GET /api/lists and GET /api/lists/{id} for metadata about list sites, including API fields, languages, whether they are discontinued, whether they are Discord-only, widgets, and feature support. The site tracks many feature dimensions, such as voting, webhooks, categories/tags, verification, mobile support, search, advertising, paid promotion, long-description formats, and internationalization, making it useful for choosing lists and making integration decisions.

Open Source, API, and Documentation

The main text clearly states that BotBlock is fully open source, that its API is built on Cloudflare Workers, and that the API does not use logging, to avoid intentionally storing incoming list API tokens. The documentation is solid, with curl examples, JSON schemas, success and failure responses, 400/404/429 errors, rate-limit headers, and more. Rate-limit information is also relatively clear: for example, successful /api/count requests are limited to 1/120s, while GET /api/bots/{id} is limited to 1/30s. The page mentions API Libraries, but the scraped text does not list specific languages or SDKs.

Pricing and Limitations

The scraped content does not mention BotBlock’s own pricing, commercial plans, payment methods, or SLA. Items such as Paid Access and Offers Paid Promotion on the page appear to be feature flags for third-party bot lists, and should not be interpreted as BotBlock charging fees. Its main limitation is that it is highly dependent on the Discord bot list ecosystem, and aggregated results are affected by the availability, field differences, and data quality of third-party list APIs.

Who It’s For and Access from China

BotBlock is best suited for Discord Bot developers, bot list maintainers, and operators who need to compare features across different listing sites. It is a poor fit for general backend, CI/CD, or API management needs. The main text does not provide information about access from China, and because its ecosystem depends on Discord and multiple overseas list sites, real-world connectivity may be affected by external services. Payment information is also not disclosed. Alternatives include integrating directly with each bot list’s official API, or building a self-hosted server-count synchronization service.