Developer API ReferenceComing Soon
Overlay Stream Feed API
Access the real-time event feed that drives OBS transparent overlays and stream alert widgets.
API Status: Coming Soon
The Overlay Event Feed API is currently in internal development and is not yet publicly released. The schema below illustrates the planned overlay stream payload.
Poll Stream Events
GET/api/v1/public/overlay/:streamer
Auth: PublicReturns current active hunt status, last roll winner event, and recent giveaway candidate entries. Overlays poll this endpoint every 2.5 seconds.
curl -X GET https://buzzeee.com/api/v1/public/overlay/trainwreckstvEvent Feed Payload Schema
Sample Overlay Feed Response (JSON)
{
"streamer": {
"displayName": "Trainwreckstv",
"primaryPlatform": "KICK"
},
"winnerEvent": {
"id": "roll_98a123f",
"type": "giveaway_roll",
"winnerUsername": "LuckyChatter",
"winnerPlatform": "KICK",
"titleOrSlot": "$1,000 Main Giveaway",
"digestOrProof": "7d793037a0760186...32b",
"timestamp": 1728561600000
},
"hunt": {
"id": "hunt_42",
"title": "Sunday Night Opening",
"status": "OPENING",
"totalBonuses": 45,
"winnings": 12450.00
}
}