API Integration

Use your API key to integrate BuzzMaster with your own apps or bots.

API Key

IP Whitelist

Enter IP addresses allowed to use this API key (one per line). Leave blank to allow all IPs.

Endpoints

GET
{
  "success": true,
  "user": {
    "email": "user@example.com",
    "balance": 12.50
  }
}
GET
{
  "success": true,
  "count": 24,
  "products": [
    {
      "product_id": "prd_b0b097a6c5e9",
      "name": "Outlook Trusted [Graph API]",
      "category": "Outlook Accounts",
      "price": 0.01,
      "available_qty": 150
    }
  ]
}
GET

Replace PRODUCT_ID with the product's product_id from the products list.

{
  "success": true,
  "product": {
    "product_id": "prd_b0b097a6c5e9",
    "name": "Outlook Trusted [Graph API]",
    "category": "Outlook Accounts",
    "price": 0.01,
    "available_qty": 150,
    "max_per_order": 10000,
    "description": "Fresh outlook accounts"
  }
}
GET

Replace ORDER_ID with the order ID returned from a purchase.

{
  "success": true,
  "order": {
    "order_id": "a1b2c3d4-...",
    "order_uid": "#7391850264",
    "product_name": "Outlook Trusted",
    "quantity": 2,
    "total_price": 0.02,
    "status": "completed",
    "credentials": "email@outlook.com|Pass123",
    "created_at": "2026-02-22T..."
  }
}
GET
Param Description
limit Number of orders to return (1–50, default 10)
offset Pagination offset (default 0)

Returns your most recent orders (newest first). Useful for recovering orders after a 502 timeout on /buy.

{
  "success": true,
  "count": 2,
  "total": 48,
  "limit": 10,
  "offset": 0,
  "orders": [
    {
      "order_id": "buzz847291",
      "product_id": "prod_abc",
      "product_name": "Gmail Accounts",
      "quantity": 5,
      "total_price": 2.50,
      "status": "success",
      "credentials": "email1:pass1\nemail2:pass2",
      "created_at": "2026-07-08T..."
    }
  ]
}
POST
Field Value
product_id ID of the product to buy
amount Quantity to purchase (1–100)
api_key Your API key

Send as JSON body. API key can also be passed as X-API-KEY header.

{
  "success": true,
  "order": {
    "order_id": "a1b2c3d4-e5f6-...",
    "order_uid": "#7391850264",
    "product": "Outlook Trusted [Graph API]",
    "quantity": 1,
    "total_price": 0.01,
    "credentials": "email@outlook.com|Password123",
    "status": "completed",
    "created_at": "2026-02-22T..."
  }
}
GET
{
  "success": true,
  "wallet": {
    "current_balance": 12.50,
    "total_spent": 45.20,
    "total_deposits": 57.70
  }
}

Gmail OTP

Rent temporary Gmails to receive verification codes. Every OTP service is sold at a single flat USD price. All actions charge your wallet exactly like the website, in USD, and refund automatically if delivery fails. Pass your key via the X-API-KEY header (or ?api_key=).

List OTP services & prices

GET
https://buzzmaster.market/api/v2/otp/services
{
  "success": true,
  "count": 120,
  "services": [
    { "service": "telegram", "price": 0.0486, "stock": 42, "in_stock": true },
    { "service": "instagram", "price": 0.0486, "stock": 15, "in_stock": true }
  ]
}

Create an OTP order (rent a Gmail)

POST
https://buzzmaster.market/api/v2/otp/create

Body (JSON): { "service": "telegram" }. The email is returned immediately — use it on the target service, then poll the check endpoint.

{
  "success": true,
  "order": {
    "order_id": 8421,
    "service": "telegram",
    "email": "someuser@gmail.com",
    "price": 0.0486,
    "status": "created"
  }
}

Check OTP code

GET
https://buzzmaster.market/api/v2/otp/check?order_id=8421

Poll every ~4s until status becomes completed.

{
  "success": true,
  "order_id": 8421,
  "service": "telegram",
  "email": "someuser@gmail.com",
  "otp": "504122",
  "status": "completed",
  "refunded": false
}

Security Recommendation

For better security, pass your API key using the X-API-KEY header instead of query parameters. Keys in URLs may appear in server logs, browser history, and referrer headers.

curl -H "X-API-KEY: YOUR_API_KEY" \
  https://buzzmaster.market/api/v2/products

Payment Webhook (IPN) Verification

When a payment is completed, our system processes it automatically. If you integrate with our API for bulk purchasing, you can verify order status using the /api/v2/order-status endpoint.

All payment callbacks from our payment processor are verified server-side using HMAC-SHA512 signature verification via the x-nowpayments-sig header. This ensures no one can forge payment confirmations.

Your purchases are protected. Payment verification is handled automatically by our server. No action is needed on your end.

Error Response Format

{"success": false, "error": "Human-readable error message"}

400 — Bad input or validation error

401 — Missing or invalid API key

403 — IP whitelist blocked

404 — Resource or endpoint not found

500 — Server error (contact support)