SweepWidget API
Build powerful integrations with full programmatic control over giveaways, entries, participants, and analytics.
Get Started in Minutes
A simple request to list your giveaways. That is all it takes to get up and running.
curl -X GET \
https://sweepwidget.com/sw_api/v2/giveaways \
-H "Authorization: Bearer YOUR_API_KEY"{
"success": true,
"data": [
{
"id": 12345,
"title": "Summer Giveaway",
"status": "active",
"entries": 1847,
"participants": 923
}
],
"pagination": {
"page": 1,
"per_page": 25,
"total": 48
}
}What You Can Build
Everything you need to integrate giveaways into your platform.
Full Giveaway Management
Create, update, duplicate, and delete giveaways programmatically.
Entry and Participant Tracking
Track entries, manage participants, and monitor engagement in real time.
Analytics and Insights
Access daily stats, geographic data, entry method breakdowns, and fraud reports.
Webhooks and Events
Get real-time notifications when entries, completions, and milestones occur.
Security and Access Control
Configure IP checks, VPN blocking, email verification, and country restrictions.
Whitelist and Blacklist
Control participant access with email whitelists and value-based blacklists.
16 Endpoint Categories
74 endpoints organized into intuitive categories covering every aspect of your giveaways.
Three Ways to Authenticate
Choose the authentication method that works best for your integration.
Bearer Token
RecommendedAuthorization: Bearer YOUR_API_KEY
Pass your API key in the Authorization header. This is the most secure and recommended approach.
X-API-Key Header
X-API-Key: YOUR_API_KEY
An alternative header-based approach. Useful when the Authorization header is already in use.
Query String
?api_key=YOUR_API_KEY
Append your key as a query parameter. Best for quick testing. Not recommended for production use.
Rate Limits
Available exclusively on the Enterprise plan.
