Publisher plan

Wishcast API

A read-only JSON API for your workspace: your games' audits, their daily history, and your competitor watch list. Create a key under API in your dashboard.

Authentication

Send your key in the Authorization header. Keys start with wc_live_. Anyone with the key can read your workspace, so keep it out of public code and revoke it if it leaks.

curl https://getwishcast.com/api/v1/games \
  -H "Authorization: Bearer wc_live_..."

Limits

300 requests per hour per key. Over the limit you'll get 429. Daily data updates once a day, so polling more than hourly won't show anything new.

Endpoints

`GET /api/v1/games`

Every game in the workspace with its latest daily figures.

{
  "games": [{
    "appid": 4242420, "name": "Moss & Marrow", "header": "https://…",
    "stats": {
      "date": "2026-11-02", "score": 74, "scoreDelta": 6,
      "reviews": 1240, "reviewsDelta": 38, "positive": 92,
      "price": "$14.99", "discount": 0, "comingSoon": false, "releaseDate": "Oct 15, 2026",
      "tags": 18, "trend": [68, 70, 74], "since": "2026-10-26"
    }
  }]
}

scoreDelta and reviewsDelta compare with seven days earlier. trend is the last 30 daily scores. stats is null until a game's first daily check.

`GET /api/v1/games/{appid}`

A fresh audit of one of your games (or a watched game), read live from Steam: score, sections, every check with its status, detail and fix, and the normalized store data in app.

`GET /api/v1/games/{appid}/history`

Up to 365 daily snapshots, oldest first: score, reviews, positive %, price, discount, tags, screenshot and trailer counts, release date.

`GET /api/v1/watch`

Your competitor watch list with the same stats object as /games.

Errors

Errors return JSON like {"error": "…"} with status 401 (missing or bad key), 402 (the workspace isn't on Publisher), 404 (not in this workspace) or 429 (rate limit).

Example: Google Sheets

In Apps Script, UrlFetchApp.fetch(url, {headers: {Authorization: "Bearer " + KEY}}) and parse the JSON. Store the key in Script Properties, not in the sheet.

Questions or a missing endpoint? support@getwishcast.com