DEVELOPERS

The Steam BANGERS API.

A free, read-only JSON API for the BANG Score — one 0-to-100 rating of how much real game you get for your money, for games on Steam. Rank games, look one up, or search by name. The exact scoring formula stays private; the score and its public inputs are yours to use.

Get a key

Every request needs a key. It is free, issued instantly, and shown only once — save it somewhere safe.

Authentication

Send your key as a bearer token (preferred), or as an api_key query parameter:

curl https://steambangers.com/api/v1/games \
  -H "Authorization: Bearer sb_live_your_key_here"

# or, for quick tests:
curl "https://steambangers.com/api/v1/games?api_key=sb_live_your_key_here"

Endpoints

GET /api/v1/games — games ranked by BANG Score. Query params (all optional): genre (comma-separated: rpg, shooter, strategy, narrative, roguelike, multiplayer, indie_short, other), year_from, year_to, on_sale=true, page (10 per page).

GET /api/v1/games?genre=rpg&on_sale=true&page=1

{
  "page": 1, "pages": 39, "total": 385,
  "games": [
    {
      "appid": 413150,
      "name": "Stardew Valley",
      "bang_score": 97,
      "tier": "banger",
      "genre": "rpg",
      "price_usd": 14.99,
      "discount_percent": 0,
      "review_score": 0.98,
      "length_hours": 53.4,
      "finish_rate": 0.349,
      "release_year": 2016,
      "url": "https://steambangers.com/game/413150/stardew-valley"
    }
  ]
}

GET /api/v1/games/{appid} — one game, with extra fields: developer, publisher, metacritic, completionist_hours, and the price it becomes a banger / worth-it at.

GET /api/v1/games/413150

{ "appid": 413150, "name": "Stardew Valley", "bang_score": 97,
  "becomes_banger_at_usd": 24.99, "worth_it_at_usd": 39.99, ... }

GET /api/v1/search?q={query} — search games by name.

The API root GET /api/v1 returns this list as JSON (no key needed) so your client can introspect it.

Rate limits

Terms of use