# Amazon Reviews Summary - AI Insights & Star Breakdown (`tenfoldfleet/amazon-reviews-summary`) Actor

Get the review summary of an Amazon product by ASIN or URL: Amazon's AI overview of what buyers say, praised and criticized aspects with mention counts, star percentages, rating and ratings count. Bulk, no browser, 20+ marketplaces. $10 per 1,000 products; failed lookups are free.

- **URL**: https://apify.com/tenfoldfleet/amazon-reviews-summary.md
- **Developed by:** [Tenfold Fleet](https://apify.com/tenfoldfleet) (community)
- **Categories:** E-commerce, Agents, MCP servers
- **Features:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 product review insights

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

*Not affiliated with Amazon. This Actor reads public Amazon product pages only: no login, no cookies, no account.*

### What does Amazon Reviews Summary do?

**Amazon Reviews Summary** turns one ASIN into one compact row of **review insights**: the short AI-written overview Amazon shows above its reviews, the **aspects** buyers bring up (for example "sound quality", "battery life", "durability") with how many reviews mention each one and how many of those are positive or negative, and the **star breakdown** (percent of 5, 4, 3, 2 and 1 star ratings) with the average rating and ratings count.

It gives you **insights, not every review**. If you want every review's text, use a review scraper; if you want what thousands of reviews add up to, in one row per product for about a cent, use this. It works like a small **Amazon review summary API**: send ASINs or product URLs from amazon.com and 20 other Amazon marketplaces and get JSON back.

### Why use it?

- **Product research**: see in one line why shoppers love or return a product before you source or stock it.
- **Competitor tracking**: run your rivals' ASINs every week and watch their complaint aspects grow or shrink.
- **Listing optimization**: find the strengths buyers mention most and put them in your title and bullets; fix what they criticize.
- **AI agents and RAG**: give an assistant a short, structured verdict on a product instead of 500 raw reviews.
- **Catalog enrichment**: add a "what customers say" blurb and star chart to your own product database.

### What data can it extract?

![Sample output of Amazon Reviews Summary, rows from a real run: ASIN, Product, Rating, Ratings, AI summary, Praised](https://api.apify.com/v2/key-value-stores/4TBgG7fopkYMNWnX2/records/amazon-reviews-summary-output.png)

| Field | Example |
|---|---|
| `asin`, `title`, `marketplace`, `url` | B00FLYWNYQ, Instant Pot Duo 6 Qt..., amazon.com |
| `rating`, `ratingsCount` | 4.7, 186658 |
| `starBreakdown` | `{ "fiveStar": 84, "fourStar": 9, "threeStar": 3, "twoStar": 1, "oneStar": 3 }` (percent) |
| `hasAiSummary`, `aiSummary` | true, "Customers find this pressure cooker to be a reliable..." |
| `positiveAspects`, `negativeAspects`, `mixedAspects` | \["performance", "ease of use"], \[], \[] |
| `aspects[]` | name, sentiment, mentions, positiveMentions, negativeMentions, positivePercent, summary |
| `aspects[].snippets[]` | review quote, reviewId, reviewUrl (optional) |
| `reviewsUrl` | link to the full review list |

Text comes in the marketplace's language (German on amazon.de, Japanese on amazon.co.jp, and so on).

### How to get an Amazon review summary

1. Open the Actor and paste ASINs (B00FLYWNYQ) or product URLs (https://www.amazon.de/dp/B07GG1ZGX2) into **ASINs or product URLs**.
2. Pick the **Marketplace** used for bare ASINs. URLs always use their own marketplace.
3. Leave **Include review quotes per aspect** on if you want example quotes.
4. Click **Start**. In our cloud benchmark the Actor read about 27 products a minute (137 products in 5 minutes), so 1,000 products take roughly 40 minutes or less. Runs time out after 4 hours by default; raise the timeout in the run options for very large lists.
5. Download the results as JSON, CSV or Excel, or read them through the Apify API.

### How much does it cost?

Pay per product, nothing per month:

- **$10 per 1,000 products** with an AI summary or aspect list (`asin-insights` event, $0.01 each).
- **$2 per 1,000 products** that have ratings but no AI summary on Amazon (`rating-breakdown`, $0.002 each). Turn on **Skip products without an AI summary** to get those as free rows instead.
- **Free**: blocked requests, products not found, products with no ratings, pages Amazon returned without their reviews section, and invalid ASINs. Duplicates are skipped.
- A tiny run start fee of $0.00005.

On the Apify free plan, the $5 monthly credit covers about **500 products**. Set a **Maximum cost per run** in the run options and the Actor stops cleanly when it is reached.

### Input

```json
{
    "asins": ["B00FLYWNYQ", "B0CRTR3PMF", "https://www.amazon.de/dp/B07GG1ZGX2"],
    "marketplace": "com",
    "includeSnippets": true,
    "skipWithoutAiSummary": false
}
```

### Output

```json
{
    "asin": "B07GG1ZGX2",
    "marketplace": "amazon.de",
    "title": "Krups Pro Aroma KM303810 Filterkaffeemaschine ...",
    "rating": 3.9,
    "ratingsCount": 880,
    "starBreakdown": { "fiveStar": 55, "fourStar": 15, "threeStar": 10, "twoStar": 5, "oneStar": 15 },
    "hasAiSummary": true,
    "aiSummary": "Die Kunden sind mit der Qualität und dem Geschmack der Kaffeemaschine zufrieden. ...",
    "positiveAspects": ["Qualität", "Kaffeequalität", "Geschmack"],
    "negativeAspects": ["Dichtigkeit", "Haltbarkeit"],
    "mixedAspects": ["Temperaturhaltung", "Funktionalität", "Preis-Leistung"],
    "aspects": [
        {
            "name": "Qualität",
            "sentiment": "positive",
            "mentions": 107,
            "positiveMentions": 79,
            "negativeMentions": 28,
            "positivePercent": 74,
            "summary": "Kunden sind mit der Qualität der Kaffeemaschine zufrieden. ...",
            "snippets": [{ "text": "...ist diese Maschine perfekt!", "reviewId": "R1XKJL15KS5F6E", "reviewUrl": "https://www.amazon.de/portal/customer-reviews/srp/-/R1XKJL15KS5F6E" }]
        }
    ],
    "reviewsUrl": "https://www.amazon.de/product-reviews/B07GG1ZGX2",
    "error": null
}
```

Every unique input gives one row (duplicates are skipped). Failed rows have an `error` message and are never charged. You can download the dataset as JSON, CSV, Excel, XML or HTML.

### Tips

- Mix marketplaces in one run by pasting full product URLs.
- Amazon does not show an AI summary for every product: new products with few reviews and some marketplaces often have none (in our cloud tests amazon.nl, amazon.com.br, amazon.pl and amazon.se showed none). Those rows have `aiSummary: null` and empty aspect lists but still carry the star breakdown.
- Need prices, sellers, Best Sellers Rank and images too? Run the same ASINs through our [Amazon Product Scraper](https://apify.com/tenfoldfleet/amazon-product-scraper).
- Schedule a weekly run on your competitors' ASINs and compare `negativeAspects` over time.

### FAQ

#### Does it return every review?

No. It returns the summary Amazon builds from all reviews, the aspect counts, a few short quotes per aspect and the star breakdown. That is why it costs far less than downloading thousands of reviews.

#### Why is aiSummary null for some products?

Amazon only shows its AI summary when a product has enough reviews, and not in every marketplace. The row then keeps the rating, count and star breakdown and is charged at the lower rating-breakdown price, or is free if you turn on **Skip products without an AI summary**.

#### Which marketplaces work?

amazon.com, .ca, .com.mx, .co.uk, .de, .fr, .it, .es, .nl, .co.jp, .in, .com.au, .com.br, .ae, .se, .pl, .com.tr, .sg, .com.be, .sa and .eg. 17 of them returned data in our cloud tests (.com.tr, .com.be, .sa and .eg were not tested yet). Amazon sometimes blocks requests from data centers more in some marketplaces; blocked products are retried on new IPs and, if still blocked, returned as free error rows.

#### Do I need an Amazon account or API key?

No. The Actor reads the public product page, like a shopper who is not signed in.

#### Can I use it from an AI agent?

Yes. The Actor is available through the Apify API and the Apify MCP server, and one product is one small JSON row.

### Disclaimer

This Actor extracts publicly available data from Amazon product pages. The AI summaries are written by Amazon from customer reviews; we pass them on as shown. Amazon is a trademark of Amazon.com, Inc. or its affiliates; this Actor is not affiliated with, endorsed by or sponsored by Amazon. Make sure your use of the data complies with Amazon's terms and the laws that apply to you.

### More tools from Tenfold Fleet

| Actor | Output |
|---|---|
| [Amazon Bestsellers Tracker: New Releases & Rank Changes](https://apify.com/tenfoldfleet/amazon-bestsellers-tracker) | ranked product |
| [Amazon Product Scraper - Details, Prices & Search by ASIN](https://apify.com/tenfoldfleet/amazon-product-scraper) | product |
| [Amazon Search Volume - Keyword Demand for Sellers & PPC](https://apify.com/tenfoldfleet/amazon-search-volume) | keyword with amazon volume |
| [AliExpress Reviews Scraper: Product Feedback & Photos Monitor](https://apify.com/tenfoldfleet/aliexpress-reviews-scraper) | review |
| [Trustpilot Reviews Scraper - New Reviews Monitor & TrustScore](https://apify.com/tenfoldfleet/trustpilot-reviews-scraper-new-reviews-monitor) | review |
| [BBB Scraper: Business Leads, Ratings & New Reviews](https://apify.com/tenfoldfleet/bbb-scraper-leads-reviews) | business |
| [Booking Reviews Scraper - New Guest Reviews Monitor by Hotel](https://apify.com/tenfoldfleet/booking-reviews-scraper-new-reviews-monitor) | review |
| [Douban Reviews Scraper - Movies, Books, TV & Groups](https://apify.com/tenfoldfleet/douban-reviews-scraper) | review |
| [1688 Alibaba AliExpress Image Search: Compare Prices by Photo](https://apify.com/tenfoldfleet/1688-alibaba-aliexpress-image-search) | matched product |
| [1688 Image Search API - Reverse Image Search for Factory Prices](https://apify.com/tenfoldfleet/1688-image-search-suppliers-by-photo) | image search |
| [1688 Product Details API: Price Tiers, MOQ, Specs & Supplier](https://apify.com/tenfoldfleet/1688-product-details-scraper) | product details |
| [1688 Products Search: Wholesale Prices, Sales & Suppliers](https://apify.com/tenfoldfleet/1688-products-search) | product |

All 122 tools: [apify.com/tenfoldfleet](https://apify.com/tenfoldfleet). If this Actor saves you time, save it (the bookmark on its Store page) and leave a review: both help other people find it. Found a bug or need another field? Tell us on the Issues tab of this page.

# Changelog

This Actor's version history is a separate document: https://apify.com/tenfoldfleet/amazon-reviews-summary/changelog.md

# Actor input Schema

## `asins` (type: `array`):

Amazon product IDs (10 letters and digits, e.g. B00FLYWNYQ) or product page URLs (https://www.amazon.de/dp/B07GG1ZGX2). ASINs use the marketplace below; a URL uses its own marketplace. One product = one row. On the Apify free plan, the $5 monthly credit covers about 500 products.

## `marketplace` (type: `string`):

Amazon site used for bare ASINs. Some marketplaces show no AI summary for some or all products: you then get the star breakdown only, at the lower rating-breakdown price (or a free row if you turn on the option below).

## `includeSnippets` (type: `boolean`):

Add the short review quotes Amazon shows under each aspect, with a link to the full review. Turn off for smaller rows.

## `skipWithoutAiSummary` (type: `boolean`):

Off (default): a product that has ratings but no AI summary is saved with its star breakdown and charged as a rating breakdown. On: such products get a free row instead.

## `maxItems` (type: `integer`):

Stop after this many charged products. 0 = no limit.

## `proxyConfiguration` (type: `object`):

Apify datacenter proxy with a fresh IP for every retry (default, recommended). Residential proxy groups are ignored; the Actor adds its own residential fallback for pages Amazon keeps blocking, at no extra charge.

## Actor input object example

```json
{
  "asins": [
    "B00FLYWNYQ",
    "B0CRTR3PMF",
    "B0CS3V8M9H"
  ],
  "marketplace": "com",
  "includeSnippets": true,
  "skipWithoutAiSummary": false,
  "maxItems": 0,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "asins": [
        "B00FLYWNYQ",
        "B0CRTR3PMF",
        "B0CS3V8M9H"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("tenfoldfleet/amazon-reviews-summary").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "asins": [
        "B00FLYWNYQ",
        "B0CRTR3PMF",
        "B0CS3V8M9H",
    ],
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("tenfoldfleet/amazon-reviews-summary").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "asins": [
    "B00FLYWNYQ",
    "B0CRTR3PMF",
    "B0CS3V8M9H"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call tenfoldfleet/amazon-reviews-summary --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,tenfoldfleet/amazon-reviews-summary"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/ivRLoZAWqoIUS8zMv/builds/xq4n7HwESeWMZBuwh/openapi.json
