Developer

Public API

Invite-only, read-only REST API for tracked Steam games and active review-bomb alerts. Request access first.

Base URL

https://www.sweepleague.com/api/v1

Auth

API key required (x-reviewbomb-api-key)

Format

JSON (UTF-8)

GET/api/v1/games

List tracked Steam games.

Parameters

Name	Type	Description
q	string	Filter by game name (case-insensitive substring).
tier	AAA \| MID \| INDIE	Filter by catalog tier.
limit	number	Max results (1–100, default 20).
offset	number	Pagination offset (default 0).

Example request

curl -H "x-reviewbomb-api-key: YOUR_API_KEY" "https://www.sweepleague.com/api/v1/games?tier=AAA&limit=5"

Example response

{
  "data": [
    {
      "steam_app_id": 730,
      "name": "Counter-Strike 2",
      "developer": "Valve",
      "tier": "AAA",
      "review_score": 72,
      "steam_rank": 1,
      "total_reviews": 8500000
    }
  ],
  "meta": { "total": 312, "limit": 5, "offset": 0 }
}

GET/api/v1/games/:steamAppId

Get a single game by its Steam App ID.

Parameters

Name	Type	Description
steamAppId	number	Steam App ID (path parameter).

Example request

curl -H "x-reviewbomb-api-key: YOUR_API_KEY" "https://www.sweepleague.com/api/v1/games/730"

Example response

{
  "data": {
    "steam_app_id": 730,
    "name": "Counter-Strike 2",
    "developer": "Valve",
    "tier": "AAA",
    "review_score": 72,
    "total_reviews": 8500000,
    "last_checked": "2025-01-01T12:00:00Z"
  }
}

GET/api/v1/alerts

List active review-bomb alerts.

Parameters

Name	Type	Description
direction	NEGATIVE \| POSITIVE	Filter by alert direction.
limit	number	Max results (1–100, default 20).
offset	number	Pagination offset (default 0).

Example request

curl -H "x-reviewbomb-api-key: YOUR_API_KEY" "https://www.sweepleague.com/api/v1/alerts?direction=NEGATIVE&limit=10"

Example response

{
  "data": [
    {
      "id": 42,
      "steam_app_id": 730,
      "alert_tier": "NUCLEAR",
      "alert_direction": "NEGATIVE",
      "started_at": "2025-01-01T08:00:00Z",
      "is_active": true,
      "games": {
        "name": "Counter-Strike 2",
        "tier": "AAA",
        "review_score": 72
      }
    }
  ],
  "meta": { "total": 3, "limit": 10, "offset": 0 }
}

GET/api/v1/alerts/:id

Get a single alert by ID, including its event timeline.

Parameters

Name	Type	Description
id	number	Alert ID (path parameter).

Example request

curl -H "x-reviewbomb-api-key: YOUR_API_KEY" "https://www.sweepleague.com/api/v1/alerts/42"

Example response

{
  "data": {
    "id": 42,
    "steam_app_id": 730,
    "alert_tier": "NUCLEAR",
    "alert_direction": "NEGATIVE",
    "started_at": "2025-01-01T08:00:00Z",
    "ended_at": null,
    "is_active": true,
    "games": { "name": "Counter-Strike 2", "tier": "AAA" },
    "events": [
      {
        "id": 1,
        "alert_id": 42,
        "event_type": "TIER_ESCALATION",
        "previous_tier": "WARNING",
        "new_tier": "NUCLEAR",
        "created_at": "2025-01-01T09:30:00Z"
      }
    ]
  }
}

Access policy

API v1 is contact-first and invite-only. Request access before using these endpoints. Approved clients receive an API key to send in the x-reviewbomb-api-key header (or Authorization: Bearer token). This is a custom ReviewBomb key and is not the Supabase anon key or service role key. For access requests, contact via repository issues.