# Amazon Search Scraper | Products, Prices & Rankings (`genial_candlestand/amazon-search-scraper`) Actor

Get amazon.com search and category results: ASIN, title, price, list price, rating, ratings count, bought past month, Prime, stock, sponsored flag and organic position. Many keywords, category IDs or URLs per run, sort and price filters, categories up to 400 pages. No login.

- **URL**: https://apify.com/genial_candlestand/amazon-search-scraper.md
- **Developed by:** [Flowo](https://apify.com/genial_candlestand) (community)
- **Categories:** E-commerce, Automation
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.13 / 1,000 products

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

## Amazon Search Scraper | Products, Prices & Rankings

![Amazon Search Scraper | Products, Prices & Rankings](https://api.apify.com/v2/key-value-stores/Ll7RrWtDkZYOrBvfE/records/amazon-com-product-search-category-listings-banner-d2bbe9b5.png)

Get one row per product card from amazon.com keyword searches and category listings. Each row has the ASIN, title, price, list price and discount, star rating, ratings count, "bought in past month", Prime and stock state, the sponsored flag, badges, and the exact position of the card in the results (overall, organic only and on its page). It covers the US store only, with prices in USD, and needs no login.

### What does Amazon Search Scraper do?

You give it search keywords, amazon.com category (browse node) IDs or pasted amazon.com search and category URLs. It reads the result pages one after another and saves every product card as a flat row. Product pages are not opened, so each row holds what the listing card shows. It is built for sellers and agencies tracking keyword ranks and ads, product researchers exporting whole categories, price-monitoring pipelines and AI agents that need "top Amazon products for X" with prices and ratings.

### How to scrape Amazon search results and categories

![Amazon Search Scraper output example: Image, Title, Price (USD), List price, Rating, Ratings](https://api.apify.com/v2/key-value-stores/Ll7RrWtDkZYOrBvfE/records/amazon-com-product-search-category-listings-output-c882ce86.png)

![How Amazon Search Scraper works: Requests amazon.com search or category result pages over plain HTTP; Reads pages one by one until no next page, maxPages or maxItems; Retries a blocked page with a new](https://api.apify.com/v2/key-value-stores/Ll7RrWtDkZYOrBvfE/records/amazon-com-product-search-category-listings-how-406fdb72.png)

1. Open the actor in Apify Console.
2. Type one or more **Search keywords** (one per line), add **Category IDs** such as `172541` (Headphones), or paste **Start URLs** from amazon.com. You can combine all three in one run.
3. Optionally choose a **Department**, **Sort by**, **Min/Max price**, **Prime only** or **4 stars & up**.
4. Set **Max pages per search** and **Max products** for the whole run.
5. Keep the default US residential proxy and click **Start**.
6. Download the results as JSON, CSV or Excel, or read them through the API.

### How much does it cost to scrape Amazon search results?

Price per event by Apify plan:

| Event | Free | Bronze | Silver | Gold and above |
|---|---|---|---|---|
| Actor start | $0.00005 | $0.00005 | $0.00005 | $0.00005 |
| Product | $2.50 per 1,000 | $2.375 per 1,000 | $2.25 per 1,000 | $2.125 per 1,000 |

A test run with the API example input below returned 30 rows in 7 s.

You pay for each product row saved to the dataset (the `product` event) plus a tiny start fee per run. These are not charged: duplicate cards (the same ASIN again on a later page of the same search), sponsored cards dropped by **Include sponsored products** = off, empty or blocked pages and runs that fail on invalid input.

| Scenario | Products (events) | Cost on the Free plan |
|---|---|---|
| Quick check: 1 keyword, `maxItems` 30 | 30 | about $0.08 |
| Daily rank tracking: 1 keyword, 3 pages, `maxItems` 200 | 200 | about $0.50 |
| Category export: Headphones, 100 pages, `maxItems` 2,400 | 2,400 | about $6.00 |
| Large export: several categories, `maxItems` 10,000 | 10,000 | about $25.00 |

The start fee ($0.00005 per run at the default 256 MB) is included in these numbers.

### Input

![Amazon Search Scraper input example: Search keywords, Sort by, Prime only, 4 stars & up, Include sponsored products, Max pages per search, Max products](https://api.apify.com/v2/key-value-stores/Ll7RrWtDkZYOrBvfE/records/amazon-com-product-search-category-listings-input-4c96ad76.png)

At least one of **Search keywords** (`queries`), **Category IDs** (`categoryIds`) or **Start URLs** (`startUrls`) is needed; an empty input stops with an input error.

| Field | What it does |
|---|---|
| `queries` | Keywords, one search per line, e.g. `wireless earbuds`. Amazon ends a keyword search after 7–20 pages (about 300 products). |
| `categoryIds` | Browse node IDs, digits only, e.g. `172541` (the number after `node=` in a `/b?node=` URL). A category lists up to 400 pages (~9,600 products). |
| `startUrls` | amazon.com search URLs (`/s?k=…`) or category URLs (`/b?node=…`, `/s?rh=n:…`). The URL's own filters and sort are kept. Only www.amazon.com; product pages (`/dp/`) and other pages are rejected. |
| `department` | Search keywords inside one of 17 departments, e.g. Electronics, Home & Kitchen, Books, Pet Supplies. Keywords only. |
| `sort` | Featured (relevance, default), Price: low to high, Price: high to low, Avg. customer review, Newest arrivals or Best sellers. Works for keywords, categories and URLs; Featured keeps a URL's own sort. |
| `minPrice`, `maxPrice` | Price range in whole US dollars. Works for keywords, categories and URLs. Min must not be above max. |
| `primeOnly`, `fourStarsAndUp` | Prime-eligible only / rated 4 stars and up. Keywords only; ignored with a warning for categories and URLs. |
| `includeSponsored` | On by default. Off drops ad cards (free); positions still count the ads. |
| `maxPages` | Pages read per keyword, category or URL, 1–400, default 20. |
| `maxItems` | Products in total for the run, default 100. |
| `proxyConfiguration` | US residential by default (recommended). |

Example input:

```json
{
  "queries": ["coffee maker"],
  "department": "kitchen",
  "sort": "price-asc-rank",
  "minPrice": 20,
  "maxPrice": 50,
  "maxPages": 3,
  "maxItems": 100
}
```

### What data can you extract from Amazon search results?

| Field | Meaning |
|---|---|
| `asin`, `title`, `brand`, `url`, `imageUrl` | Product ID, card title, brand line (grid layouts only), `https://www.amazon.com/dp/<ASIN>` link, main image |
| `price`, `listPrice`, `discountPercent`, `currency`, `unitPrice` | Current price and struck-through list price in USD, whole-percent discount, `USD`, price per unit as shown (e.g. `$11.50/count`) |
| `rating`, `reviewsCount` | Average stars (1–5) and number of ratings |
| `boughtPastMonth`, `boughtPastMonthText` | Lower bound of "N+ bought in past month" as a number (`1K+` = 1000) and the text as shown |
| `isSponsored`, `isPrime`, `inStock`, `stockText` | Ad flag, Prime delivery, stock state and the stock note of the card |
| `isAmazonChoice`, `isBestSeller`, `badge`, `coupon` | Amazon's Choice / Overall Pick, Best Seller, badge text, coupon text |
| `delivery`, `otherOffers` | Delivery text and "More Buying Choices" text |
| `position`, `organicPosition`, `pagePosition`, `page` | Slot in the whole search (ads included), rank among organic cards only, slot on its page, page number |
| `query`, `categoryId`, `startUrl`, `listingUrl`, `resultsText` | Which search the row came from, the page that was read and its results bar |
| `scrapedAt` | When the row was extracted |

Real example row (keyword `wireless earbuds`, shortened title):

```json
{
  "asin": "B0H8NFRF3S",
  "title": "Wireless Earbuds, 2026 Bluetooth 5.4 Headphones Bass Stereo Ear Buds with Noise Cancelling Mic, ...",
  "brand": null,
  "url": "https://www.amazon.com/dp/B0H8NFRF3S",
  "imageUrl": "https://m.media-amazon.com/images/I/61rw2e+AtUL._AC_UY218_.jpg",
  "price": 19.97,
  "listPrice": 199.99,
  "discountPercent": 90,
  "currency": "USD",
  "unitPrice": null,
  "rating": 4.9,
  "reviewsCount": 677,
  "boughtPastMonth": 1000,
  "boughtPastMonthText": "1K+ bought in past month",
  "isSponsored": false,
  "isPrime": true,
  "inStock": true,
  "stockText": null,
  "isAmazonChoice": true,
  "isBestSeller": false,
  "badge": "Overall Pick",
  "coupon": null,
  "delivery": "Join Prime to get FREE delivery Sat, Nov 14 Or Non-members get FREE delivery Tue, Nov 17 on $35 of items shipped by Amazon",
  "otherOffers": null,
  "position": 3,
  "organicPosition": 1,
  "pagePosition": 3,
  "page": 1,
  "query": "wireless earbuds",
  "categoryId": null,
  "startUrl": null,
  "listingUrl": "https://www.amazon.com/s?k=wireless+earbuds",
  "resultsText": "1-16 of over 20,000 results",
  "scrapedAt": "2026-11-13T04:32:36.879Z"
}
```

### Use cases

- **Keyword rank and ad tracking:** run `wireless earbuds` daily and see which ASINs hold organic ranks 1–50 and which slots are sponsored.
- **Category export beyond the search cap:** export Headphones (`172541`) cheapest first, up to 2,400 products with 100 pages.
- **Filtered product research:** coffee makers in Home & Kitchen between $20 and $50, or Prime-only, 4-stars-and-up USB-C cables.
- **Price monitoring:** schedule the same searches and compare `price`, `listPrice`, `discountPercent` and `boughtPastMonth` over time.
- **Quick lookups for AI agents:** the top 20 organic products for `yoga mat` with prices and ratings in one call.

### Limitations

- **amazon.com only** (US store, USD, US delivery). Other Amazon domains are rejected.
- **Listing data only.** Seller, Best Sellers rank, feature bullets, variants and descriptions are on product pages, which this actor does not open.
- **Keyword searches stop at Amazon's cap** of 7–20 pages (about 300 products). Category listings go up to 400 pages.
- **Fields that can be empty (null):** `title`, `brand`, `imageUrl`, `price`, `listPrice`, `discountPercent`, `currency`, `unitPrice`, `rating`, `reviewsCount`, `boughtPastMonth`, `boughtPastMonthText`, `inStock`, `stockText`, `badge`, `coupon`, `delivery`, `otherOffers`, `organicPosition` (always null for sponsored cards), `query` (null for categories and start URLs without `k=`), `categoryId`, `startUrl` (null for keywords and category IDs) and `resultsText`. `brand` is filled only in grid layouts. `price` is null when the card has no single price (e.g. "No featured offers" or a variant range), and then `currency` is null too.
- **Delivery dates** depend on the US location of the proxy IP; a ZIP code cannot be chosen.
- **A wrong numeric category ID** is not detected: Amazon returns an unfiltered listing. Check `resultsText`.

### Tips and troubleshooting

- **More products:** keyword searches end after about 300 products, so use `categoryIds` or a category URL with a higher `maxPages`, or add more keywords. Raise `maxItems` too: it is the total for the whole run.
- **Only organic results:** set `includeSponsored` to off. `position` still counts the ads; `organicPosition` is the organic rank.
- **Filters for URLs:** Department, Prime only and 4 stars & up apply to keywords only. For a category or start URL, apply the filter on amazon.com and paste that URL.
- **0 rows:** a nonsense keyword or some department + keyword pairs (e.g. `gift` in Pet Supplies) return no result list; the log names the search. Try other words or another department.
- **Missing prices or many failed pages:** keep the default US residential proxy. Non-US IPs see no prices, datacenter proxies fail on about 1 page in 5, "no proxy" is switched to US residential, and your own proxy URLs must be US IPs.
- **Partial results:** if one page fails after retries, the rows already fetched are kept and the other searches continue.

### API, MCP and integrations

Run the actor from your code with the same JSON input as in Console. Your API token is in [Console → Settings → API & Integrations](https://console.apify.com/settings/integrations).

**Python** (`pip install apify-client`):

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("genial_candlestand/amazon-search-scraper").call(run_input={"queries": ["wireless earbuds"], "maxItems": 30})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

**Node.js** (`npm install apify-client`):

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

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('genial_candlestand/amazon-search-scraper').call({"queries": ["wireless earbuds"], "maxItems": 30});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

**HTTP** — one request runs the actor and returns the results (runs up to 5 minutes; longer ones: [run asynchronously](https://docs.apify.com/api/v2/act-runs-post)):

```bash
curl -X POST "https://api.apify.com/v2/acts/genial_candlestand~amazon-search-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"queries":["wireless earbuds"],"maxItems":30}'
```

**AI agents (MCP).** Add the actor as a tool of the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp). Claude Code:

```bash
claude mcp add --transport http apify "https://mcp.apify.com?tools=genial_candlestand/amazon-search-scraper"
```

Claude Desktop, Cursor or VS Code: `{"mcpServers": {"apify": {"url": "https://mcp.apify.com?tools=genial_candlestand/amazon-search-scraper"}}}`. Then ask, for example:

- "Get the top 20 organic Amazon products for yoga mat with prices and ratings"
- "Which ASINs are sponsored in the first 3 pages of Amazon results for wireless earbuds?"
- "List Amazon coffee makers between 20 and 50 dollars in Home & Kitchen, cheapest first"

**Integrations.** Run it on a schedule with [Apify Schedules](https://docs.apify.com/platform/schedules) and send the results to Google Sheets, Slack, Zapier, Make, n8n or your webhook — see [Apify integrations](https://docs.apify.com/platform/integrations).

### FAQ

**Is it legal to scrape Amazon search results?**<br>
The actor reads public search and category pages without a login and solves no captchas. The data is product information Amazon shows to every visitor, with no personal data. You are responsible for how you use it and for complying with Amazon's terms and the laws that apply to you.

**Can I get more than 7 or 20 pages?**<br>
Not for keyword searches: Amazon itself ends them there. Category listings (`categoryIds` or `/b?node=` URLs) are read up to 400 pages of 24 products.

**Are sponsored products included?**<br>
Yes, by default, marked `isSponsored: true`. Turn off **Include sponsored products** to keep only organic cards; dropped ads are not charged.

**How is it different from other Amazon scrapers?**<br>
It returns a separate organic rank (`organicPosition`) next to the overall and page positions, `boughtPastMonth` as a number, `unitPrice`, `coupon`, `otherOffers` and stock state straight from the listing, and reads categories up to 400 pages. It costs $2.50 per 1,000 products on the Free plan, against $5 per 1,000 results for the leading general Amazon crawler in the Store.

**Can I scrape Amazon UK, Germany or other stores?**<br>
No. Only www.amazon.com URLs are accepted, and prices are in USD.

### Also useful

- [Amazon Best Sellers Scraper](https://apify.com/genial_candlestand/amazon-best-sellers-scraper) — add Best Sellers and New Releases ranks for the same categories on 12 Amazon stores
- [eBay Search Scraper](https://apify.com/genial_candlestand/ebay-search-scraper-listings-prices) — compare the same products on eBay: listing prices, sellers and shipping
- [eBay Sold Listings Scraper](https://apify.com/genial_candlestand/ebay-sold-listings-scraper) — check what the same products really sold for on eBay, with sold dates
- [Etsy Search Scraper](https://apify.com/genial_candlestand/etsy-search-scraper) — research the same keywords on Etsy: prices, shops, ads and rankings
- [AliExpress Product Scraper](https://apify.com/genial_candlestand/aliexpress-product-details-scraper) — find supplier prices, variants and shipping for products you plan to sell

# Actor input Schema

## `queries` (type: `array`):

Keywords to search on amazon.com, one search per line, e.g. wireless earbuds. Give at least one of Search keywords, Category IDs or Start URLs. Amazon ends a keyword search after 7–20 pages (about 300 products).

## `categoryIds` (type: `array`):

amazon.com browse node IDs, digits only, e.g. 172541 for Headphones (the number after node= in a /b?node= URL). Lists the category up to 400 pages (~9,600 products). Department, Prime only and 4 stars & up do not apply here.

## `startUrls` (type: `array`):

amazon.com search URLs (/s?k=…) or category URLs (/b?node=…, /s?rh=n:…). The URL's own filters and sort are kept. Only www.amazon.com; product pages (/dp/) and other pages are rejected. Department, Prime only and 4 stars & up do not apply here — put them in the URL.

## `department` (type: `string`):

Search keywords inside one of 17 departments, e.g. Electronics, Home & Kitchen, Books. Empty = all departments. Applies to Search keywords only.

## `sort` (type: `string`):

Order of the results: Featured, price low to high or high to low, average customer review, newest arrivals or best sellers. Works for keywords, categories and start URLs (Featured keeps a start URL's own sort).

## `minPrice` (type: `integer`):

Only products priced at least this many whole US dollars. Works for keywords, categories and start URLs. Must not be above Max price.

## `maxPrice` (type: `integer`):

Only products priced at most this many whole US dollars. Works for keywords, categories and start URLs. Must not be below Min price.

## `primeOnly` (type: `boolean`):

Only Prime-eligible products. Applies to Search keywords only; for categories and start URLs it is ignored with a warning.

## `fourStarsAndUp` (type: `boolean`):

Only products rated 4 stars or more. Applies to Search keywords only; for categories and start URLs it is ignored with a warning.

## `includeSponsored` (type: `boolean`):

Keep sponsored (ad) cards as rows with isSponsored true. Off = only organic products, and dropped ads are not charged; positions still count the ads.

## `maxPages` (type: `integer`):

Result pages to read per keyword, category or start URL, 1–400. Keyword searches end on Amazon after 7–20 pages; categories go up to 400.

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

Stop after this many products in total across all searches of the run.

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

US residential proxy is the default and recommended: amazon.com blocks most datacenter IPs and shows no prices to non-US IPs. Other choices work with a warning; "no proxy" is switched to US residential.

## Actor input object example

```json
{
  "queries": [
    "wireless earbuds"
  ],
  "sort": "relevance",
  "primeOnly": false,
  "fourStarsAndUp": false,
  "includeSponsored": true,
  "maxPages": 20,
  "maxItems": 30,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

# Actor output Schema

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

Dataset with one row per product card

## `overview` (type: `string`):

Products in the overview table view

# 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 = {
    "queries": [
        "wireless earbuds"
    ],
    "maxItems": 30
};

// Run the Actor and wait for it to finish
const run = await client.actor("genial_candlestand/amazon-search-scraper").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 = {
    "queries": ["wireless earbuds"],
    "maxItems": 30,
}

# Run the Actor and wait for it to finish
run = client.actor("genial_candlestand/amazon-search-scraper").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 '{
  "queries": [
    "wireless earbuds"
  ],
  "maxItems": 30
}' |
apify call genial_candlestand/amazon-search-scraper --silent --output-dataset

```

## MCP server setup

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

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/AG6sR3s56EzcPOCMl/builds/BINUaPrx1W5OpmJKS/openapi.json
