Build with the Prisma Reviews API

Choose your path

Everything the API covers

More: Integrations · Pricing · Security · Changelog · llms.txt · llms-full.txt

The endpoints you’ll use most are /connections, /locations, /reviews, /reviews/{id}/reply, /webhooks and /usage, plus the webhook events review.created, review.updated, reply.published, reply.failed and connection.updated.

Core concepts in 60 seconds

• API key. A secret for your workspace, sent as Authorization: Bearer <API_KEY>. Live keys (pk_live_…) work on your real accounts; test keys (pk_test_…) work on sample data, and the two never mix. Never ship a key in a browser or mobile app.
• Connection. The access a business gives Prisma on one platform: OAuth (Google, Trustpilot), the platform’s API credentials (App Store, Google Play, Judge.me, Yotpo, REVIEWS.io, G2) or a public listing URL (Yelp, Tripadvisor, Booking.com). Created with POST /v1/connections.
• Location. A Google Business Profile location, an app in one store, a Judge.me shop, a Trustpilot business unit or a listing on another platform. Plans are priced by connected locations; the Spark plan is free for 2.
• Review. One normalized object, whatever the platform: id, platform, location_id, rating, title, text, author, language, url, created_at, updated_at and reply.
• Reply. The public response from the business. Create or replace it with POST, remove it with DELETE. You write the text, or your software does; Prisma queues it and publishes it through the platform’s official API. Read-only platforms have no reply API, so each review’s url links to where you answer it on the platform.

Prisma only works with accounts you own or manage. It does not collect reviews of other businesses.

Supported platforms

Platform	Read reviews	Reply to reviews	Status
Google Business Profile	Yes	By API	At launch
App Store	Yes	By API	At launch
Google Play	Yes	By API	At launch
Judge.me	Yes	By API	At launch
Trustpilot	Yes	By API	Beta
Yelp, Tripadvisor, Booking.com	Yes	Read only (link to answer on the platform)	Beta
Yotpo, REVIEWS.io, G2	Yes	Read only (link to answer on the platform)	Beta

Each platform has its own limits; they are all on Platforms. The platform pages go deeper: Google Business Profile API, Trustpilot API, App Store reviews API and Google Play reviews API. The full list is on Integrations.

Docs for AI agents and LLMs

A plain-text index of Prisma and its docs lives at /llms.txt, following the llms.txt specification, so coding assistants and agents can find the right page without parsing HTML.

Need help?

Read the error.code and error.message in the response first, and look the code up on Errors: most problems are a connection that needs reauthorization or the per-key rate limit. If you are still stuck, email hello@prismareviews.com with the request_id from the error response.

FAQ

Is there an SDK?

Not yet. The API is plain REST and JSON, so any HTTP client works. The quickstart shows curl, Node (fetch) and Python (requests).

Do I need my own Google Business Profile API approval?

No. Prisma uses its own Google Cloud project for the Business Profile API. You only authorize Prisma on your profile with OAuth.

Can I read reviews of a business I don’t own?

No. Prisma reads and replies only on accounts that you, or your client, have authorized as owner or manager.

Is there a sandbox?

Yes. Every plan includes test keys (pk_test_…) that connect any platform without real credentials, return sample reviews and accept replies without publishing them, so you can build and test your integration before connecting a real location.