# Find recurring defects in Amazon reviews

**Use case:** 

Paste your Amazon reviews in and get each recurring fault with its name, how many separate customers reported it, the first and last date, the worst star rating and their exact words. One-off complaints are left out.

## Input

```json
{
  "maxReviews": 100,
  "reviewsScraperActor": "junglee/amazon-reviews-scraper",
  "reviews": [
    {
      "userId": "R1",
      "date": "2026-03-02",
      "ratingScore": 2,
      "reviewDescription": "The left earbud stopped charging after about four months. Case shows it at 100% but it is dead."
    },
    {
      "userId": "R2",
      "date": "2026-03-19",
      "ratingScore": 1,
      "reviewDescription": "Left bud stopped charging completely around month five. Right one is fine."
    },
    {
      "userId": "R3",
      "date": "2026-04-07",
      "ratingScore": 2,
      "reviewDescription": "Battery died on the left earbud after four months of light use. Very disappointing."
    },
    {
      "userId": "R4",
      "date": "2026-02-11",
      "ratingScore": 1,
      "reviewDescription": "Case hinge snapped in my pocket within a few weeks. The plastic is far too thin."
    },
    {
      "userId": "R5",
      "date": "2026-05-02",
      "ratingScore": 2,
      "reviewDescription": "The hinge on the charging case broke after about three weeks of normal use."
    },
    {
      "userId": "R6",
      "date": "2026-05-14",
      "ratingScore": 1,
      "reviewDescription": "Hinge cracked and now the case will not stay shut at all."
    },
    {
      "userId": "R7",
      "date": "2026-01-30",
      "ratingScore": 3,
      "reviewDescription": "Did not like the colour, it is more grey than silver in person."
    }
  ],
  "minCorroboration": 3,
  "productName": "Wireless Earbuds (example)",
  "linkUrl": "https://www.amazon.com/dp/B08EXAMPLE"
}
```

## Output

```json
{
  "defectPhrase": {
    "label": "Defect",
    "format": "string"
  },
  "distinctReviewers": {
    "label": "Reviewers",
    "format": "integer"
  },
  "totalMentions": {
    "label": "Mentions",
    "format": "integer"
  },
  "severityMinRating": {
    "label": "Worst rating",
    "format": "integer"
  },
  "firstSeen": {
    "label": "First seen",
    "format": "string"
  },
  "lastSeen": {
    "label": "Last seen",
    "format": "string"
  },
  "product": {
    "label": "Product",
    "format": "string"
  },
  "asin": {
    "label": "ASIN",
    "format": "string"
  },
  "result": {
    "label": "Row type",
    "format": "string"
  },
  "criticalReviewsAnalysed": {
    "label": "Reviews read",
    "format": "integer"
  },
  "clustersFound": {
    "label": "Faults grouped",
    "format": "integer"
  },
  "clustersBelowThreshold": {
    "label": "Near misses",
    "format": "integer"
  },
  "minCorroboration": {
    "label": "Threshold",
    "format": "integer"
  },
  "analysedAt": {
    "label": "Analysed at",
    "format": "string"
  },
  "productUrl": {
    "label": "Product URL",
    "format": "string"
  }
}
```

## About this Actor

This example demonstrates how to use [Amazon Review Defect Finder](https://apify.com/pradio/amazon-defect-ledger.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/pradio/amazon-defect-ledger.md) to learn more, explore other use cases, and run it yourself.


## 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.
This Task's input is already configured above — use it as-is rather than inventing a new one.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/pradio/amazon-defect-ledger.md

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).