Get a product's TLDR review
Last updated · Changelog · OpenAPI spec · Markdown
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:
curl -X GET 'https://api.shopsavvy.com/v1/products/reviews?id=B09XS7JWHH' \
-H 'Authorization: Bearer YOUR_API_KEY'Example Response:
{
"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.