📚 API Documentation

Everything you need to integrate FloodBomb into your application

Getting Started

Base URL
https://api.floodbomb.xyz

FloodBomb provides a simple REST API for email flooding. All requests should include your API key for authentication.

Authentication

Include your API key in the request body or as a query parameter:

Request Body
{ "key": "fb_your_api_key_here", ... }

Pricing

💧 Normal Mode

from $1
300-2400 floods

⚡ Blast Mode

from $2
700-3600 floods

Pricing scales with duration. Longer durations = more floods at better rates.

Endpoints

POST /v1/flood/normal

Start a normal flood. Flood count scales with duration (300-2400 floods).

Parameters
Name Type Description
key * string Your API key
email * string Target email address
time * integer Duration in minutes
Request Example
curl -X POST https://api.floodbomb.xyz/v1/flood/normal \ -H "Content-Type: application/json" \ -d '{ "key": "fb_your_api_key", "email": "target@example.com", "time": 10 }'
Response
{ "success": true, "id": "abc123xyz", "mode": "normal", "floods": 150, "cost": 1.0, "balance": 9.0, "schedule": "instant" }
POST /v1/flood/blast

Start a blast flood. Flood count scales with duration (700-3600 floods).

Parameters
Name Type Description
key * string Your API key
email * string Target email address
time * integer Duration in minutes
Request Example
curl -X POST https://api.floodbomb.xyz/v1/flood/blast \ -H "Content-Type: application/json" \ -d '{ "key": "fb_your_api_key", "email": "target@example.com", "time": 10 }'
Response
{ "success": true, "id": "xyz789abc", "mode": "blast", "floods": 350, "cost": 2.0, "balance": 8.0, "schedule": "instant" }
GET /v1/balance

Check your current balance.

Parameters
Name Type Description
key * string Your API key (query parameter)
Request Example
curl https://api.floodbomb.xyz/v1/balance?key=fb_your_api_key
Response
{ "success": true, "balance": 10.0 }

Error Responses

When an error occurs, the API returns a JSON response with error details:

{ "detail": "Insufficient balance. Required: $1, Available: $0.50" }

Common Errors

  • 401 - Invalid API key
  • 400 - Insufficient balance
  • 400 - Invalid email format
  • 500 - Server error

Code Examples

Python

import requests API_KEY = "fb_your_api_key" BASE_URL = "https://api.floodbomb.xyz" # Normal flood response = requests.post(f"{BASE_URL}/v1/flood/normal", json={ "key": API_KEY, "email": "target@example.com", "time": 10 }) print(response.json()) # Check balance response = requests.get(f"{BASE_URL}/v1/balance?key={API_KEY}") print(response.json())

JavaScript

const API_KEY = "fb_your_api_key"; const BASE_URL = "https://api.floodbomb.xyz"; // Normal flood fetch(`${BASE_URL}/v1/flood/normal`, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ key: API_KEY, email: "target@example.com", time: 10 }) }) .then(res => res.json()) .then(data => console.log(data)); // Check balance fetch(`${BASE_URL}/v1/balance?key=${API_KEY}`) .then(res => res.json()) .then(data => console.log(data));