Loot Radar API

Authentication

Pass your key in the X-API-Key header, or as ?key=. Keys start with lr_. Keep them secret — one account per person, don't publish your key.

curl -H "X-API-Key: lr_your_key_here" \
  https://radar.codemeoww.com/api/deals

GET /api/deals

Live deal listings. Defaults to Steam deals at 70%+ off, sorted by biggest discount. Steam deals link straight to the Steam store page; deals from other stores link through the upstream redirect (their data source only exposes deal IDs, not store URLs).

Filters: storeID (default 1 = Steam), upperPrice, lowerPrice, title, exact, onSale, steamAppID, metacritic, steamRating, minimumReviewCount, maxAge (1–2500 hours), steamworks, AAA, sortBy (Savings, Price, Title, Metacritic, Release, DealRating, Reviews, ReviewCount, Store, Recent), desc, pageNumber, pageSize (max 60), minSavings (default 70 — set 0 to disable). Add output=RSS to get the same feed as raw RSS instead of JSON.

curl -H "X-API-Key: lr_your_key_here" \
  "https://radar.codemeoww.com/api/deals?upperPrice=10&sortBy=Price"

{
  "count": 30,
  "updated": "2026-09-22T03:00:00.000Z",
  "items": [
    { "title": "Hollow Knight", "store": "Steam", "storeID": "1",
      "price": "3.74", "was": "14.99", "off": 75,
      "thumb": "https://…", "url": "https://store.steampowered.com/app/367520/",
      "steamAppID": "367520", "gameID": "12345" }
  ]
}

GET /api/deals/{dealID}

One deal, looked up by its deal ID: game info, cheaper stores and the all-time cheapest price. Links go straight to the store page.

curl -H "X-API-Key: lr_your_key_here" \
  https://radar.codemeoww.com/api/deals/HhzMJAgQYGZ%2BFPpBG%2BRFcuUQZJO3KXvlnyYYGwGUfU%3D

GET /api/freebies

Free-to-keep PC games live right now. Up to 12 items.

{
  "count": 12,
  "updated": "2026-09-22T03:00:00.000Z",
  "items": [
    { "title": "Shogun Showdown", "worth": "$14.99",
      "thumb": "https://…", "url": "https://…", "desc": "…",
      "platforms": "PC", "ends": "2026-10-01" }
  ]
}

GET /api/games?title=…

Search games by title or Steam app ID — at least one of title / steamAppID is required. limit (max 60) and exact are optional. Pass ids (up to 25 comma-separated game IDs) instead to fetch several games at once.

curl -H "X-API-Key: lr_your_key_here" \
  "https://radar.codemeoww.com/api/games?title=portal"

{
  "count": 3,
  "items": [
    { "gameID": "10229", "title": "Portal", "cheapest": "0.99",
      "thumb": "https://…", "steamAppID": "400",
      "url": "https://store.steampowered.com/app/400/",
      "details": "https://radar.codemeoww.com/api/games/10229" }
  ]
}

GET /api/games/{id}

Full details for one game: current cheapest price, all-time cheapest, and every live deal with direct store links.

curl -H "X-API-Key: lr_your_key_here" \
  https://radar.codemeoww.com/api/games/10229

GET /api/stores

Directory of tracked stores: id, name and whether the store is active. Add ?lastChange=1 to get each store's last update time instead (handy for skipping a full refresh).

curl -H "X-API-Key: lr_your_key_here" \
  https://radar.codemeoww.com/api/stores

Rate limits

600 requests per hour per key. Exceeding it returns 429. Deal data refreshes every ~20 minutes, so polling faster than that just wastes your quota — cache the response.

Errors

400 — bad parameter (e.g. maxAge out of range, or no title/steamAppID/ids on /api/games). 401 — missing, invalid, revoked key, or the key's owner isn't Pro anymore. 404 — unknown deal ID. 429 — rate limit. 502 — upstream feed hiccup, retry shortly. Every 401 body links back here.

Keys

Create up to 5 keys and revoke old ones from the Pro dashboard. Lost your key? Revoke it and make a new one — old keys stop working immediately.