Developers

API reference

A read-only REST API to pull your reviews, ratings, and trends — for BI tools, data warehouses, or custom workflows. Available on the Studio plan. Create a key on the API keys page.

Authentication

Pass your key as a Bearer token. Keys are scoped to your workspace and only ever return your own data.

curl https://reviewcast.co/api/v1/apps \
  -H "Authorization: Bearer rc_live_xxxxxxxx..."

Base URL & limits

  • Base URL: https://reviewcast.co/api/v1
  • Rate limit: 60 requests/minute per key (429 with a retry hint when exceeded).
  • All responses are JSON. Dates are ISO-8601 (UTC).
GET/apps

Your tracked apps. Use each app’s id to filter the other endpoints.

{
  "apps": [
    { "id": "clx…", "name": "Pocket Peaks", "store": "googleplay",
      "externalAppId": "com.pocketpeaks.app", "appIcon": "https://…" }
  ]
}
GET/reviews

Your reviews, newest first, cursor-paginated. Query params (all optional): app (an app id), store, from/to (YYYY-MM-DD), rating (1–5), sentiment, topic, limit (≤100), cursor.

{
  "reviews": [
    {
      "id": "…", "store": "appstore", "externalAppId": "6569248884",
      "author": "Jane", "rating": 5, "title": "Love it", "text": "…",
      "translatedText": null, "translatedFrom": null,
      "version": "1.4.0", "country": "us", "date": "2026-06-26T10:12:00.000Z",
      "sentiment": { "label": "positive", "score": 0.9 }, "topics": ["ui"]
    }
  ],
  "nextCursor": "…"   // pass back as ?cursor= for the next page, or null
}
GET/ratings?app=<id>

Latest all-time rating summary for one app (from our daily snapshots).

{
  "app": { "id": "clx…", "store": "appstore", "externalAppId": "6569248884" },
  "rating": {
    "average": 4.31, "total": 12840,
    "histogram": { "1": 420, "2": 310, "3": 900, "4": 3100, "5": 8110 },
    "capturedOn": "2026-06-28"
  }
}
GET/trends?app=<id>

Weekly series for one app — volume by store, average rating, sentiment mix, and top topics. Optional from/to.

{
  "weekly": [ { "week": "2026-06-22", "label": "Jun 22",
    "appstore": 40, "googleplay": 12, "total": 52,
    "positive": 30, "neutral": 8, "negative": 10, "mixed": 4,
    "analyzed": 52, "avgScore": 4.2 } ],
  "totals": { "total": 52, "analyzed": 52 },
  "ratingDistribution": [ { "score": 5, "count": 30 } ],
  "topTopics": [ { "topic": "performance", "count": 14 } ]
}

Need write access, more resources, or a higher rate limit? Tell us — this is v1 and we’re expanding it.