# Prism Product Reviews API (https://www.socialcrawl.dev/platforms/prism/product-reviews)

> Resolves a product on Amazon (ASIN) + Google Shopping (gid) + Trustpilot and pulls each source's reviews, folded into a per-source rating summary (listed aggregate preferred over sample mean), a retailer matrix, and an LLM topic pass with per-topic rating impact (the model only assigns review ids — averages are recomputed in code). Anchor with `asin`/`gid` for precision (the gid is `product.ext.gid`, NOT the catalogid) or `query` to auto-resolve. Coverage spine = the resolved sources (<0.5 → 50% refund; none → full refund). Commerce legs take 20-60s.

TL;DR: `GET /v1/prism/product-reviews` costs 30 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | no | Product name to auto-resolve across marketplaces. |
| `asin` | no | Amazon ASIN to anchor the Amazon axis directly. |
| `gid` | no | Google product id (gid) to anchor the Google Shopping axis (NOT the catalogid). |
| `sources` | no | CSV subset of amazon,google_shopping,trustpilot (default all). |
| `country` | no | Marketplace country (DFS location). |
| `depth` | no | Reviews per source (Trustpilot clamped ≤20). |
| `competitors` | no | Optional competitor products for a comparison (validated; deeper sweep is a fast-follow). |
| `include` | no | Optional leg toggles. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/prism/product-reviews" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What is the SocialCrawl product reviews API?

GET /v1/prism/product-reviews returns one cross-marketplace view of a product's reviews by fanning out to Amazon, Google Shopping, and Trustpilot in a single call. It folds every source into a blended rating with themed pros and cons, so you stop querying three marketplaces and merging three shapes yourself.

### How do I identify the product?

Supply exactly one anchor: query for a name search, asin for an exact Amazon match, or gid for a Google Shopping id. The composite resolves the product on each marketplace from that anchor, and country and depth control the storefront and how many reviews are pulled per source.

### What does the cross-marketplace rating include?

You get a blended rating with per-marketplace breakdowns, themed pros and cons clustered from the pooled review text, and an optional competitors comparison. Ratings and counts are recomputed in code from the assigned reviews rather than trusted from the model, so the numbers stay auditable.

### How much does a product-reviews call cost?

Each call is a flat 30 credits and returns one synchronous JSON response. Commerce data is slow, so a call can take a while. If a strict majority of the marketplace legs fail the call is partial-refunded, and if every leg fails the full 30 credits come back automatically. New accounts get 100 free credits.

### Can I compare against competitor products?

Yes. Pass competitors and the endpoint pulls the same cross-marketplace review view for each rival so you can read them side by side. Use sources to restrict which marketplaces are queried and include to control which supporting sections come back in the payload.

See the full Prism API: https://www.socialcrawl.dev/platforms/prism

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How do I compare a product's reviews across Amazon, Google Shopping, and Trustpilot in one API call?
- Which API returns a cross-marketplace product rating with themed pros and cons?
- Is there a product reviews API that blends multiple marketplaces and competitor products?