Stats

The numbers agencies and multi-location teams put in their reports, computed from the reviews Prisma already has: how many reviews arrived, the average rating, reviews per star, how many got a reply and how fast, and which negative reviews are still unanswered. One call per workspace, location or platform, for any period. Stats are plain counts and averages: no AI, no extra calls to the platforms, and included in every plan.

The stats object

JSON

{
  "since": "2025-10-28T00:00:00.000Z",
  "until": "2026-10-28T00:00:00.000Z",
  "location_id": "loc_01KJ8P9W2C4D6F8G0H2J4K6M8N",
  "platform": null,
  "reviews": 214,
  "average_rating": 4.37,
  "ratings": { "1": 9, "2": 7, "3": 15, "4": 48, "5": 135 },
  "replied": 181,
  "reply_rate": 0.846,
  "median_reply_hours": 6.5,
  "unreplied_negative": 3,
  "by_month": [
    { "month": "2026-09", "reviews": 21, "average_rating": 4.43, "replied": 19 },
    { "month": "2026-10", "reviews": 18, "average_rating": 4.5, "replied": 15 }
  ]
}

Field	Type	Description
`since`, `until`	timestamp	The period, by when reviews were written on the platform (`created_at`). `since` is included, `until` is not.
`location_id`, `platform`	string \| null	The filters you sent, or `null`.
`reviews`	integer	Reviews written in the period.
`average_rating`	number \| null	Average of the 1–5 ratings, 2 decimals. Reviews without a rating are counted in `reviews` but not here. `null` without rated reviews.
`ratings`	object	Reviews per star, `"1"` to `"5"`.
`replied`	integer	Reviews with a published reply, whether you sent it through Prisma or answered on the platform. Queued and failed replies don’t count.
`reply_rate`	number \| null	`replied / reviews`, from 0 to 1. `null` without reviews.
`median_reply_hours`	number \| null	Median time between a review and its reply, in hours, 1 decimal. `null` when there are no replies with a date.
`unreplied_negative`	integer	Reviews of 1 or 2 stars without a published reply: the ones to answer first.
`by_month`	array	One entry per calendar month (UTC) with reviews, oldest first: `month` (`YYYY-MM`), `reviews`, `average_rating`, `replied`.

Stats only cover the reviews Prisma stores, so they start when you connected the location, plus the history each platform returns on the first check (see Platforms), and follow your plan’s retention.

Get workspace stats

GET /v1/stats

Stats for every location of your workspace in the mode of your key. Test keys return stats of the sample reviews.

Parameter	Description
`location_id`	Only this location.
`platform`	Only this platform, e.g. `google` or `app_store`.
`since`	Start of the period: a date (`2026-01-01`, midnight UTC) or an ISO 8601 timestamp with offset. Default: 12 months before `until`.
`until`	End of the period, not included. Default: now.

api.prismareviews.com/v1

curl "https://api.prismareviews.com/v1/stats?platform=google&since=2026-01-01" \
  -H "Authorization: Bearer $PRISMA_API_KEY"

const res = await fetch("https://api.prismareviews.com/v1/stats?since=2026-01-01", {
  headers: { Authorization: "Bearer " + process.env.PRISMA_API_KEY },
});
const s = await res.json();
console.log(s.reviews, s.average_rating, s.reply_rate, s.unreplied_negative);

import os
import requests

s = requests.get(
    "https://api.prismareviews.com/v1/stats",
    params={"since": "2026-01-01"},
    headers={"Authorization": f"Bearer {os.environ['PRISMA_API_KEY']}"},
    timeout=30,
).json()
print(s["reviews"], s["average_rating"], s["reply_rate"], s["unreplied_negative"])

Returns 200 with the stats object. 422 invalid_request for an unknown platform, a since or until that can’t be read, or a since that isn’t earlier than until.

Get a location’s stats

GET /v1/locations/{id}/stats

The same object for one location, with since and until as above. 404 resource_not_found if there is no location with that ID in your workspace and mode.

cURL

curl "https://api.prismareviews.com/v1/locations/loc_01KJ8P9W2C4D6F8G0H2J4K6M8N/stats?since=2026-01-01" \
  -H "Authorization: Bearer $PRISMA_API_KEY"

To build a report for every client or store, list your locations and call this endpoint for each one, or call GET /v1/stats once per platform.

Monthly review reports, from one API call.

Get API key

2 locations free, then plans from €49 a month.