# Get a product's TLDR review

> GET /v1/products/reviews returns an expert review summary for a product: pros, cons, bottom line and 0-1 quality scores. No credit when no review exists.

*Source: https://shopsavvy.com/data/documentation/reviews* · Part of the [ShopSavvy Data API documentation](https://shopsavvy.com/data/documentation.md)

---

Retrieve a concise expert review summary for a product, including pros, cons, a bottom line verdict, and quantitative scores. These are curated TLDR reviews — not raw customer reviews.

**Endpoint:** `GET /v1/products/reviews`

**Credit Cost:** 1 credit when a review exists for the product, 0 when it does not (`review` is `null`).

**Parameters:**

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Product identifier (barcode, ASIN, URL, model number) |
| `format` | string | No | Response format: `json` or `csv` |

**Example Request:**

```bash
curl -X GET 'https://api.shopsavvy.com/v1/products/reviews?id=B09XS7JWHH' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

**Example Response:**

```json
{
  "success": true,
  "product": { "path": "products/sony-wh1000xm5", "title": "Sony WH-1000XM5" },
  "review": {
    "slug": "sony-wh-1000xm5-review",
    "headline": "Best-in-class noise cancellation with premium sound",
    "pros": ["Industry-leading ANC", "30-hour battery life", "Comfortable all-day wear"],
    "cons": ["No IP rating", "No aptX support", "Premium pricing"],
    "bottom_line": "The best noise-cancelling headphones for most people.",
    "scores": {
      "overall": 0.87,
      "customer": 0.85,
      "professional": 0.89,
      "aspects": { "value": 0.78, "features": 0.91, "reliability": 0.83 }
    }
  },
  "meta": { "request_id": "abc-123", "credits_used": 1, "credits_remaining": 998 }
}
```

**Note:** Returns `"review": null` if no TLDR review exists for the product (no credit is charged).

**Scores** are on a **0-1 scale** (multiply by 10 or 100 for display). `aspects` is keyed by free-form aspect names drawn from the product's professional reviews — the set of aspects varies per product, and `scores` (or `aspects`) is omitted when no scored reviews exist.