# Amazon Bestsellers Scraper + AI: Rising Products Only (`rich_minds/amazon-product-finder-ai`) Actor

First 25 product opportunities free. Amazon bestsellers: AI to find rising Amazon products you can still beat. Pay per qualified product. Amazon product research with AI. Demo, built-in list reader and own lists on any plan; the Store source Actor only on a plan that runs Store Actors.

- **URL**: https://apify.com/rich_minds/amazon-product-finder-ai.md
- **Developed by:** [Rich Minds](https://apify.com/rich_minds) (community)
- **Categories:** E-commerce, Marketing
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.70 / 1,000 qualified product opportunity (rules only)s

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## Amazon Bestsellers Scraper + AI: Rising Products Only

**New Amazon products worth sourcing — rising, beatable, never repeated — in your inbox every week.**

⚡ First **25 product opportunities free** · 💵 **$0.0037** per qualified product · 🤖 **≈ $0.012** with AI, tokens included, on plans with model access or your key · ⏱️ demo in seconds

![One row per qualified Amazon product — rank, rank change, reviews, price, the AI verdict and the risks it spotted](https://api.apify.com/v2/key-value-stores/9E0tmia410Qgh3ZeF/records/shortlist.svg)

> **Try it in 30 seconds.** Click **Try it** — the form is pre-filled with seven sample list rows. Your first
> **25 qualified products** are free; products that fail your filters cost nothing here. Type a niche such as
> `kitchen` to scan live — the Actor reads Amazon's public list pages itself.
> → [What a run costs](#-pricing--what-a-run-really-costs) · [What the AI adds](#-what-the-ai-tier-adds) · [Run it weekly](#-run-it-weekly)

### ⚡ At a glance

| | |
|---|---|
| **What you get** | A sourcing shortlist: one row per product across Best Sellers, Movers & Shakers, New Releases and Most Wished For — score, pursue / watch / skip verdict, notes, angle, risks |
| **You provide** | A niche in a word (`kitchen`, `pet supplies`) and a marketplace (US, UK, DE, IN, CA, JP) — or your own Amazon list URLs |
| **Output** | a ranked sheet, best first — open it in Excel, CSV or Google Sheets — plus an e-mail digest of what is new each run |
| **Typical run** | 300 rows scanned → 45 qualified (15 %) — (estimate), a few minutes |
| **Cost of that run** | $0.77 rules only · $1.15 with AI ($0.60 source scan + 45 × $0.0037 / $0.0092 here + ≈ $0.14 tokens) — the scan is $0 on the built-in reader |
| **Free tier** | first 25 qualified products per account |
| **Keys / setup** | Apify model access: no key · otherwise your own key — a free Gemini / Groq key = 1–3 live AI verdicts per run, paid = every product |
| **Which plan** | Free demo, built-in list reader and your own rows (`list` mode, [template](https://api.apify.com/v2/key-value-stores/9E0tmia410Qgh3ZeF/records/list-template.json)): any plan · the Store source Actor, only if Amazon blocks the reader: a plan that runs Store Actors |

### 🎯 What this Actor does

Amazon product research from the lists you already watch: it keeps only the products an FBA or private-label seller can still win, and charges only for those.

- **One row per product, not per list** — the same ASIN on two lists is one row with every list and rank.
- **Rising products first** — rank change and new entrants against your last run: a weekly schedule alerts on what climbed, not the same top 100.
- **A beatable-or-not read** — a 0–100 score from rank, stars, review barrier, price band and list presence, plus flags like `low_barrier`.
- **AI verdict with reasons** — pursue / watch / skip, notes, an angle from the title and a niche, grounded in the row's own figures.
- **Risks named** — brand-locked, commodity and regulated titles are flagged before you order a sample.
- **Niche in, lists out** — type `kitchen` or `pet supplies` in `niches` (or just your goal) and those departments' Movers & Shakers and New Releases are scanned on the marketplace you pick (`marketplace`) and named in the status (`OUTPUT.seedsDerived`).
- **No source bill on any plan** — the built-in reader reads the public Best Sellers and New Releases pages itself (Movers & Shakers pages load in the browser only and are skipped, named in the result). Only if Amazon blocks every list does the Store source Actor run, capped.

### 🚀 How to use it

1. **Click `Try it`** — the form is pre-filled with the free demo on sample list rows; it works as is.
2. **Type a niche** ("Niches or departments to scan") or paste your own list URLs — it replaces the sample and starts the live scan. Leave "AI assessment" on: your first 5 products get live AI verdicts on any plan; all 25 free ones with Apify model access or a paid own key.
3. **Press Start and open the dataset** — qualified products land best-first; export to CSV/Excel, or wire a webhook.
4. **Schedule it weekly** (Actions → Schedule) with your address in `notifyEmail` — only new or climbing products are delivered and charged.

#### 📦 Already scraping Amazon bestsellers? Qualify your scraper data

Paste your last scraper run's dataset ID into **Dataset ID** — no second scrape, you pay only for qualified products. After every scrape: the [chained-run recipe](#-integrations-automation-and-api).

![The Rising and new view — which products climbed since the last run](https://api.apify.com/v2/key-value-stores/9E0tmia410Qgh3ZeF/records/rising.svg)

📚 **Learn more:** [Step-by-step tutorial — find rising Amazon products to sell](https://api.apify.com/v2/key-value-stores/9E0tmia410Qgh3ZeF/records/tutorial.html)

### 🆚 Why this instead of running the source Actor yourself?

| | [Fast Amazon Bestsellers Scraper (`amazon-scraper/amazon-bestsellers-scraper`)](https://apify.com/amazon-scraper/amazon-bestsellers-scraper) | **Amazon Bestsellers Scraper + AI: Rising Products Only** |
|---|---|---|
| **Price** | $0.002 per row + $0.00005 start · 323 users / 30 days (Store metrics, 2026-10-04) | from $0.0037 per qualified product, first 25 free, no start fee |
| **What you pay for** | every *row scraped*, saturated, brand-locked and duplicate ones included | only *qualified products* — what fails your filters costs **$0 here** (the source's scan is billed on your account, capped) |
| **Same 100 usable products, all in** | $1.33 for ≈ 667 raw rows — and you still sort them | $2.33 basic · $5.43 with the AI: the same $1.33 scan plus filtering — 100 ranked, explained products, not 667 rows to read |
| **Your time per 100 products** | ≈ 10 h of reading rank, reviews, price and titles (6 min each — estimate) | ≈ 0 h — scored, explained, risks flagged |

The free [Amazon Best Sellers pages](https://www.amazon.com/gp/bestsellers) win for a one-off browse; they have no export, API, schedule, rank history, scoring or dedupe.

### 💵 Pricing — what a run really costs

**One event per qualified product, nothing else.**

| Event | When it is charged | Price |
|---|---|---|
| `free-tier` | your first 25 qualified products on this Actor, in any mode | **$0.00** |
| `qualified-product-opportunity-basic` | AI off — normalised fields, flags, rule score, rule verdict | **$0.0037** |
| `qualified-product-opportunity-ai` | AI on — everything above plus verdict, notes, angle, niche and risks | **$0.0092** |

**One free tier:** your first 25 qualified products are free, whatever the tier. **We never charge for** products below `minScore`, failing a free filter, on your exclude list or already received — and there is no start fee. **The source's scan is not ours to waive:** in `actor` mode the source Actor bills your account $0.002 per scanned row, rejected ones included, capped by `maxDiscoveryChargeUsd`.

**How that compares** — $0.0037 is 0.99× the $0.00375 Store median for "amazon bestsellers" scrapers, but only per qualified product: one replaces ≈ 6.7 scanned rows, ≈ $0.025 per raw-row equivalent.

**Worked example** — 300 rows scanned → 45 qualified with AI on: source Actor $0.60 on your account + 45 × $0.0092 + ≈ $0.14 tokens → $1.15 total, about $0.026 per qualified product ($0.77 and $0.017 with AI off). When the built-in reader serves the lists the $0.60 is $0: $0.55.

**At volume** — 20 lists × 100 rows weekly: ≈ $4.73 a week (estimate).

**AI tier, all in:** ≈ $0.012 per product ($0.0092 here + ≈ $0.003 tokens: ≈ 450 in, ≈ 150 out) — for the verdict, notes, angle and risks that ≈ 6 minutes of reading by hand would produce (an estimate based on reading, not yet timed).

### 🤖 What the AI tier adds

The same product, AI **off** — facts, flags, rule score and verdict (free demo, 2026-10-04):

```json
{"asin": "B0DEMO0001", "rank": 3, "rankChange": 14, "flags": ["rising_rank", "multi_list", "low_barrier"], "ruleScore": 82, "tier": "hot", "verdict": "pursue",
 "generatedText": "Look at Silicone Stretch Lids …: #3 on movers and shakers; 412 reviews at 4.5★; rule score 82/100."}
```

AI **on** (`qualified-product-opportunity-ai`, $0.0092) — judged against *your* goal (a real run of the AI example, free Gemini key, 2026-10-16):

```json
{"asin": "B0DEMO0001", "fitScore": 75, "score": 75, "tier": "hot", "verdict": "pursue",
 "demandNote": "It ranks at position 3 and appears on both bestsellers and movers-and-shakers lists.",
 "competitionNote": "It features only 412 reviews while maintaining a 4.5-star rating, presenting an accessible entry barrier.",
 "angle": "Introduce an alternative color assortment or add a specialized mesh produce bag to differentiate from standard silicone stretch lids.",
 "niche": "silicone food covers", "riskFlags": [], "aiModel": "google:gemini-3.5-flash-lite"}
```

The AI also filters: in that run the Apple earbuds (98,214 reviews) scored below the bar, not delivered.

**Try the AI on any plan:** the demo shows labelled sample verdicts, your first real search gets **5 live AI verdicts on us**, then bring a key (`llmProvider: byok`): a free Gemini key ([get one](https://aistudio.google.com/apikey)) assesses a few products per run, a paid key every product.

### ⚙️ Input

```json
{"niches": ["kitchen"], "marketplace": "amazon.com", "goalDescription": "Kitchen gadgets a new listing can beat",
 "maxReviews": 1500, "maxQualified": 50}
```

#### 🎛️ Input options

| Field | Type | Default | What it does |
|---|---|---|---|
| `niches` | string\[] | — | Departments in plain words (`kitchen`, `pet supplies`): their Movers & Shakers and New Releases lists are scanned |
| `marketplace` | select | `amazon.com` | The Amazon domain the niches are read on (.co.uk, .de, .in, .ca, .co.jp) |
| `categoryUrls` | string\[] | — | Your own Amazon list URLs (Best Sellers, New Releases, Movers & Shakers, Most Wished For), mixed freely |
| `maxDiscoveryChargeUsd` | number | `0.5` | Cap on the source Actor when Amazon blocks the built-in reader — same in the form and for an API call |
| `goalDescription` | string | — | What the AI scores each product against |
| `minScore` | 0–100 | `50` | The field that decides what you pay: below this = not delivered, not charged |
| `maxReviews` | integer | `0` (off) | The review barrier: drop products with more reviews (1,500 suits a new private label) |
| `minStars`, `minReviews`, `priceMin`, `priceMax`, `maxRank` | number / integer | `0` (off) | Free filters: rating, reviews, price window, top-N rank |
| `excludeBrands`, `onlyNewOrRising` | string\[], boolean | —, `false` | Skip brand names; keep only new, climbing or growth-list products |
| `enableAi` | boolean | `true` | AI assessment on/off |
| `maxQualified` | integer | `100` | Hard cap on output (and on spend) |

`sourceMode` (`actor` / `dataset` / `list`; `{}` runs the free demo) and the other options are in the **Input** tab; flags (`rising_rank`, `low_barrier` …) go into `targetFlags` — all twelve in the API reference.

### 📤 Output

One dataset item per qualified product — export as JSON, CSV or Excel, or stream it to a webhook.

<details><summary>A real row of the free demo, and every output field</summary>

| Field | Description |
|---|---|
| `itemId`, `name`, `url`, `asin`, `marketplace`, `imageUrl` | Identity — stable across runs |
| `rank`, `listTypes`, `listRanks`, `listLabel`, `categoryUrl`, `categoryPath` | Best rank, each list with its rank, the list's title and URL, the breadcrumb |
| `stars`, `reviewsCount`, `priceText`, `priceValue`, `currency`, `listPriceText` | Rating, reviews, price as shown and parsed, currency, struck-through price (`null` when not shown) |
| `isNew`, `rankChange`, `firstSeenAt` | From this search's memory |
| `flags`, `targetFlagsMatched`, `riskFlags` | Rule findings, matched target flags, risks |
| `ruleScore`, `fitScore`, `score`, `tier` | Rule score, AI fit, ranking score, hot / warm / cold (`label` = same value as `tier`, the 0.1 name) |
| `qualified`, `verdict`, `assessmentSource`, `aiModel` | Always `true`; `pursue` / `watch` / `skip`; `llm` or `rules`; the model |
| `demandNote`, `competitionNote`, `angle`, `niche`, `scoreReasons`, `summary`, `recommendedNextStep`, `generatedText` | AI assessment (empty with AI off) |
| `chargedEvent`, `billedAs`, `dedupeKey`, `source`, `scrapedAt` | Provenance and billing |

Map `url`, `score` and `tier`; no other field carries their value. Sort by `score`; `ruleScore` is the rule part and `fitScore` the AI's — **trend across runs on `ruleScore`**. The "Score breakdown" view shows the parts.

</details>

One pinned item and the `OUTPUT` keys are in the [API reference](https://api.apify.com/v2/key-value-stores/9E0tmia410Qgh3ZeF/records/api-reference.md).

**Upsert key for a CRM or Sheet:** `dedupeKey` — marketplace + ASIN (`asin:amazon.com:B0…`), the cross-run memory's key: one product, one row however many lists or runs find it.

Every delivering run also writes a **`DIGEST`** (new, hot, **what changed since the last run**, top 10) and a client-ready **`REPORT`** page. Views: `Shortlist`, `Sourcing sheet`, `Rising and new`, `Overview`, `Score breakdown`.

⭐ **Found it useful? A review on the Store helps others find it**.

### 🔁 Run it weekly

1. **Open the saved task and click Schedule** after your first real run (its status links it). Put your address in `notifyEmail` — every run with new products e-mails the digest (top 10 with links **and the trend vs the last run**).
2. Leave `dedupeAcrossRuns: true` — every product you were charged for is remembered, so the next run charges **only what is new**. The memory is per search; give each client its own `dedupeStoreName`.
3. Paste a Slack, Teams, Google Chat, Discord or Telegram link into **Send alerts to** for the digest in your channel, or Google Sheets for the rows: start from the [ready tracker sheet](https://api.apify.com/v2/key-value-stores/9E0tmia410Qgh3ZeF/records/tracker.csv) (`dedupeKey` first) and the [Slack message block](https://api.apify.com/v2/key-value-stores/9E0tmia410Qgh3ZeF/records/slack-digest.json).
4. From the second run on, the `REPORT` page shows every run; `historyDatasetName` keeps a dated log.
5. Amazon's lists change daily, so the same lists return new entrants and climbers (week-2 yield: estimate).

Weekly cost is new products only: ≈ 10 new or climbing a week (estimate) × $0.0092 + $0.50 source ≈ $0.59 (the source part is $0 with the built-in reader).

#### 🎯 Try it for your niche

Pick one in **Start from a ready niche search** at the top of the form, press Start, then schedule it.

| Niche | What it looks for | Start |
|---|---|---|
| Kitchen gadgets | Movers & Shakers and New Releases in Kitchen, ≤ 1,500 reviews, new or rising only | preset `kitchen-rising` |
| Pet supplies | New Releases in Pet Supplies, ≤ 300 reviews, 4+ stars, $10–$50 | preset `pet-new-releases` |
| Home & garden | Best Sellers + Most Wished For in Home & Garden, ≤ 3,000 reviews, no Amazon Basics / Rubbermaid / OXO | preset `home-bestsellers` |

### 🔌 Integrations, automation and API

**After every Amazon bestsellers scraper run** (`junglee/amazon-bestsellers`, `amazon-scraper/amazon-bestsellers-scraper`): in that Actor's Integrations tab add "Run succeeded → start this Actor" with `sourceMode: dataset`, `datasetId` = `resource.defaultDatasetId`, `enableAi: false`.

Webhook, Google Sheets and Slack from the **Integrations** tab, Airtable / Notion / HubSpot through a Make or Zapier "create or update" step (upsert on `dedupeKey`; fields `verdict`, `niche`, `angle`, `priceValue`, `reviewsCount`, `rank`), and MCP for AI agents — every input is a plain typed field. The free first call is `{}` (the demo) or `{"sourceMode": "list", "itemsList": [...]}`.

Minimal inputs: search `{"niches": ["kitchen"]}` · URL `{"categoryUrls": ["https://www.amazon.com/gp/movers-and-shakers/kitchen"]}` · any plan, your own rows `{"sourceMode": "list", "itemsList": [{"title": "…", "asin": "B0…"}]}`.

<details><summary>Webhook contract, run outcomes and list-mode rows</summary>

Webhook: `{"event": "product.qualified", "product": {…}, "runId": "…"}` per product (batched: `products.qualified`); with `webhookSecret` every POST carries `X-Signature: sha256=<HMAC-SHA256 of the body>`; a 429 / 5xx is retried once, a failed POST never fails the run, its keys go to `OUTPUT.webhook.failedKeys` and are not re-sent next run. Full contract: [API reference](https://api.apify.com/v2/key-value-stores/9E0tmia410Qgh3ZeF/records/api-reference.md).

#### Run outcomes

| Outcome | Run status | `OUTPUT` | Charged? | What to do |
|---|---|---|---|---|
| Success | SUCCEEDED | `outcome: "ok"`, funnel, `chargedEvents`, `aiCoverage` | per qualified product | — |
| Your plan cannot run the source Store Actor | SUCCEEDED — the same for the Console, the API and a schedule; check `OUTPUT.ok` | `ok: false`, `outcome: "source_refused"`, `sourceError`, `sourceRefused: "plan"` | no | paste list-mode rows below |
| Source failed (nothing loaded) | FAILED | `ok: false`, `outcome: "source_failed"`, `sourceError` | no | follow the reason in the status |
| Loaded, nothing qualified | SUCCEEDED, 0 rows | `outcome: "empty"` | no | loosen the filters |
| Source partial (a list timed out after scraping) | SUCCEEDED | `sourceStatus` (`partial: true`) | per qualified product | scan fewer lists |
| AI unavailable | SUCCEEDED, rule-scored | `aiError`, `aiCoverage` | free while free products last, then basic | `llmProvider: byok` |

Pipelines: branch on `OUTPUT.outcome` — `ok`, `empty`, `source_refused` or `source_failed`; `OUTPUT.ok` is `false` for the last two.

**Which call runs what** (demo, live search or your own rows — `OUTPUT.mode`): API reference.

#### List-mode rows — what a pasted row needs

`sourceMode: "list"` runs on any plan: paste rows into `itemsList` — start from the [ready template](https://api.apify.com/v2/key-value-stores/9E0tmia410Qgh3ZeF/records/list-template.json). The rows use the source Actor's field names; a row needs only `title`.

| Field | Needed? | What it enables |
|---|---|---|
| `title` | required | the product's name (also read from `name`) |
| `asin`, `link` | recommended | the dedupe key, the merge across lists, the product URL and marketplace |
| `position` | recommended | `rank`, the demand part of the score, `maxRank` |
| `categoryUrl`, `category` | optional | `listTypes` and the list title |
| `price`, `currency`, `price2` | optional | `priceValue` (`5,95 €` and `$31.49` both parse), the price band |
| `stars`, `reviewsCount` | optional | the quality and review-barrier parts of the score |
| `parents`, `image`, `status` | optional | `categoryPath` / `niche`; `imageUrl`; a `status` other than 200 drops the row |
| `isNew`, `rankChange`, `firstSeenAt` | optional | earlier-run figures (a live run computes them itself) |

</details>

<details><summary>Python, JavaScript and MCP snippets (copy-paste)</summary>

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")
run = client.actor("rich_minds/amazon-product-finder-ai").call(
    run_input={
        # free first call instead: {} (the demo) or {"sourceMode": "list", "itemsList": [{"title": "…", "asin": "B0…"}]}
        "niches": ["kitchen"],
        "goalDescription": "Kitchen gadgets a new private-label listing can beat",
        "maxReviews": 1500,
        "maxQualified": 50,
        "maxDiscoveryChargeUsd": 0.5,  # cap if the source Actor has to run on your account
    },
    timeout_secs=3600,  # sized for the AI path with your own key — see "How long does a run take?"
    # build="0.1.6",  # pin the build number your pipeline was tested with (Changelog below)
)
out = client.key_value_store(run["defaultKeyValueStoreId"]).get_record("OUTPUT")["value"]
if out.get("sourceError"):  # ok: false — a refusal ends SUCCEEDED with 0 rows, not "nothing new"
    raise RuntimeError(out["sourceError"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["name"], item["score"], item["verdict"], item["url"])
```

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

const client = new ApifyClient({ token: '<YOUR_API_TOKEN>' });
const run = await client.actor('rich_minds/amazon-product-finder-ai').call({
    // free first call instead: {} (the demo) or { sourceMode: 'list', itemsList: [{ title: '…', asin: 'B0…' }] }
    niches: ['kitchen'],
    goalDescription: 'Kitchen gadgets a new private-label listing can beat',
    maxReviews: 1500,
    maxQualified: 50,
    maxDiscoveryChargeUsd: 0.5, // cap if the source Actor has to run on your account
}, { timeout: 3600 /* , build: '0.1.6' — pin the tested build */ });
const out = (await client.keyValueStore(run.defaultKeyValueStoreId).getRecord('OUTPUT')).value;
if (out.sourceError) throw new Error(out.sourceError); // ok: false — SUCCEEDED with 0 rows, not "nothing new"
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.map((i) => [i.name, i.score, i.verdict, i.url]));
```

**MCP** — add Apify's MCP server with this Actor as a tool:

```json
{"mcpServers": {"apify": {"url": "https://mcp.apify.com/?actors=rich_minds/amazon-product-finder-ai"}}}
```

**Minimal agent input** — every other input keeps its default:

`{"niches": ["kitchen"], "goalDescription": "kitchen gadgets a new listing can beat", "maxReviews": 1500, "maxQualified": 50, "maxDiscoveryChargeUsd": 0.5, "dedupeAcrossRuns": false}` — memory off: asked twice, it answers twice.

</details>

### 👥 Who is it for?

| You are… | You run it to… | Start with |
|---|---|---|
| Amazon FBA / private-label seller | find rising, beatable products in your category | preset `kitchen-rising` |
| Product researcher or sourcing agent | hand a client a shortlist with reasons | Movers & Shakers + New Releases URLs, `onlyNewOrRising`, the Sourcing sheet |
| E-commerce store owner | learn when something new enters your shelf | one URL per shelf, weekly, `notifyEmail` |
| Dropshipping / wholesale buyer | skip brand-locked and regulated listings | `excludeBrands` |

### 🧠 How the AI works

- **Grounded, not generative.** The model sees one product's list-page fields and returns a typed assessment. It is told it knows no sales, revenue or margin; a sentence quoting a number that is not in the row, or a sales claim, is dropped and replaced by a rule-built note. A risk flag stays only if its quote is in the title.
- **Your goal, not a generic score.** The fit score is against your `goalDescription`: `pursue` = hot (≥ 70), `watch` = warm (45–69), `skip` = cold (no angle, no text).
- **Tokens only where they matter.** The best rule-scored candidates get the AI pass, best first; no key with Apify model access (`anthropic/claude-haiku-4.5`), else your own (a Gemini key runs `google:gemini-3.5-flash-lite`). If the model cannot be reached, products arrive rule-scored.

### 🔒 Data, compliance and limits

- Only what Amazon publishes on public list pages (title, rank, price, rating, reviews, category) — no login, no seller or reviewer data.
- A list page shows 50 products (two pages = top 100); a missing rating or price is `null`, never guessed; `currency` sits next to every price.
- The score (demand 40 · growth 25 · monetisation 20 · quality 15) ranks what to look at first — not sales data. Keep your use within Amazon's terms and applicable law (GDPR, CCPA).

### ❓ FAQ

**How much will one run cost me?** A typical run — 300 rows scanned, 45 qualified — is in the worked example above; the built-in reader makes the source scan $0.

**What will my first real search cost?** ≈ 30 qualified from 200 rows — the first 25 are free here, so only ≈ 5 are paid; the source Actor's bill applies only when Amazon blocks the reader (capped by `maxDiscoveryChargeUsd`).

**How do I find rising Amazon products?** Type your niche, set `maxReviews` at the barrier you can beat, read the verdicts and risk flags first, and schedule it.

**Is this an Amazon product research tool?** For the list-page half: demand momentum, review barrier, price band and risks per ASIN — it does not estimate sales or revenue.

**Is this an Amazon FBA product finder, or a Helium 10 alternative?** For the first filter, yes: it finds rising, beatable products from the public lists and charges per qualified product instead of a monthly seat. It does not estimate monthly sales or margin, which seller tools like Helium 10 do — use it to build the shortlist, then check the few survivors there.

**Can I track Amazon Movers and Shakers weekly?** Yes — add your category's Movers & Shakers URL, schedule the run, set `onlyNewOrRising`; each digest lists what entered or climbed.

<details><summary>More: plans, dedupe, run times, free-tier reserve, models, legality, scheduling</summary>

**What are Amazon best seller opportunities here?** Products that rank but are still beatable: low review barrier, no big brand, a workable price, rising or new on a list.

**What does "qualified" mean?** A product that passed your free filters, was not delivered in an earlier run and scored at least `minScore` (the AI fit score when assessed, else the rule score). Only those are charged.

**What happens if nothing matches?** The run succeeds with 0 rows, charges nothing by us, and the status says so.

**Will I be charged for the same product twice?** No, with `dedupeAcrossRuns` on (default): every charged product is remembered in a key-value store on your account, whichever list finds it again. Adding a category URL keeps that memory; another source (`dataset`, `list`), each `dedupeStoreName` and each set of `targetFlags` keep their own. A product already charged under one of them arrives in the other as `already-charged`, never charged again. A returning product is delivered — and charged — again only after `dedupeTtlDays` days (0 = never).

**Which Apify plan do I need?** Any plan runs the free demo and the built-in list reader. The source-Actor fallback (only if Amazon blocks the reader) and Apify's model access need a plan that can run Store Actors; otherwise paste rows in `list` mode and use `llmProvider: "byok"` — a free Gemini / Groq key assesses a few products per run, a paid key every product. If the AI is refused the status says "AI unavailable" and products arrive rule-scored.

**How long does a run take?** One row per mode — size your `timeoutSecs` from it:

| Mode | Time | `timeoutSecs` to pass |
|---|---|---|
| Free demo (7 sample rows) | 0.1 s (measured locally, 2026-10-04) | 120 |
| Live search, rules only | the source's scan: a few minutes for 300 rows | 900 |
| AI via Apify's model access | ≈ 3–6 s per product (estimate; to be measured), 8 calls at a time | 1800 |
| AI with a free own key (`byok`) | a few products per run — the AI stops after 2 minutes of rate-limit waiting, the rest rule-scored | 900 |
| AI with a paid own key | ≈ 3–6 s per product, 2 calls at a time (estimate; to be measured) | 3600 |

Pass `timeoutSecs` 3600 to `.call()`; `OUTPUT.timing` reports the phases. Worst case per 100 products with a rate-limited own key: the AI phase stops after its 2-minute wait budget, so ≈ 5 minutes in all (estimate).

**Do rule-scored products use my free ones?** Yes, while the AI is unavailable — except the last 5, kept so your first AI-assessed products are free too.

**How do I send the openers safely?** `generatedText` is a sourcing note for you, not a message. If you reuse it to contact a seller, do it by hand — a few a day, no links or off-platform contact IDs, only through Amazon's own messaging.

</details>

### 🧩 More Actors from the same developer

Same pay-per-qualified-result model — next step after your shortlist: check what the winners resell for, or how rivals advertise them.

- **[eBay Sold Listings Comps AI](https://apify.com/rich_minds/ebay-sold-comps-ai)** — Clean eBay sold comps and a max buy price for your exact item, every week — the resale check for what you found here.
- **[Facebook Ad Library Winning Ads Finder](https://apify.com/rich_minds/fb-ad-library-winning-ads)** — The Facebook ads in your product's niche that have run longest, hook and offer broken down.
- **[Trending Keywords for Your Niche](https://apify.com/rich_minds/trending-keywords-ai)** — Your niche's new trending keywords and Black Friday peaks, in your inbox every week.
- **[Website Change Monitor](https://apify.com/rich_minds/website-change-monitor-ai)** — Every real change on your competitors' pages, explained, in your inbox every week.
- **[1688 Supplier Finder](https://apify.com/rich_minds/1688-supplier-finder-ai)** — New trusted 1688 factories for your product — costed and translated, in your inbox every week.

### 🆘 Support

Something missing or wrong? Open an issue on the Actor's page.

### 📝 Changelog

- **0.1.6** (2026-10-16) — One "Send alerts to" box takes your Slack, Discord, Teams, Google Chat, Telegram or webhook link, and the form is shorter: technical options now sit out of the way; A product you already paid for under another search or filter set is still delivered there but never charged twice, and webhook posts can be signed so your endpoint knows they came from this Actor; If your plan cannot run the backup Amazon scraper, the run now ends calmly with a clear next step instead of failing.
- **0.1.5** (2026-10-05) — the live scan reads Amazon's Best Sellers and New Releases pages itself, so it works on any plan with no source bill (Movers & Shakers pages are skipped and named in the result); type a niche and pick a marketplace; `OUTPUT.outcome` says `ok`, `empty` or `source_failed`; the hot / warm / cold field is `tier` (`label` keeps the same value for one more version); webhook events are `product.qualified` / `products.qualified`; a Slack message block ships with the weekly recipe.
- **0.1.2** (2026-10-05) — pricing now applies on the Apify Store: each qualified product is billed at $0.0037 (rules only) or $0.0092 (AI-assessed), first 25 free.
- **0.1.1** (2026-10-05) — initial release: Amazon list URLs (or just your goal) in, one row per ASIN with rank, rank change, price, a score and a pursue / watch / skip verdict.

# Actor input Schema

## `niches` (type: `array`):

Plain words, e.g. <code>kitchen</code>, <code>pet supplies</code>: the Actor scans those departments' Movers & Shakers and New Releases (up to 3, named in the status). The live search reads Amazon's pages itself; if Amazon blocks that, it runs a Store Actor on your Apify plan — if your plan cannot run Store Actors, use `list` mode.

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

Where the niches above are read. Prices keep the marketplace's currency. A department Amazon names differently there is skipped — paste its list URL instead.

## `goalDescription` (type: `string`):

Your goal in plain words, e.g. <i>private-label kitchen gadgets under $30 that a new listing can beat</i>. The AI scores every product against it; with no niche or list URL, the departments it names are scanned for you. Empty = a general FBA-sourcing goal.

## `preset` (type: `string`):

Pick a niche and press Start: it fills the search fields you left empty and runs the live search (spend-capped by <code>maxDiscoveryChargeUsd</code>). Your own values always win. <b>Custom</b> = fill the fields yourself.

## `minScore` (type: `integer`):

The field that decides what you pay: product opportunities scoring below this are discarded and <b>not charged</b>. Raise it to pay only for the strongest matches, lower it to see more.

## `maxQualified` (type: `integer`):

Hard cap on results — and the ceiling of what <b>this Actor</b> charges: at most this many × $0.0092 with AI on (× $0.0037 with AI off), e.g. 100 × $0.0092; the source's own spend has its cap right below. The best-scoring product opportunities are output first.

## `maxDiscoveryChargeUsd` (type: `number`):

Hard cap on what the source Actor run may charge your account when the built-in reader is blocked and the Store Actor runs instead — $0.50 in the form and for an API or agent call that leaves it out, so a first real search can never cost more. The built-in reader costs nothing here. Raise it for bigger searches.

## `enableAi` (type: `boolean`):

Score each product opportunity against your goal, explain why, summarise it and generate text. <b>On = $0.0092 per qualified product opportunity + AI tokens; off = $0.0037</b> (rule-based flags and scores only). Your first 5 product opportunities get live AI verdicts on any plan; every one with Apify model access or a paid own key.

## `notifyEmail` (type: `string`):

After every run with at least one new product opportunity, the run's digest (how many are new, the top 10 with links) is e-mailed here through Apify's send-mail Actor. Schedule the run weekly (Actions → Schedule) and only the new product opportunities come to your inbox — no Slack or Zapier needed. Never sent for the free demo.

## `categoryUrls` (type: `array`):

Best Sellers, New Releases, Movers & Shakers or Most Wished For URLs from any of 10 Amazon domains; a product on several lists is one row. They replace the niche search. The live search reads Amazon's pages itself; if Amazon blocks that, it runs a Store Actor on your Apify plan — if your plan cannot run Store Actors, use `list` mode.

## `minStars` (type: `number`):

Free filter: products rated below this are dropped before any AI or charge. A product with no rating yet (typical for New Releases) is kept. 0 = off.

## `minReviews` (type: `integer`):

Free filter: products with fewer reviews are dropped. Raise it to keep only proven demand. 0 = off.

## `maxReviews` (type: `integer`):

Free filter: products with more reviews are dropped — a listing with thousands of reviews is slow to beat. 1,500 is a common ceiling for a new private label. 0 = off.

## `priceMin` (type: `number`):

Free filter in the list's own currency (a product with no price is kept). 0 = off.

## `priceMax` (type: `number`):

Free filter in the list's own currency (a product with no price is kept). 0 = off.

## `maxRank` (type: `integer`):

Free filter: ignore products ranked below this position on their list (the best rank counts when a product is on several lists). 0 = the whole list.

## `excludeBrands` (type: `array`):

Brand names to skip, e.g. <code>apple</code>, <code>anker</code>. A product whose title contains one of them as a whole word is dropped before any AI or charge.

## `onlyNewOrRising` (type: `boolean`):

Free filter for scheduled runs: keep a product only if it is new to this search's memory, climbed since the last run, or is on Movers & Shakers / New Releases.

## `targetFlags` (type: `array`):

Only deliver products that have at least one of these flags, and rank those with more of them higher. Leave empty to keep everything. Use the flag names from the README's flag table, e.g. <code>rising_rank</code>, <code>low_barrier</code> (<code>risingRank</code> works too); an unknown name stops the run at once with the list of valid ones.

## `suppressionList` (type: `array`):

Names, URLs or ids to never output. Suppressed product opportunities are skipped before any processing and never charged.

## `llmProvider` (type: `string`):

<b>Apify (no keys)</b> — the AI runs through Apify's built-in OpenRouter proxy; tokens are billed to your Apify account at OpenRouter's rates. <b>My own key</b> — use your OpenAI / Anthropic / Gemini / Groq key instead; a free-tier key assesses only a few product opportunities per run — expect 1–3 AI checks (2 calls at a time, one after a rate limit, then the 3 borderline product opportunities retried one by one) — and the rest keep their rule score; a paid Groq / Gemini key (billing on) assesses every product opportunity.

## `llmModel` (type: `string`):

Leave empty for the default: <code>anthropic/claude-haiku-4.5</code> on Apify; with your own key, the model of the key's provider (a Gemini key: <code>google:gemini-3.5-flash-lite</code>; Anthropic, OpenAI and Groq keys get their own). Apify mode takes an OpenRouter slug such as <code>openai/gpt-4.1-mini</code>; own-key mode takes <code>provider:model</code>, e.g. <code>anthropic:claude-haiku-4-5-20251001</code>.

## `llmApiKey` (type: `string`):

Required when <b>AI model access</b> is <i>My own API key</i>. Stored encrypted by Apify, never logged.

## `sendAlertsTo` (type: `string`):

Paste one or more URLs, one per line — the service is detected from the address: a Slack or Discord channel webhook, a Teams Workflows or Google Chat space webhook, your Telegram bot's send link (<code>https://api.telegram.org/bot\<token>/sendMessage?chat_id=@yourchannel</code>) or any other https URL (Zapier, Make, n8n, your CRM), which gets the product opportunities as JSON. After every run with at least one new product opportunity, the digest (how many are new, the top 10 with links) is posted there. Never sent for the free demo. Headers, batching and signing: <i>Delivery details (advanced)</i>.

## `dedupeAcrossRuns` (type: `boolean`):

Remembers every product opportunity you were charged for (in a named key-value store on your account) and skips it in future runs.

## `dedupeTtlDays` (type: `integer`):

How long a delivered product opportunity stays remembered. 0 = never deliver or charge it again. A number of days lets a product opportunity that comes back (a seasonal peak, a relisted item) reach you again after that many days — charged again as a new product opportunity.

## `sourceMode` (type: `string`):

<b>actor</b> — read the Amazon list pages with the built-in reader; where Amazon blocks it, run <code>amazon-scraper/amazon-bestsellers-scraper</code> on your account instead (billed separately). <b>dataset</b> — an existing Apify dataset. <b>list</b> — records you paste in. The mode you choose always runs as chosen; only the untouched sample next to a search you typed switches to the live search (spend-capped). <code>{}</code> over the API runs the free demo — nothing charged.

## `ownSource` (type: `boolean`):

On (default): when this Actor reads its source site itself, no second Store Actor runs on your account and no second bill appears — it works on every Apify plan. If the direct read is blocked, or the run needs something only the Store Actor returns, the Store Actor runs as before. Off: always the Store Actor.

## `datasetId` (type: `string`):

Only for <b>dataset</b> mode. Pick the dataset so the Actor is granted read access to it.

## `itemsList` (type: `array`):

Only for <b>list</b> mode. JSON array of rows in the source's shape: <code>title</code> (or <code>name</code>), <code>asin</code>, <code>link</code>, <code>price</code>, <code>stars</code>, <code>reviewsCount</code>, <code>position</code>, <code>categoryUrl</code>. Rows of one ASIN are merged.

## `subcategoryLevel` (type: `integer`):

Affects what you pay: how many subcategory levels the source also scans below each URL. 0 = only the list you gave (up to 50 rows ≈ $0.10 at the source's $0.002 per row); every level multiplies the rows. Always capped by <b>Max source spend</b>.

## `nextPage` (type: `boolean`):

Affects what you pay: on = both pages of each list (up to 100 rows ≈ $0.20 per URL at the source's $0.002 per row), off = ranks 1–50 only. Capped by <b>Max source spend</b>.

## `webhookUrl` (type: `string`):

Qualified product opportunities are POSTed here as JSON (Zapier, Make, n8n, your CRM). For Google Sheets / Slack you can also use Apify's built-in Integrations tab. Stored encrypted — Zapier / Make hook URLs carry their secret in the path.

## `webhookSecret` (type: `string`):

Any random string. Every webhook POST then carries <code>X-Signature: sha256=\<HMAC-SHA256 of the raw body with this secret></code>, so your endpoint can verify it came from this Actor. Stored encrypted by Apify, never logged.

## `dedupeStoreName` (type: `string`):

Key-value store used for cross-run memory. Left at the default, the memory is kept per search (source and search terms): rewording <code>goalDescription</code> keeps it, so a scheduled run never re-delivers what you already have, and another search starts its own list. Running it for several clients on one account, type one name per client.

## `discoveryTimeoutSecs` (type: `integer`):

API only — hidden on the form. How long the source Store Actor may run before its partial results are used. Raise it when the status says the source stopped early.

## `slackWebhookUrl` (type: `string`):

API only — hidden on the form, where <code>sendAlertsTo</code> takes it. Slack incoming-webhook URL for the digest.

## `discordWebhookUrl` (type: `string`):

API only — hidden on the form, where <code>sendAlertsTo</code> takes it. Discord channel webhook URL for the digest.

## `teamsWebhookUrl` (type: `string`):

API only — hidden on the form, where <code>sendAlertsTo</code> takes it. Teams Workflows webhook URL for the digest.

## `googleChatWebhookUrl` (type: `string`):

API only — hidden on the form, where <code>sendAlertsTo</code> takes it. Google Chat space webhook URL for the digest.

## `telegramUrl` (type: `string`):

API only — hidden on the form, where <code>sendAlertsTo</code> takes it. The bot's sendMessage link with its chat_id.

## `aiCandidateMultiplier` (type: `integer`):

API only — hidden on the form. How many of the best rule-scored candidates get the AI pass, as a multiple of <b>Max qualified</b>. Higher = more thorough, slower, more tokens.

## `webhookBatchSize` (type: `integer`):

API only — hidden on the form. 1 = one POST per product opportunity the moment it is ready. Higher = one POST per N product opportunities.

## `maxToProcess` (type: `integer`):

API only — hidden on the form. Upper bound on how many product opportunities are scored in one run (controls run time). Default = 3 × max qualified.

## `discoveryInput` (type: `object`):

API only — hidden on the form. Only for <b>actor</b> mode, optional: extra input passed to the source Actor as-is; it overrides the fields above (e.g. its own <code>urls</code>). Normally leave it empty and use <b>Amazon list or category URLs</b>. The live search runs that Store Actor on your Apify plan — if your plan cannot run Store Actors, paste your own rows in <b>list</b> mode (any plan); <b>dataset</b> only for a dataset you already have.

## `webhookHeaders` (type: `object`):

API only — hidden on the form. Extra HTTP headers for the webhook, e.g. <code>{"Authorization": "Bearer …"}</code>. Stored encrypted by Apify, never logged.

## `discoveryActorId` (type: `string`):

API only — hidden on the form. Actor used in <b>actor</b> mode. Any Actor whose output has the fields listed in the README works.

## `autoSwitchToLive` (type: `boolean`):

API only — hidden on the form. On (default): search terms typed next to the untouched sample records start the live search (spend-capped; <code>OUTPUT.switchedToLive</code> names them). Off: the mode you send is the mode that runs — the sample stays the free demo and the status names the terms it did not search. API pipelines that must never start a paid read on their own: send <code>false</code>.

## `historyDatasetName` (type: `string`):

API only — hidden on the form. Optional. Type a name (e.g. <code>amazon-product-finder-ai-seen-log</code>) and every run appends its new product opportunities with the date to that named dataset on your account — one list across months to connect to Google Sheets or your BI tool once. Empty = off. Costs nothing extra.

## Actor input object example

```json
{
  "marketplace": "amazon.com",
  "preset": "custom",
  "minScore": 50,
  "maxQualified": 100,
  "maxDiscoveryChargeUsd": 0.5,
  "enableAi": true,
  "minStars": 0,
  "minReviews": 0,
  "maxReviews": 0,
  "priceMin": 0,
  "priceMax": 0,
  "maxRank": 0,
  "onlyNewOrRising": false,
  "llmProvider": "apify",
  "dedupeAcrossRuns": true,
  "dedupeTtlDays": 0,
  "sourceMode": "list",
  "ownSource": true,
  "itemsList": [
    {
      "position": 3,
      "asin": "B0DEMO0001",
      "title": "Silicone Stretch Lids Set of 12 - Reusable Food Covers for Bowls, Cups and Cans",
      "link": "https://www.amazon.com/Silicone-Stretch-Lids/dp/B0DEMO0001/ref=zg_mrs_g_kitchen_3?_encoding=UTF8&psc=1",
      "image": "https://m.media-amazon.com/images/I/demo-lids.jpg",
      "price": "$14.99",
      "price2": "$19.99",
      "currency": "USD",
      "stars": 4.5,
      "reviewsCount": 412,
      "category": "Movers & Shakers in Kitchen & Dining",
      "categoryUrl": "https://www.amazon.com/gp/movers-and-shakers/kitchen",
      "parents": [
        {
          "position": 1,
          "name": "Kitchen & Dining",
          "link": "https://www.amazon.com/gp/bestsellers/0"
        },
        {
          "position": 2,
          "name": "Food Storage Covers",
          "link": "https://www.amazon.com/gp/bestsellers/1"
        }
      ],
      "status": 200,
      "isNew": false,
      "rankChange": 14,
      "firstSeenAt": "2026-09-27T08:00:00+00:00"
    },
    {
      "position": 18,
      "asin": "B0DEMO0001",
      "title": "Silicone Stretch Lids Set of 12 - Reusable Food Covers for Bowls, Cups and Cans",
      "link": "https://www.amazon.com/Silicone-Stretch-Lids/dp/B0DEMO0001/ref=zg_bs_g_kitchen_18",
      "image": "https://m.media-amazon.com/images/I/demo-lids.jpg",
      "price": "$14.99",
      "price2": "$19.99",
      "currency": "USD",
      "stars": 4.5,
      "reviewsCount": 412,
      "category": "Best Sellers in Kitchen & Dining",
      "categoryUrl": "https://www.amazon.com/gp/bestsellers/kitchen",
      "parents": [
        {
          "position": 1,
          "name": "Kitchen & Dining",
          "link": "https://www.amazon.com/gp/bestsellers/0"
        },
        {
          "position": 2,
          "name": "Food Storage Covers",
          "link": "https://www.amazon.com/gp/bestsellers/1"
        }
      ],
      "status": 200
    },
    {
      "position": 2,
      "asin": "B0DEMO0003",
      "title": "Apple AirPods Pro 2 Wireless Earbuds with USB-C Charging Case, Active Noise Cancellation",
      "link": "https://www.amazon.com/Apple-AirPods-Pro-2/dp/B0DEMO0003/ref=zg_bs_g_electronics_2",
      "image": "https://m.media-amazon.com/images/I/demo-earbuds.jpg",
      "price": "$189.99",
      "currency": "USD",
      "stars": 4.7,
      "reviewsCount": 98214,
      "category": "Best Sellers in Electronics",
      "categoryUrl": "https://www.amazon.com/gp/bestsellers/electronics",
      "parents": [
        {
          "position": 1,
          "name": "Electronics",
          "link": "https://www.amazon.com/gp/bestsellers/0"
        },
        {
          "position": 2,
          "name": "Headphones",
          "link": "https://www.amazon.com/gp/bestsellers/1"
        }
      ],
      "status": 200
    },
    {
      "position": 7,
      "asin": "B0DEMO0004",
      "title": "Collapsible Silicone Dog Travel Bowl with Carabiner, 2 Pack, Foldable Pet Water Dish",
      "link": "https://www.amazon.com/Collapsible-Dog-Bowl/dp/B0DEMO0004/ref=zg_bsnr_g_pet_7",
      "image": "https://m.media-amazon.com/images/I/demo-bowl.jpg",
      "price": "$11.95",
      "currency": "USD",
      "stars": 4.3,
      "reviewsCount": 38,
      "category": "New Releases in Pet Supplies",
      "categoryUrl": "https://www.amazon.com/gp/new-releases/pet-supplies",
      "parents": [
        {
          "position": 1,
          "name": "Pet Supplies",
          "link": "https://www.amazon.com/gp/bestsellers/0"
        },
        {
          "position": 2,
          "name": "Dogs",
          "link": "https://www.amazon.com/gp/bestsellers/1"
        },
        {
          "position": 3,
          "name": "Feeding & Watering",
          "link": "https://www.amazon.com/gp/bestsellers/2"
        }
      ],
      "status": 200
    },
    {
      "position": 5,
      "asin": "B0DEMO0005",
      "title": "Bambus Schneidebrett Set 3-teilig mit Saftrille und Griff, Küchenbrett aus Holz",
      "link": "https://www.amazon.de/Bambus-Schneidebrett-Set/dp/B0DEMO0005/ref=zg_bs_g_kitchen_5",
      "image": "https://m.media-amazon.com/images/I/demo-board.jpg",
      "price": "24,95 €",
      "currency": "EUR",
      "stars": 4.4,
      "reviewsCount": 1280,
      "category": "Bestseller in Küche, Haushalt & Wohnen",
      "categoryUrl": "https://www.amazon.de/gp/bestsellers/kitchen",
      "parents": [
        {
          "position": 1,
          "name": "Küche, Haushalt & Wohnen",
          "link": "https://www.amazon.com/gp/bestsellers/0"
        },
        {
          "position": 2,
          "name": "Schneidebretter",
          "link": "https://www.amazon.com/gp/bestsellers/1"
        }
      ],
      "status": 200
    },
    {
      "position": 11,
      "asin": "B0DEMO0006",
      "title": "Melatonin Gummies 10mg, 120 Count Sleep Support Supplement, Berry Flavor",
      "link": "https://www.amazon.com/Melatonin-Gummies/dp/B0DEMO0006/ref=zg_bs_g_hpc_11",
      "image": "https://m.media-amazon.com/images/I/demo-gummies.jpg",
      "price": "$9.99",
      "currency": "USD",
      "stars": 4.6,
      "reviewsCount": 52310,
      "category": "Best Sellers in Health & Household",
      "categoryUrl": "https://www.amazon.com/gp/bestsellers/hpc",
      "parents": [
        {
          "position": 1,
          "name": "Health & Household",
          "link": "https://www.amazon.com/gp/bestsellers/0"
        },
        {
          "position": 2,
          "name": "Sleep Aids",
          "link": "https://www.amazon.com/gp/bestsellers/1"
        }
      ],
      "status": 200
    },
    {
      "position": 22,
      "asin": "B0DEMO0007",
      "title": "Foldable Laundry Basket with Handles, 65L Collapsible Hamper for Bedroom",
      "link": "https://www.amazon.com/Foldable-Laundry-Basket/dp/B0DEMO0007/ref=zg_bsnr_g_home_22",
      "image": "https://m.media-amazon.com/images/I/demo-basket.jpg",
      "currency": "USD",
      "stars": 4.1,
      "reviewsCount": 210,
      "category": "New Releases in Home & Kitchen",
      "categoryUrl": "https://www.amazon.com/gp/new-releases/home-garden",
      "parents": [
        {
          "position": 1,
          "name": "Home & Kitchen",
          "link": "https://www.amazon.com/gp/bestsellers/0"
        },
        {
          "position": 2,
          "name": "Laundry Baskets",
          "link": "https://www.amazon.com/gp/bestsellers/1"
        }
      ],
      "status": 200
    }
  ],
  "subcategoryLevel": 0,
  "nextPage": false,
  "dedupeStoreName": "amazon-product-finder-ai-seen",
  "discoveryTimeoutSecs": 3600,
  "aiCandidateMultiplier": 2,
  "webhookBatchSize": 1,
  "discoveryInput": {},
  "discoveryActorId": "amazon-scraper/amazon-bestsellers-scraper",
  "autoSwitchToLive": true,
  "historyDatasetName": ""
}
```

# Actor output Schema

## `qualified` (type: `string`):

All qualified product opportunities as JSON, best-scoring first.

## `sheet` (type: `string`):

The same product opportunities as a spreadsheet.

## `runSummary` (type: `string`):

JSON record with the funnel (loaded -> filtered -> AI-assessed -> qualified), per-reason skip counts, charged events by type, free-tier product opportunities used and remaining, whether a budget limit was reached, webhook delivery counts and the dedupe store size.

# 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 = {
    "maxDiscoveryChargeUsd": 0.5,
    "sourceMode": "list",
    "itemsList": [
        {
            "position": 3,
            "asin": "B0DEMO0001",
            "title": "Silicone Stretch Lids Set of 12 - Reusable Food Covers for Bowls, Cups and Cans",
            "link": "https://www.amazon.com/Silicone-Stretch-Lids/dp/B0DEMO0001/ref=zg_mrs_g_kitchen_3?_encoding=UTF8&psc=1",
            "image": "https://m.media-amazon.com/images/I/demo-lids.jpg",
            "price": "$14.99",
            "price2": "$19.99",
            "currency": "USD",
            "stars": 4.5,
            "reviewsCount": 412,
            "category": "Movers & Shakers in Kitchen & Dining",
            "categoryUrl": "https://www.amazon.com/gp/movers-and-shakers/kitchen",
            "parents": [
                {
                    "position": 1,
                    "name": "Kitchen & Dining",
                    "link": "https://www.amazon.com/gp/bestsellers/0"
                },
                {
                    "position": 2,
                    "name": "Food Storage Covers",
                    "link": "https://www.amazon.com/gp/bestsellers/1"
                }
            ],
            "status": 200,
            "isNew": false,
            "rankChange": 14,
            "firstSeenAt": "2026-09-27T08:00:00+00:00"
        },
        {
            "position": 18,
            "asin": "B0DEMO0001",
            "title": "Silicone Stretch Lids Set of 12 - Reusable Food Covers for Bowls, Cups and Cans",
            "link": "https://www.amazon.com/Silicone-Stretch-Lids/dp/B0DEMO0001/ref=zg_bs_g_kitchen_18",
            "image": "https://m.media-amazon.com/images/I/demo-lids.jpg",
            "price": "$14.99",
            "price2": "$19.99",
            "currency": "USD",
            "stars": 4.5,
            "reviewsCount": 412,
            "category": "Best Sellers in Kitchen & Dining",
            "categoryUrl": "https://www.amazon.com/gp/bestsellers/kitchen",
            "parents": [
                {
                    "position": 1,
                    "name": "Kitchen & Dining",
                    "link": "https://www.amazon.com/gp/bestsellers/0"
                },
                {
                    "position": 2,
                    "name": "Food Storage Covers",
                    "link": "https://www.amazon.com/gp/bestsellers/1"
                }
            ],
            "status": 200
        },
        {
            "position": 2,
            "asin": "B0DEMO0003",
            "title": "Apple AirPods Pro 2 Wireless Earbuds with USB-C Charging Case, Active Noise Cancellation",
            "link": "https://www.amazon.com/Apple-AirPods-Pro-2/dp/B0DEMO0003/ref=zg_bs_g_electronics_2",
            "image": "https://m.media-amazon.com/images/I/demo-earbuds.jpg",
            "price": "$189.99",
            "currency": "USD",
            "stars": 4.7,
            "reviewsCount": 98214,
            "category": "Best Sellers in Electronics",
            "categoryUrl": "https://www.amazon.com/gp/bestsellers/electronics",
            "parents": [
                {
                    "position": 1,
                    "name": "Electronics",
                    "link": "https://www.amazon.com/gp/bestsellers/0"
                },
                {
                    "position": 2,
                    "name": "Headphones",
                    "link": "https://www.amazon.com/gp/bestsellers/1"
                }
            ],
            "status": 200
        },
        {
            "position": 7,
            "asin": "B0DEMO0004",
            "title": "Collapsible Silicone Dog Travel Bowl with Carabiner, 2 Pack, Foldable Pet Water Dish",
            "link": "https://www.amazon.com/Collapsible-Dog-Bowl/dp/B0DEMO0004/ref=zg_bsnr_g_pet_7",
            "image": "https://m.media-amazon.com/images/I/demo-bowl.jpg",
            "price": "$11.95",
            "currency": "USD",
            "stars": 4.3,
            "reviewsCount": 38,
            "category": "New Releases in Pet Supplies",
            "categoryUrl": "https://www.amazon.com/gp/new-releases/pet-supplies",
            "parents": [
                {
                    "position": 1,
                    "name": "Pet Supplies",
                    "link": "https://www.amazon.com/gp/bestsellers/0"
                },
                {
                    "position": 2,
                    "name": "Dogs",
                    "link": "https://www.amazon.com/gp/bestsellers/1"
                },
                {
                    "position": 3,
                    "name": "Feeding & Watering",
                    "link": "https://www.amazon.com/gp/bestsellers/2"
                }
            ],
            "status": 200
        },
        {
            "position": 5,
            "asin": "B0DEMO0005",
            "title": "Bambus Schneidebrett Set 3-teilig mit Saftrille und Griff, Küchenbrett aus Holz",
            "link": "https://www.amazon.de/Bambus-Schneidebrett-Set/dp/B0DEMO0005/ref=zg_bs_g_kitchen_5",
            "image": "https://m.media-amazon.com/images/I/demo-board.jpg",
            "price": "24,95 €",
            "currency": "EUR",
            "stars": 4.4,
            "reviewsCount": 1280,
            "category": "Bestseller in Küche, Haushalt & Wohnen",
            "categoryUrl": "https://www.amazon.de/gp/bestsellers/kitchen",
            "parents": [
                {
                    "position": 1,
                    "name": "Küche, Haushalt & Wohnen",
                    "link": "https://www.amazon.com/gp/bestsellers/0"
                },
                {
                    "position": 2,
                    "name": "Schneidebretter",
                    "link": "https://www.amazon.com/gp/bestsellers/1"
                }
            ],
            "status": 200
        },
        {
            "position": 11,
            "asin": "B0DEMO0006",
            "title": "Melatonin Gummies 10mg, 120 Count Sleep Support Supplement, Berry Flavor",
            "link": "https://www.amazon.com/Melatonin-Gummies/dp/B0DEMO0006/ref=zg_bs_g_hpc_11",
            "image": "https://m.media-amazon.com/images/I/demo-gummies.jpg",
            "price": "$9.99",
            "currency": "USD",
            "stars": 4.6,
            "reviewsCount": 52310,
            "category": "Best Sellers in Health & Household",
            "categoryUrl": "https://www.amazon.com/gp/bestsellers/hpc",
            "parents": [
                {
                    "position": 1,
                    "name": "Health & Household",
                    "link": "https://www.amazon.com/gp/bestsellers/0"
                },
                {
                    "position": 2,
                    "name": "Sleep Aids",
                    "link": "https://www.amazon.com/gp/bestsellers/1"
                }
            ],
            "status": 200
        },
        {
            "position": 22,
            "asin": "B0DEMO0007",
            "title": "Foldable Laundry Basket with Handles, 65L Collapsible Hamper for Bedroom",
            "link": "https://www.amazon.com/Foldable-Laundry-Basket/dp/B0DEMO0007/ref=zg_bsnr_g_home_22",
            "image": "https://m.media-amazon.com/images/I/demo-basket.jpg",
            "currency": "USD",
            "stars": 4.1,
            "reviewsCount": 210,
            "category": "New Releases in Home & Kitchen",
            "categoryUrl": "https://www.amazon.com/gp/new-releases/home-garden",
            "parents": [
                {
                    "position": 1,
                    "name": "Home & Kitchen",
                    "link": "https://www.amazon.com/gp/bestsellers/0"
                },
                {
                    "position": 2,
                    "name": "Laundry Baskets",
                    "link": "https://www.amazon.com/gp/bestsellers/1"
                }
            ],
            "status": 200
        }
    ],
    "discoveryInput": {}
};

// Run the Actor and wait for it to finish
const run = await client.actor("rich_minds/amazon-product-finder-ai").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 = {
    "maxDiscoveryChargeUsd": 0.5,
    "sourceMode": "list",
    "itemsList": [
        {
            "position": 3,
            "asin": "B0DEMO0001",
            "title": "Silicone Stretch Lids Set of 12 - Reusable Food Covers for Bowls, Cups and Cans",
            "link": "https://www.amazon.com/Silicone-Stretch-Lids/dp/B0DEMO0001/ref=zg_mrs_g_kitchen_3?_encoding=UTF8&psc=1",
            "image": "https://m.media-amazon.com/images/I/demo-lids.jpg",
            "price": "$14.99",
            "price2": "$19.99",
            "currency": "USD",
            "stars": 4.5,
            "reviewsCount": 412,
            "category": "Movers & Shakers in Kitchen & Dining",
            "categoryUrl": "https://www.amazon.com/gp/movers-and-shakers/kitchen",
            "parents": [
                {
                    "position": 1,
                    "name": "Kitchen & Dining",
                    "link": "https://www.amazon.com/gp/bestsellers/0",
                },
                {
                    "position": 2,
                    "name": "Food Storage Covers",
                    "link": "https://www.amazon.com/gp/bestsellers/1",
                },
            ],
            "status": 200,
            "isNew": False,
            "rankChange": 14,
            "firstSeenAt": "2026-09-27T08:00:00+00:00",
        },
        {
            "position": 18,
            "asin": "B0DEMO0001",
            "title": "Silicone Stretch Lids Set of 12 - Reusable Food Covers for Bowls, Cups and Cans",
            "link": "https://www.amazon.com/Silicone-Stretch-Lids/dp/B0DEMO0001/ref=zg_bs_g_kitchen_18",
            "image": "https://m.media-amazon.com/images/I/demo-lids.jpg",
            "price": "$14.99",
            "price2": "$19.99",
            "currency": "USD",
            "stars": 4.5,
            "reviewsCount": 412,
            "category": "Best Sellers in Kitchen & Dining",
            "categoryUrl": "https://www.amazon.com/gp/bestsellers/kitchen",
            "parents": [
                {
                    "position": 1,
                    "name": "Kitchen & Dining",
                    "link": "https://www.amazon.com/gp/bestsellers/0",
                },
                {
                    "position": 2,
                    "name": "Food Storage Covers",
                    "link": "https://www.amazon.com/gp/bestsellers/1",
                },
            ],
            "status": 200,
        },
        {
            "position": 2,
            "asin": "B0DEMO0003",
            "title": "Apple AirPods Pro 2 Wireless Earbuds with USB-C Charging Case, Active Noise Cancellation",
            "link": "https://www.amazon.com/Apple-AirPods-Pro-2/dp/B0DEMO0003/ref=zg_bs_g_electronics_2",
            "image": "https://m.media-amazon.com/images/I/demo-earbuds.jpg",
            "price": "$189.99",
            "currency": "USD",
            "stars": 4.7,
            "reviewsCount": 98214,
            "category": "Best Sellers in Electronics",
            "categoryUrl": "https://www.amazon.com/gp/bestsellers/electronics",
            "parents": [
                {
                    "position": 1,
                    "name": "Electronics",
                    "link": "https://www.amazon.com/gp/bestsellers/0",
                },
                {
                    "position": 2,
                    "name": "Headphones",
                    "link": "https://www.amazon.com/gp/bestsellers/1",
                },
            ],
            "status": 200,
        },
        {
            "position": 7,
            "asin": "B0DEMO0004",
            "title": "Collapsible Silicone Dog Travel Bowl with Carabiner, 2 Pack, Foldable Pet Water Dish",
            "link": "https://www.amazon.com/Collapsible-Dog-Bowl/dp/B0DEMO0004/ref=zg_bsnr_g_pet_7",
            "image": "https://m.media-amazon.com/images/I/demo-bowl.jpg",
            "price": "$11.95",
            "currency": "USD",
            "stars": 4.3,
            "reviewsCount": 38,
            "category": "New Releases in Pet Supplies",
            "categoryUrl": "https://www.amazon.com/gp/new-releases/pet-supplies",
            "parents": [
                {
                    "position": 1,
                    "name": "Pet Supplies",
                    "link": "https://www.amazon.com/gp/bestsellers/0",
                },
                {
                    "position": 2,
                    "name": "Dogs",
                    "link": "https://www.amazon.com/gp/bestsellers/1",
                },
                {
                    "position": 3,
                    "name": "Feeding & Watering",
                    "link": "https://www.amazon.com/gp/bestsellers/2",
                },
            ],
            "status": 200,
        },
        {
            "position": 5,
            "asin": "B0DEMO0005",
            "title": "Bambus Schneidebrett Set 3-teilig mit Saftrille und Griff, Küchenbrett aus Holz",
            "link": "https://www.amazon.de/Bambus-Schneidebrett-Set/dp/B0DEMO0005/ref=zg_bs_g_kitchen_5",
            "image": "https://m.media-amazon.com/images/I/demo-board.jpg",
            "price": "24,95 €",
            "currency": "EUR",
            "stars": 4.4,
            "reviewsCount": 1280,
            "category": "Bestseller in Küche, Haushalt & Wohnen",
            "categoryUrl": "https://www.amazon.de/gp/bestsellers/kitchen",
            "parents": [
                {
                    "position": 1,
                    "name": "Küche, Haushalt & Wohnen",
                    "link": "https://www.amazon.com/gp/bestsellers/0",
                },
                {
                    "position": 2,
                    "name": "Schneidebretter",
                    "link": "https://www.amazon.com/gp/bestsellers/1",
                },
            ],
            "status": 200,
        },
        {
            "position": 11,
            "asin": "B0DEMO0006",
            "title": "Melatonin Gummies 10mg, 120 Count Sleep Support Supplement, Berry Flavor",
            "link": "https://www.amazon.com/Melatonin-Gummies/dp/B0DEMO0006/ref=zg_bs_g_hpc_11",
            "image": "https://m.media-amazon.com/images/I/demo-gummies.jpg",
            "price": "$9.99",
            "currency": "USD",
            "stars": 4.6,
            "reviewsCount": 52310,
            "category": "Best Sellers in Health & Household",
            "categoryUrl": "https://www.amazon.com/gp/bestsellers/hpc",
            "parents": [
                {
                    "position": 1,
                    "name": "Health & Household",
                    "link": "https://www.amazon.com/gp/bestsellers/0",
                },
                {
                    "position": 2,
                    "name": "Sleep Aids",
                    "link": "https://www.amazon.com/gp/bestsellers/1",
                },
            ],
            "status": 200,
        },
        {
            "position": 22,
            "asin": "B0DEMO0007",
            "title": "Foldable Laundry Basket with Handles, 65L Collapsible Hamper for Bedroom",
            "link": "https://www.amazon.com/Foldable-Laundry-Basket/dp/B0DEMO0007/ref=zg_bsnr_g_home_22",
            "image": "https://m.media-amazon.com/images/I/demo-basket.jpg",
            "currency": "USD",
            "stars": 4.1,
            "reviewsCount": 210,
            "category": "New Releases in Home & Kitchen",
            "categoryUrl": "https://www.amazon.com/gp/new-releases/home-garden",
            "parents": [
                {
                    "position": 1,
                    "name": "Home & Kitchen",
                    "link": "https://www.amazon.com/gp/bestsellers/0",
                },
                {
                    "position": 2,
                    "name": "Laundry Baskets",
                    "link": "https://www.amazon.com/gp/bestsellers/1",
                },
            ],
            "status": 200,
        },
    ],
    "discoveryInput": {},
}

# Run the Actor and wait for it to finish
run = client.actor("rich_minds/amazon-product-finder-ai").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 '{
  "maxDiscoveryChargeUsd": 0.5,
  "sourceMode": "list",
  "itemsList": [
    {
      "position": 3,
      "asin": "B0DEMO0001",
      "title": "Silicone Stretch Lids Set of 12 - Reusable Food Covers for Bowls, Cups and Cans",
      "link": "https://www.amazon.com/Silicone-Stretch-Lids/dp/B0DEMO0001/ref=zg_mrs_g_kitchen_3?_encoding=UTF8&psc=1",
      "image": "https://m.media-amazon.com/images/I/demo-lids.jpg",
      "price": "$14.99",
      "price2": "$19.99",
      "currency": "USD",
      "stars": 4.5,
      "reviewsCount": 412,
      "category": "Movers & Shakers in Kitchen & Dining",
      "categoryUrl": "https://www.amazon.com/gp/movers-and-shakers/kitchen",
      "parents": [
        {
          "position": 1,
          "name": "Kitchen & Dining",
          "link": "https://www.amazon.com/gp/bestsellers/0"
        },
        {
          "position": 2,
          "name": "Food Storage Covers",
          "link": "https://www.amazon.com/gp/bestsellers/1"
        }
      ],
      "status": 200,
      "isNew": false,
      "rankChange": 14,
      "firstSeenAt": "2026-09-27T08:00:00+00:00"
    },
    {
      "position": 18,
      "asin": "B0DEMO0001",
      "title": "Silicone Stretch Lids Set of 12 - Reusable Food Covers for Bowls, Cups and Cans",
      "link": "https://www.amazon.com/Silicone-Stretch-Lids/dp/B0DEMO0001/ref=zg_bs_g_kitchen_18",
      "image": "https://m.media-amazon.com/images/I/demo-lids.jpg",
      "price": "$14.99",
      "price2": "$19.99",
      "currency": "USD",
      "stars": 4.5,
      "reviewsCount": 412,
      "category": "Best Sellers in Kitchen & Dining",
      "categoryUrl": "https://www.amazon.com/gp/bestsellers/kitchen",
      "parents": [
        {
          "position": 1,
          "name": "Kitchen & Dining",
          "link": "https://www.amazon.com/gp/bestsellers/0"
        },
        {
          "position": 2,
          "name": "Food Storage Covers",
          "link": "https://www.amazon.com/gp/bestsellers/1"
        }
      ],
      "status": 200
    },
    {
      "position": 2,
      "asin": "B0DEMO0003",
      "title": "Apple AirPods Pro 2 Wireless Earbuds with USB-C Charging Case, Active Noise Cancellation",
      "link": "https://www.amazon.com/Apple-AirPods-Pro-2/dp/B0DEMO0003/ref=zg_bs_g_electronics_2",
      "image": "https://m.media-amazon.com/images/I/demo-earbuds.jpg",
      "price": "$189.99",
      "currency": "USD",
      "stars": 4.7,
      "reviewsCount": 98214,
      "category": "Best Sellers in Electronics",
      "categoryUrl": "https://www.amazon.com/gp/bestsellers/electronics",
      "parents": [
        {
          "position": 1,
          "name": "Electronics",
          "link": "https://www.amazon.com/gp/bestsellers/0"
        },
        {
          "position": 2,
          "name": "Headphones",
          "link": "https://www.amazon.com/gp/bestsellers/1"
        }
      ],
      "status": 200
    },
    {
      "position": 7,
      "asin": "B0DEMO0004",
      "title": "Collapsible Silicone Dog Travel Bowl with Carabiner, 2 Pack, Foldable Pet Water Dish",
      "link": "https://www.amazon.com/Collapsible-Dog-Bowl/dp/B0DEMO0004/ref=zg_bsnr_g_pet_7",
      "image": "https://m.media-amazon.com/images/I/demo-bowl.jpg",
      "price": "$11.95",
      "currency": "USD",
      "stars": 4.3,
      "reviewsCount": 38,
      "category": "New Releases in Pet Supplies",
      "categoryUrl": "https://www.amazon.com/gp/new-releases/pet-supplies",
      "parents": [
        {
          "position": 1,
          "name": "Pet Supplies",
          "link": "https://www.amazon.com/gp/bestsellers/0"
        },
        {
          "position": 2,
          "name": "Dogs",
          "link": "https://www.amazon.com/gp/bestsellers/1"
        },
        {
          "position": 3,
          "name": "Feeding & Watering",
          "link": "https://www.amazon.com/gp/bestsellers/2"
        }
      ],
      "status": 200
    },
    {
      "position": 5,
      "asin": "B0DEMO0005",
      "title": "Bambus Schneidebrett Set 3-teilig mit Saftrille und Griff, Küchenbrett aus Holz",
      "link": "https://www.amazon.de/Bambus-Schneidebrett-Set/dp/B0DEMO0005/ref=zg_bs_g_kitchen_5",
      "image": "https://m.media-amazon.com/images/I/demo-board.jpg",
      "price": "24,95 €",
      "currency": "EUR",
      "stars": 4.4,
      "reviewsCount": 1280,
      "category": "Bestseller in Küche, Haushalt & Wohnen",
      "categoryUrl": "https://www.amazon.de/gp/bestsellers/kitchen",
      "parents": [
        {
          "position": 1,
          "name": "Küche, Haushalt & Wohnen",
          "link": "https://www.amazon.com/gp/bestsellers/0"
        },
        {
          "position": 2,
          "name": "Schneidebretter",
          "link": "https://www.amazon.com/gp/bestsellers/1"
        }
      ],
      "status": 200
    },
    {
      "position": 11,
      "asin": "B0DEMO0006",
      "title": "Melatonin Gummies 10mg, 120 Count Sleep Support Supplement, Berry Flavor",
      "link": "https://www.amazon.com/Melatonin-Gummies/dp/B0DEMO0006/ref=zg_bs_g_hpc_11",
      "image": "https://m.media-amazon.com/images/I/demo-gummies.jpg",
      "price": "$9.99",
      "currency": "USD",
      "stars": 4.6,
      "reviewsCount": 52310,
      "category": "Best Sellers in Health & Household",
      "categoryUrl": "https://www.amazon.com/gp/bestsellers/hpc",
      "parents": [
        {
          "position": 1,
          "name": "Health & Household",
          "link": "https://www.amazon.com/gp/bestsellers/0"
        },
        {
          "position": 2,
          "name": "Sleep Aids",
          "link": "https://www.amazon.com/gp/bestsellers/1"
        }
      ],
      "status": 200
    },
    {
      "position": 22,
      "asin": "B0DEMO0007",
      "title": "Foldable Laundry Basket with Handles, 65L Collapsible Hamper for Bedroom",
      "link": "https://www.amazon.com/Foldable-Laundry-Basket/dp/B0DEMO0007/ref=zg_bsnr_g_home_22",
      "image": "https://m.media-amazon.com/images/I/demo-basket.jpg",
      "currency": "USD",
      "stars": 4.1,
      "reviewsCount": 210,
      "category": "New Releases in Home & Kitchen",
      "categoryUrl": "https://www.amazon.com/gp/new-releases/home-garden",
      "parents": [
        {
          "position": 1,
          "name": "Home & Kitchen",
          "link": "https://www.amazon.com/gp/bestsellers/0"
        },
        {
          "position": 2,
          "name": "Laundry Baskets",
          "link": "https://www.amazon.com/gp/bestsellers/1"
        }
      ],
      "status": 200
    }
  ],
  "discoveryInput": {}
}' |
apify call rich_minds/amazon-product-finder-ai --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,rich_minds/amazon-product-finder-ai"
        }
    }
}
```

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/FDxTZmKYtrNL6BeWp/builds/BAU22l5Glf3q2RGcJ/openapi.json
