Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
All 92 tools →
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/prismareviews:prismareviews-stats-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Prisma Reviews Stats API
version: 1.0.0
summary: One REST API to read and reply to reviews on the App Store, Google Play, Yelp, Tripadvisor and more.
description: 'Read the reviews of the businesses and apps you own or manage on the App Store, Google Play, Judge.me, eBay, Trusted Shops, eKomi, Yelp, Tripadvisor, Booking.com, G2 and 50+ more platforms, all in one normalized JSON shape, and reply through each platform''s official API where it has one (read-only platforms return the link where a review is answered). Google Business Profile, Trustpilot, Allegro, Etsy, Angi and Mercado Libre are coming soon: `GET /v1/platforms` says which platforms are ready (`live_ready`).
- **Auth:** `Authorization: Bearer `. Live keys (`pk_live_…`) work with real accounts; test keys (`pk_test_…`) connect any platform with sample locations and reviews and never publish replies. Test and live data never mix.
- **Format:** JSON in and out; timestamps are ISO 8601 in UTC; IDs are prefixed (`rev_`, `loc_`, `con_`, `we_`, `evt_`, `req_`).
- **Pagination:** `GET /v1/reviews` is cursor paginated (`data` + `next_cursor`).
- **Rate limits:** per key and per minute, set by the plan (Spark 60, Beam 120, Spectrum 600, Aurora 1,200), reported in `X-RateLimit-Limit` and `X-RateLimit-Remaining`.
- **Errors:** one shape, `{ "error": { "type", "code", "message", "retryable", "request_id", "docs_url" } }`; codes on https://prismareviews.com/docs/errors.
- **Webhooks:** signed `POST`s for new and updated reviews, published or failed replies and connection changes.
Get a free API key at https://app.prismareviews.com/signup.'
termsOfService: https://prismareviews.com/terms
contact:
name: Prisma Reviews
url: https://prismareviews.com
email: hello@prismareviews.com
x-logo:
url: https://prismareviews.com/favicon.svg
altText: Prisma Reviews
servers:
- url: https://api.prismareviews.com
description: Production (live and test keys)
security:
- apiKey: []
tags:
- name: Stats
description: Review statistics per workspace, location or platform.
externalDocs:
description: Docs
url: https://prismareviews.com/docs/api-reference/stats
paths:
/v1/stats:
get:
operationId: getStats
tags:
- Stats
summary: Get review stats
description: 'Review statistics for your workspace in the mode of your key: count, average rating, reviews per star, replies, reply rate, median reply time, unanswered negative reviews and a month-by-month series. Filter by location or platform.'
parameters:
- name: location_id
in: query
description: Only this location.
schema:
type: string
example: loc_01KJ8P9W2C4D6F8G0H2J4K6M8N
- name: platform
in: query
description: Only this platform.
schema:
$ref: '#/components/schemas/PlatformId'
- name: since
in: query
description: 'Start of the period, by when reviews were written: a date (midnight UTC) or an ISO 8601 timestamp with offset. Default: 12 months before `until`.'
schema:
type: string
anyOf:
- format: date
- format: date-time
example: '2026-01-01'
- name: until
in: query
description: 'End of the period (not included). Default: now.'
schema:
type: string
anyOf:
- format: date
- format: date-time
responses:
'200':
description: The stats.
headers:
Request-Id:
$ref: '#/components/headers/Request-Id'
X-RateLimit-Limit:
$ref: '#/components/headers/X-RateLimit-Limit'
X-RateLimit-Remaining:
$ref: '#/components/headers/X-RateLimit-Remaining'
content:
application/json:
schema:
$ref: '#/components/schemas/Stats'
example:
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
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'422':
description: An unknown `platform`, a `since` or `until` that is neither a date nor a timestamp with offset, or `since` not earlier than `until` (`invalid_request`).
headers:
Request-Id:
$ref: '#/components/headers/Request-Id'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
invalid_request:
value:
error:
type: invalid_request_error
code: invalid_request
message: 'limit: Number must be less than or equal to 100'
retryable: false
request_id: req_01KJ8T3C5D7E9F1G3H5J7K9M1N
docs_url: https://prismareviews.com/docs/errors#invalid_request
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
'503':
$ref: '#/components/responses/Maintenance'
externalDocs:
description: Docs
url: https://prismareviews.com/docs/api-reference/stats
/v1/locations/{id}/stats:
get:
operationId: getLocationStats
tags:
- Stats
summary: Get a location's review stats
description: The same statistics as `GET /v1/stats`, for one location.
parameters:
- name: id
in: path
required: true
description: Location ID (`loc_…`).
schema:
type: string
example: loc_01KJ8P9W2C4D6F8G0H2J4K6M8N
- name: since
in: query
description: 'Start of the period, by when reviews were written: a date (midnight UTC) or an ISO 8601 timestamp with offset. Default: 12 months before `until`.'
schema:
type: string
anyOf:
- format: date
- format: date-time
example: '2026-01-01'
- name: until
in: query
description: 'End of the period (not included). Default: now.'
schema:
type: string
anyOf:
- format: date
- format: date-time
responses:
'200':
description: The stats.
headers:
Request-Id:
$ref: '#/components/headers/Request-Id'
X-RateLimit-Limit:
$ref: '#/components/headers/X-RateLimit-Limit'
X-RateLimit-Remaining:
$ref: '#/components/headers/X-RateLimit-Remaining'
content:
application/json:
schema:
$ref: '#/components/schemas/Stats'
example:
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
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'404':
description: No location with that ID in this workspace and mode (`resource_not_found`).
headers:
Request-Id:
$ref: '#/components/headers/Request-Id'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
resource_not_found:
value:
error:
type: not_found_error
code: resource_not_found
message: No location with that id in this workspace.
retryable: false
request_id: req_01KJ8T3C5D7E9F1G3H5J7K9M1N
docs_url: https://prismareviews.com/docs/errors#resource_not_found
'422':
description: A `since` or `until` that can't be read, or `since` not earlier than `until` (`invalid_request`).
headers:
Request-Id:
$ref: '#/components/headers/Request-Id'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
invalid_request:
value:
error:
type: invalid_request_error
code: invalid_request
message: 'limit: Number must be less than or equal to 100'
retryable: false
request_id: req_01KJ8T3C5D7E9F1G3H5J7K9M1N
docs_url: https://prismareviews.com/docs/errors#invalid_request
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
'503':
$ref: '#/components/responses/Maintenance'
externalDocs:
description: Docs
url: https://prismareviews.com/docs/api-reference/stats
components:
schemas:
Stats:
type: object
required:
- since
- until
- location_id
- platform
- reviews
- average_rating
- ratings
- replied
- reply_rate
- median_reply_hours
- unreplied_negative
- by_month
description: Review statistics for a period, by when reviews were written. A reply counts once it is published.
properties:
since:
type: string
description: Start of the period (included).
format: date-time
until:
type: string
description: End of the period (not included).
format: date-time
location_id:
type:
- string
- 'null'
description: The location filter, if any.
platform:
type:
- string
- 'null'
description: The platform filter, if any.
reviews:
type: integer
description: Reviews written in the period.
average_rating:
type:
- number
- 'null'
description: Average of the 1–5 ratings, 2 decimals. `null` without rated reviews.
ratings:
type: object
description: Reviews per star, `1` to `5`.
additionalProperties:
type: integer
replied:
type: integer
description: Reviews with a published reply.
reply_rate:
type:
- number
- 'null'
description: '`replied / reviews`, 0 to 1. `null` without reviews.'
median_reply_hours:
type:
- number
- 'null'
description: Median time from review to reply, in hours, 1 decimal.
unreplied_negative:
type: integer
description: Reviews of 1 or 2 stars without a published reply.
by_month:
type: array
description: One entry per calendar month (UTC) with reviews, oldest first.
items:
type: object
required:
- month
- reviews
- average_rating
- replied
properties:
month:
type: string
description: '`YYYY-MM`.'
reviews:
type: integer
average_rating:
type:
- number
- 'null'
replied:
type: integer
Error:
type: object
required:
- error
description: Every error has this shape. Some codes add fields (for example `platform`, `url`, `max_length`, `connection_id`, `upgrade_url`, `required_fields`).
properties:
error:
type: object
required:
- type
- code
- message
- retryable
- request_id
- docs_url
additionalProperties: true
properties:
type:
type: string
enum:
- authentication_error
- permission_error
- not_found_error
- conflict_error
- invalid_request_error
- rate_limit_error
- api_error
description: Family of the error, from the HTTP status.
code:
type: string
description: Stable, machine-readable code. Branch on this, not on `message`.
message:
type: string
description: Human-readable explanation. It can change.
retryable:
type: boolean
description: '`true` for 429 and 5xx: the same request can succeed later.'
request_id:
type: string
description: The `req_…` ID, also in the `Request-Id` header.
docs_url:
type: string
description: Description of this code.
format: uri
PlatformId:
type: string
enum:
- google
- app_store
- google_play
- judge_me
- trustpilot
- google_maps
- yelp
- tripadvisor
- booking
- yotpo
- reviews_io
- g2
- ebay
- etsy
- steam
- okendo
- feefo
- trusted_shops
- ekomi
- loox
- proven_expert
- shopper_approved
- wordpress
- appexchange
- facebook
- opentable
- doordash
- angi
- checkatrade
- avvo
- capterra
- apartments
- gartner
- healthgrades
- vitals
- classpass
description: 'Platform ID.
| ID | Platform | Connects with | Replies |
| --- | --- | --- | --- |
| `google` | Google Business Profile | oauth | by API |
| `app_store` | App Store | credentials | by API |
| `google_play` | Google Play | credentials | by API |
| `judge_me` | Judge.me | credentials | by API |
| `trustpilot` | Trustpilot | oauth | by API |
| `google_maps` | Google Maps | listing_url | read only |
| `yelp` | Yelp | listing_url | read only |
| `tripadvisor` | Tripadvisor | listing_url | read only |
| `booking` | Booking.com | listing_url | read only |
| `yotpo` | Yotpo | credentials | read only |
| `reviews_io` | REVIEWS.io | credentials | read only |
| `g2` | G2 | credentials | read only |
| `ebay` | eBay | oauth | by API |
| `etsy` | Etsy | listing_url | read only |
| `steam` | Steam | listing_url | read only |
| `okendo` | Okendo | credentials | read only |
| `feefo` | Feefo | credentials | read only |
| `trusted_shops` | Trusted Shops | credentials | by API |
| `ekomi` | eKomi | credentials | by API |
| `loox` | Loox | credentials | read only |
| `proven_expert` | ProvenExpert | credentials | read only |
| `shopper_approved` | Shopper Approved | credentials | read only |
| `wordpress` | WordPress.org | listing_url | read only |
| `appexchange` | Salesforce AppExchange | listing_url | read only |
| `facebook` | Facebook | listing_url | read only |
| `opentable` | OpenTable | listing_url | read only |
| `doordash` | DoorDash | listing_url | read only |
| `angi` | Angi | listing_url | read only |
| `checkatrade` | Checkatrade | listing_url | read only |
| `avvo` | Avvo | listing_url | read only |
| `capterra` | Capterra | listing_url | read only |
| `apartments` | Apartments.com | listing_url | read only |
| `gartner` | Gartner Peer Insights | listing_url | read only |
| `healthgrades` | Healthgrades | listing_url | read only |
| `vitals` | Vitals | listing_url | read only |
| `classpass` | ClassPass | listing_url | read only |'
responses:
InternalError:
description: Something failed on Prisma's side. Retryable.
headers:
Request-Id:
$ref: '#/components/headers/Request-Id'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
internal_error:
value:
error:
type: api_error
code: internal_error
message: Something went wrong on our side. It has been logged; try again.
retryable: true
request_id: req_01KJ8T3C5D7E9F1G3H5J7K9M1N
docs_url: https://prismareviews.com/docs/errors#internal_error
RateLimited:
description: More requests this minute than the plan allows for this key. Not counted in usage.
headers:
Request-Id:
$ref: '#/components/headers/Request-Id'
Retry-After:
$ref: '#/components/headers/Retry-After'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
rate_limited:
value:
error:
type: rate_limit_error
code: rate_limited
message: Rate limit of 60 requests per minute exceeded. Retry in 12 s. Requests over the limit are never billed.
retryable: true
request_id: req_01KJ8T3C5D7E9F1G3H5J7K9M1N
docs_url: https://prismareviews.com/docs/errors#rate_limited
Unauthorized:
description: No API key or one not shaped like a Prisma key (`missing_api_key`), or a key that doesn't exist or was revoked (`invalid_api_key`).
headers:
Request-Id:
$ref: '#/components/headers/Request-Id'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
missing_api_key:
value:
error:
type: authentication_error
code: missing_api_key
message: 'Send your API key as "Authorization: Bearer pk_live_…".'
retryable: false
request_id: req_01KJ8T3C5D7E9F1G3H5J7K9M1N
docs_url: https://prismareviews.com/docs/errors#missing_api_key
invalid_api_key:
value:
error:
type: authentication_error
code: invalid_api_key
message: This API key does not exist or was revoked.
retryable: false
request_id: req_01KJ8T3C5D7E9F1G3H5J7K9M1N
docs_url: https://prismareviews.com/docs/errors#invalid_api_key
Forbidden:
description: The account is suspended.
headers:
Request-Id:
$ref: '#/components/headers/Request-Id'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
account_suspended:
value:
error:
type: permission_error
code: account_suspended
message: This account is suspended. Write to hello@prismareviews.com.
retryable: false
request_id: req_01KJ8T3C5D7E9F1G3H5J7K9M1N
docs_url: https://prismareviews.com/docs/errors#account_suspended
Maintenance:
description: Prisma is under maintenance and the API is paused. Retryable.
headers:
Request-Id:
$ref: '#/components/headers/Request-Id'
Retry-After:
$ref: '#/components/headers/Retry-After'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
maintenance:
value:
error:
type: api_error
code: maintenance
message: Prisma is under maintenance. Try again in a few minutes; see https://prismareviews.com/status.
retryable: true
request_id: req_01KJ8T3C5D7E9F1G3H5J7K9M1N
docs_url: https://prismareviews.com/docs/errors#maintenance
headers:
X-RateLimit-Remaining:
description: Requests left in the current one-minute window.
schema:
type: integer
Request-Id:
description: The `req_…` ID of the request. Include it when you contact support.
schema:
type: string
X-RateLimit-Limit:
description: Requests allowed per minute for this key.
schema:
type: integer
Retry-After:
description: Seconds to wait before retrying.
schema:
type: integer
securitySchemes:
apiKey:
type: http
scheme: bearer
bearerFormat: pk_live_… / pk_test_…
description: 'Your secret API key as a Bearer token: `pk_live_…` for real accounts, `pk_test_…` for sample data. Keep it on your server.'
externalDocs:
description: Prisma Reviews API reference
url: https://prismareviews.com/docs/api-reference