<!-- Prisma API Docs: Read and Reply to Reviews in One API · https://prismareviews.com/docs -->
> Prisma API docs: quickstart, core concepts and supported platforms for reading and replying to Google, App Store, Google Play, Trustpilot, Yelp and Tripadvisor reviews.

## Choose your path

<div class="path-grid">
  <a class="path-card" href="/docs/quickstart"><span class="path-title">Quickstart <span class="mm-tag">5 min</span></span><span class="path-text">Get a key, connect a location, list reviews and send your first reply in curl, Node and Python.</span></a>
  <a class="path-card" href="/docs/api-reference/authentication"><span class="path-title">Test keys <span class="mm-tag">No setup</span></span><span class="path-text">pk_test_ keys return sample reviews on every platform, so you can build before connecting a real one.</span></a>
  <a class="path-card" href="/docs/api-reference/connections"><span class="path-title">Connect a platform</span><span class="path-text">OAuth for Google and Trustpilot, API credentials for the app stores and shops, a public URL for Yelp, Tripadvisor and Booking.com.</span></a>
  <a class="path-card" href="/docs/api-reference/webhooks"><span class="path-title">Webhooks</span><span class="path-text">Signed review.created, review.updated and reply.published events, so you never poll.</span></a>
</div>

## Everything the API covers

<div class="path-grid">
  <a class="path-card" href="/docs/api-reference/reviews"><span class="path-title">Reviews <span class="mm-tag">GET</span></span><span class="path-text">Every review in one shape: rating, title, text, author, language, reply and url.</span></a>
  <a class="path-card" href="/docs/api-reference/replies"><span class="path-title">Replies <span class="mm-tag">POST · DELETE</span></span><span class="path-text">Publish your reply through the platform's official API on Google, App Store, Google Play, Judge.me and Trustpilot.</span></a>
  <a class="path-card" href="/docs/api-reference/locations"><span class="path-title">Locations <span class="mm-tag">GET</span></span><span class="path-text">The businesses, apps and listings you connected, with their sync status.</span></a>
  <a class="path-card" href="/docs/api-reference/usage"><span class="path-title">Usage <span class="mm-tag">GET</span></span><span class="path-text">Your plan, connected locations, requests and replies this month.</span></a>
  <a class="path-card" href="/docs/api-reference/platforms"><span class="path-title">Platforms <span class="mm-tag">11</span></span><span class="path-text">How each platform connects, what it allows and how often Prisma checks it.</span></a>
  <a class="path-card" href="/docs/errors"><span class="path-title">Errors</span><span class="path-text">Every error code with its meaning and what to do, plus retry advice.</span></a>
</div>

More: [Integrations](/integrations) · [Pricing](/pricing) · [Security](/security) · [Changelog](/changelog) · [llms.txt](/llms.txt) · [llms-full.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](/docs/api-reference/platforms). The platform pages go deeper: [Google Business Profile API](/google-business-profile-api), [Trustpilot API](/trustpilot-api), [App Store reviews API](/app-store-reviews-api) and [Google Play reviews API](/google-play-reviews-api). The full list is on [Integrations](/integrations).

## Docs for AI agents and LLMs

A plain-text index of Prisma and its docs lives at [/llms.txt](/llms.txt), following the [llms.txt specification](https://llmstxt.org/), 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](/docs/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.
