# Mass Broadcast & Telemetry APIs

> Send high-speed mass broadcasts to all bot subscribers with inline buttons and delivery stats.

**Category:** REST API Reference  
**URL:** https://docs.botlify.cloud/api-broadcast  
**Platform:** Botlify Cloud (https://botlify.cloud)  

---

## 1. Broadcast Audience Stats (broadcast_stats)

   

Action: `broadcast_stats`
   Parameters: `bot_id`
   Returns total subscribers and active user counts in the bot database.

   

## 2. Dispatch Broadcast (send_broadcast)

   

Action: `send_broadcast`
   Parameters:

   
    
- bot_id: Target bot ID

    
- message: HTML or Markdown formatted text

    
- audience: all or active7d (active in last 7 days)

    
- photo_url (optional): Image URL to attach

    
- keyboard (optional): Inline button grid

   
   
```php
curl -X POST https://botlify.cloud/api/v1   -H "X-API-KEY: YOUR_KEY"   -H "Content-Type: application/json"   -d '{
    "action": "send_broadcast",
    "bot_id": 14,
    "message": "🔥 Special Announcement!
New features are live.",
    "audience": "all"
  }'
```