Blitz Rocket API Documentation

Build powerful contest and giveaway integrations with the Blitz Rocket API

On this page

Introduction

The Blitz Rocket API allows you to programmatically manage contests, entries, bonus actions, and referral tracking. Use the REST API to integrate Blitz Rocket's contest platform into your existing applications, automate workflows, and build custom experiences.

Base URL

All API requests should be made to:

https://blitzrocket.com/api/v1

What you can do

  • Contests — List and retrieve contest details, analytics, and leaderboards
  • Entries — Create, update, disqualify entries, and manage participant points
  • Bonus Actions — Retrieve and complete bonus actions for contest entries
  • Purchases — Record and track purchases tied to contest entries
  • Leaderboard — Fetch ranked leaderboards for any contest
  • Analytics — Pull contest performance metrics
  • Webhooks — Receive real-time notifications for signups and purchases
  • Referral Tracking — Track visits, signups, and purchases through referral links

Quick Start

  1. Get your API key — Navigate to your team settings in the Blitz Rocket dashboard and create an API key
  2. Choose your key type — Use a public key for read-only access or a private key for full read/write access
  3. Make your first request — Try listing your contests:
curl -X GET https://blitzrocket.com/api/v1/contests \
  -H "x-api-key: your_api_key_here"

const response = await fetch("https://blitzrocket.com/api/v1/contests", {
  headers: {
    "x-api-key": "your_api_key_here",
  },
});
const data = await response.json();
console.log(data);

import requests

response = requests.get(
    "https://blitzrocket.com/api/v1/contests",
    headers={"x-api-key": "your_api_key_here"}
)
data = response.json()
print(data)

Response Format

All API responses follow a consistent format:

Success Response:

{
  "success": true,
  "data": { ... }
}

Error Response:

{
  "success": false,
  "error": "A description of what went wrong"
}

Next Steps