BDTools API

v2.0

A public API for Bot Designer for Discord tools, node status monitoring, guild list management, and more. 

// Base URL
https://api.bdtools.xyz

Get Your API Key

  1. Visit api.bdtools.xyz
  2. Sign in with your Discord account
  3. Copy your personal API key from the dashboard
// Using your API key in BDFD
$httpAddHeader[Authorization;Bearer YOUR_API_KEY]

Authentication

Guild List endpoints require authentication via JWT Bearer token. Include your API key in the Authorization header. 

// Authorization header format
Authorization: Bearer YOUR_API_KEY_HERE

Note: Only /submit-server, /get-servers, /bdscript-checker, and /ticket-transcript require authentication. All other endpoints are public.

API Documentation

8 endpoints

Node Status

Monitor BDFD node availability and status across all regions.

View Docs
2 endpoints

Guild List

Submit and retrieve bot guild lists with pagination support.

View Docs
2 endpoints

BDScript

Validate BDScript code and look up BDFD functions.

View Docs
2 endpoints

Ticket Transcript

Generate and host ticket transcripts for BDFD bots.

View Docs
4 endpoints

Tools

Escape/unescape BDFD characters and calculate Discord permission bitfields.

View Docs
3 endpoints

Other Endpoints

Word games and Pokemon data for Discord bots.

View Docs

Data Freshness

Node Status Updates every 2 minutes via scheduled scraper
Guild List Cached until a new submission replaces the data
BDScript Function list cached and refreshed periodically
Ticket Transcript Stored permanently on the server. Manual deletion only.
Tools Stateless, no server-side caching. Results computed on demand.
Other Endpoints Data queried live from upstream sources on each request
Copied!