# Prism Review Integrity API (https://www.socialcrawl.dev/platforms/prism/review-integrity)

> Computes a documented, reproducible integrity grade for a product or brand by comparing ratings across Amazon, Google Shopping, Trustpilot, and the open web: cross-source rating divergence (Welch t-test), web-distribution bimodality (Sarle's coefficient), unsolicited-forum tone contrast, and spam-domain clustering. No AI/LLM — every number is a published formula (`methodology_version`). Returns the grade, per-signal evidence, per-source ratings, the divergence pair, and the raw sampled reviews. Reviewer-history tests are flagged `unavailable` (no upstream reviewer-profile source). Anchor on `asin`/`gid` for precision or `query` to auto-resolve. Commerce data takes 20-60s.

TL;DR: `GET /v1/prism/review-integrity` 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 or brand name to evaluate. |
| `asin` | no | Amazon ASIN to anchor the Amazon axis directly (skips product-search). |
| `gid` | no | Google product id (gid) to anchor the Google Shopping axis (NOT the catalogid product.id). |
| `sources` | no | CSV subset of amazon,google_shopping,trustpilot,web,forums (default all). |
| `country` | no | Marketplace country (DFS location). Defaults to United States. |

## Code example

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

## FAQ

### What is the SocialCrawl Review Integrity API?

GET /v1/prism/review-integrity returns a deterministic, reproducible integrity grade for a product or brand by comparing ratings across Amazon, Google Shopping, Trustpilot, and the open web. It uses a Welch t-test for cross-source divergence, Sarle's coefficient for distribution bimodality, forum-tone contrast, and spam-domain clustering — no AI or LLM.

### How does the fake-review grade work?

Each signal returns pass, warn, fail, or unavailable, and the A-F grade starts at A and drops two steps per fail and one per warn, excluding any test that could not run. Every number is a published formula tagged with a methodology_version, so the verdict is fully auditable.

### Which sources does review-integrity compare?

Amazon and Google Shopping supply product-search anchor ratings, Trustpilot supplies the company axis, and the open web supplies a rating-distribution histogram plus unsolicited forum mentions. Anchor on an asin or gid for precision, or pass query to auto-resolve across all sources.

### How much does a review-integrity call cost?

Each call is a flat 30 credits. Commerce data is slow, so a call can take 20-60 seconds. If fewer than half the requested rating sources resolve, half the cost is refunded; if no source resolves at all, the full 30 credits come back. New accounts get 100 free credits with no card.

### Why is the reviewer-history signal unavailable?

Reviewer-history and reviewer-overlap tests need a reviewer-profile feed that no upstream source exposes, so that signal is honestly returned as unavailable rather than guessed. The shipped method covers cross-source divergence, bimodality, forum tone, and spam clustering — the tests that the data supports.

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:

- What API detects fake or astroturfed product reviews?
- How do I check review integrity across Amazon and Trustpilot via API?
- Fakespot alternative API with a statistical fake-review grade