# Amazon Search, Category & Best Sellers Scraper (`lentic_clockss/amazon-search-results-collector`) Actor

Scrape Amazon keyword search, category browse, and Best Sellers across 21 storefronts. Export ASINs, titles, prices, ratings, images, and product URLs.

- **URL**: https://apify.com/lentic\_clockss/amazon-search-results-collector.md
- **Developed by:** [kane liu](https://apify.com/lentic_clockss) (community)
- **Categories:** E-commerce, Lead generation, Developer tools
- **Stats:** 3 total users, 3 monthly users, 72.7% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.90 / 1,000 result items

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

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

For usage examples, see the [API](#api) section below.

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

# README

## Amazon Search, Category & Best Sellers Scraper

Scrape live Amazon listings from **21 Amazon storefronts** using three collection modes:

- **Keyword search** – classic `/s?k=` search results
- **Category browse** – department browse or in-category search
- **Best Sellers** – `/gp/bestsellers` ranking pages

Collect ASINs, titles, prices, ratings, review counts, sponsored flags, images, product URLs, and search URLs.

Scraping runs on a hosted **Cloud Run worker** (`amazon-com`, `httpx` + `selectolax`). This Actor is a thin Apify client: it calls the worker over HTTPS with an API key, then writes Dataset / KV / PPE charges.

> **Worker URL is config, not code:** the Actor reads `WORKER_BASE_URL` from Actor environment variables (plus optional per-run `workerBaseUrl`). If you migrate the worker to a new host, update `WORKER_BASE_URL` (and `WORKER_AUTH` if the API key changes) in Apify Console — no Actor code change required. `WORKER_PROVIDES_PROXY=1` means the worker supplies its own `PROXY_URL`.

### Supported markets

| Code | Storefront | Currency |
| --- | --- | --- |
| AE | amazon.ae | AED |
| AU | amazon.com.au | AUD |
| BE | amazon.com.be | EUR |
| BR | amazon.com.br | BRL |
| CA | amazon.ca | CAD |
| DE | amazon.de | EUR |
| EG | amazon.eg | EGP |
| ES | amazon.es | EUR |
| FR | amazon.fr | EUR |
| GB | amazon.co.uk | GBP |
| IN | amazon.in | INR |
| IT | amazon.it | EUR |
| JP | amazon.co.jp | JPY |
| MX | amazon.com.mx | MXN |
| NL | amazon.nl | EUR |
| PL | amazon.pl | PLN |
| SA | amazon.sa | SAR |
| SE | amazon.se | SEK |
| SG | amazon.sg | SGD |
| TR | amazon.com.tr | TRY |
| US | amazon.com | USD |

### Collection modes

#### 1. Keyword search

```json
{
  "mode": "keyword",
  "keywords": ["usb hub"],
  "market": "US",
  "pages": 1,
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "US"
  }
}
```

#### 2. Category browse / in-category search

```json
{
  "mode": "category",
  "category": "electronics",
  "market": "DE",
  "pages": 1,
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "DE"
  }
}
```

When `keywords` are omitted in category mode, the Actor uses the department title as an in-category browse query so Amazon returns searchable product cards.

Search inside a category by also passing keywords:

```json
{
  "mode": "category",
  "category": "electronics",
  "keywords": ["usb hub"],
  "market": "US",
  "pages": 1,
  "maxItems": 20
}
```

Pass any subcategory with `categoryNodeId` (browse node) to go beyond the built-in root departments.

#### 3. Best Sellers

```json
{
  "mode": "bestsellers",
  "category": "electronics",
  "market": "JP",
  "pages": 1,
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "JP"
  }
}
```

Use `categorySlug` for a custom Best Sellers path, or `categoryNodeId` for a nested ranking node.

### Built-in category keys

`all`, `amazon-devices`, `audible`, `automotive`, `baby`, `beauty`, `books`, `computers`, `electronics`, `fashion`, `garden`, `grocery`, `handmade`, `health`, `home`, `industrial`, `kindle-store`, `kitchen`, `luggage`, `movies-tv`, `music`, `office-products`, `pet-supplies`, `software`, `sports`, `tools`, `toys-and-games`, `video-games`

### Example output item

```json
{
  "keyword": "usb hub",
  "mode": "keyword",
  "market": "SG",
  "marketName": "Singapore",
  "country": "SG",
  "page": 1,
  "rank": 1,
  "asin": "B0CD1BHXPZ",
  "title": "USB C Hub Multiport Adapter for Laptop",
  "price": "S$24.99",
  "priceValue": 24.99,
  "currencyCode": "SGD",
  "ratingScore": 4.5,
  "reviewCount": 1284,
  "isSponsored": false,
  "productUrl": "https://www.amazon.sg/dp/B0CD1BHXPZ",
  "searchUrl": "https://www.amazon.sg/s?k=usb+hub&page=1",
  "source": "amazonSearchHtml",
  "capturedAt": "2026-07-11T01:00:00Z"
}
```

### Input

| Field | Type | Default | Description |
| --- | --- | --- | --- |
| `mode` | string | `keyword` | `keyword`, `category`, or `bestsellers` |
| `keywords` | array | `["usb hub"]` | Required for keyword mode; optional for category |
| `market` | string | `SG` | One of the 21 supported storefront codes |
| `category` | string | optional | Stable department key |
| `categoryNodeId` | string | optional | Raw Amazon browse node ID |
| `categorySlug` | string | optional | Best Sellers path slug |
| `pages` | integer | `1` | Pages per task (max 5) |
| `maxItems` | integer | `40` | Global output cap (1–100). Free plan: also **10 total runs** of this Actor |
| `maxItemsPerKeyword` | integer | `40` | Per-task output cap |
| `requestTimeoutSecs` | integer | `30` | HTTP timeout |
| `proxyConfiguration` | object | optional | Unused when `WORKER_PROVIDES_PROXY=1` (default) |
| `workerBaseUrl` | string | *(env)* | Optional per-run override of Actor env `WORKER_BASE_URL` |
| `debug` / `includeRawHtml` | boolean | `false` | Debug artifacts |
| `fixtureHtmlPath` | string | optional | Offline fixture HTML |

#### Free Apify plan limits (set by this Actor's developer)

| Limit | Free Apify plan | Paid Apify plan |
| --- | --- | --- |
| Runs of this Actor | **10 runs total** | Unlimited |
| Results per run | **Up to 100** (schema max) | Up to 100 |

When the run cap is hit, the run finishes with a clear status message (`FREE_TIER_LIMIT`) — not an Apify platform error. Upgrade to a paid Apify plan for unlimited runs.

### Proxy routing

By default the Cloud Run worker uses its durable `PROXY_URL` (`WORKER_PROVIDES_PROXY=1`). If you unset that flag, remote runs mint Apify residential proxy with `apifyProxyCountry` matching the selected market.

### Standby API

Documented in `.actor/openapi.json`:

- `GET /` / `GET /health`
- `GET /input-example`
- `GET /openapi.json`
- `POST /search`
- `POST /run`

### More Actors like this

Need another marketplace or a different vertical? Use a **dedicated Actor** below for structured fields. Use this Actor for **Amazon search**, category browse, and Best Sellers across supported storefronts.

#### Similar e-commerce scrapers

- [Shopee Search Scraper](https://apify.com/lentic_clockss/shopee-search-scraper)
- [Lazada Scraper](https://apify.com/lentic_clockss/lazada-ph-search-results-collector)
- [SHEIN Product Scraper](https://apify.com/lentic_clockss/shein-scraper)
- [Temu Product Scraper](https://apify.com/lentic_clockss/temu-scraper)
- [MercadoLibre Scraper](https://apify.com/lentic_clockss/mercadolibre-scraper)
- [1688 Global Product Search Scraper](https://apify.com/lentic_clockss/1688-global-scraper)
- [Coupang Product Scraper](https://apify.com/lentic_clockss/coupang-scraper)
- [Walmart Product Scraper](https://apify.com/lentic_clockss/walmart-scraper)
- [Etsy Scraper](https://apify.com/lentic_clockss/etsy-scraper)
- [Target Product Scraper](https://apify.com/lentic_clockss/target-scraper)
- [Allegro Scraper](https://apify.com/lentic_clockss/allegro-scraper)
- [Mercari Japan Scraper](https://apify.com/lentic_clockss/mercari-scraper)

#### Prefer another specialized scraper?

If your target has a specialized Actor below, use that first — usually cheaper and more structured than a generic scrape.

**Jobs & Freelance**

- [LinkedIn Jobs Scraper](https://apify.com/lentic_clockss/linkedin-jobs-scraper)
- [Indeed Jobs Scraper](https://apify.com/lentic_clockss/indeed-jobs-scraper)
- [Upwork Jobs Scraper](https://apify.com/lentic_clockss/upwork-jobs-scraper)
- [Glassdoor Scraper](https://apify.com/lentic_clockss/glassdoor-scraper)
- [Fiverr Gigs Scraper](https://apify.com/lentic_clockss/fiverr-programming-tech-gigs-scraper)
- [Bayt Jobs Scraper](https://apify.com/lentic_clockss/bayt-scraper)

**Real Estate**

- [Zillow & Zumper Scraper](https://apify.com/lentic_clockss/us-real-estate-scraper)
- [Realtor.com Scraper](https://apify.com/lentic_clockss/realtor-com-scraper)
- [Apartments.com Rental Scraper](https://apify.com/lentic_clockss/apartments-com-rental-scraper)
- [Rightmove Scraper](https://apify.com/lentic_clockss/rightmove-property-scraper)
- [Idealista Scraper](https://apify.com/lentic_clockss/idealista-scraper)
- [realestate.com.au Scraper](https://apify.com/lentic_clockss/realestate-com-au-scraper)

**Travel & Stays**

- [Booking.com Hotels Scraper](https://apify.com/lentic_clockss/booking-hotels-scraper)
- [Airbnb Listings Scraper](https://apify.com/lentic_clockss/airbnb-listings-scraper)
- [Expedia Scraper](https://apify.com/lentic_clockss/expedia-scraper)
- [TripAdvisor Scraper](https://apify.com/lentic_clockss/tripadvisor-scraper)

**Social & Content**

- [YouTube Research Scraper](https://apify.com/lentic_clockss/youtube-research-scraper)
- [TikTok Scraper](https://apify.com/lentic_clockss/tiktok-scraper)
- [Reddit Scraper](https://apify.com/lentic_clockss/reddit-scraper)
- [YouTube Shorts Scraper](https://apify.com/lentic_clockss/youtube-shorts-scraper)

**Ads Intelligence**

- [Facebook Ad Library Scraper](https://apify.com/lentic_clockss/facebook-ad-library-scraper)
- [TikTok Ads Scraper](https://apify.com/lentic_clockss/tiktok-ads-top-ads-actor)

**Local & Maps**

- [Google Maps Scraper](https://apify.com/lentic_clockss/google-maps-scraper)

#### General tools

- [Stealth Web Scraper](https://apify.com/lentic_clockss/stealth-web-scraper)
- [Email Risk Validator](https://apify.com/lentic_clockss/email-risk-validator)
- [Phone Number Intelligence](https://apify.com/lentic_clockss/phone-number-intelligence)

→ See the full catalog in [Related Actors](#related-actors) below, or browse [apify.com/lentic\_clockss](https://apify.com/lentic_clockss).

***

### How to use on Apify

1. Open the Actor.
2. Choose `mode`, `market`, and keywords/category.
3. Keep `pages` and `maxItems` low for a first test.
4. Enable residential proxy with a matching country.
5. Run and export the dataset.

### FAQ

#### What are the free Apify plan limits?

Free Apify plan users get **10 runs** of this Actor and **up to 100 results per run**. These limits are set by the Actor developer (not Apify). When you hit the run cap, the run finishes with a clear status message (`FREE_TIER_LIMIT`) — it is not a platform bug. Upgrade to a paid Apify plan for unlimited runs.

### Notes and limits

- Amazon HTML and anti-bot behavior change over time.
- Browse node IDs differ by storefront; use `categoryNodeId` for precise subcategories.
- Best Sellers cards use a separate parser from keyword/category search cards.
- Results are deduplicated by ASIN before writing the final dataset.

### Summary

Use this Actor for Amazon keyword monitoring, category assortment checks, and Best Sellers ranking snapshots across all major Amazon storefronts.

### Related Actors

All **77** public Actors from \[[lentic\_clockss](https://apify.com/lentic_clockss)]. Click a name to open the Store detail page.

#### Jobs & Freelance

- [LinkedIn Jobs Scraper](https://apify.com/lentic_clockss/linkedin-jobs-scraper)
- [Bayt Jobs Scraper](https://apify.com/lentic_clockss/bayt-scraper)
- [Fiverr Gigs Scraper](https://apify.com/lentic_clockss/fiverr-programming-tech-gigs-scraper)
- [Freelancer.com Scraper](https://apify.com/lentic_clockss/freelancer-scraper)
- [Glassdoor Scraper](https://apify.com/lentic_clockss/glassdoor-scraper)
- [Himalayas Jobs Scraper](https://apify.com/lentic_clockss/himalayas-jobs-scraper)
- [Indeed Jobs Scraper](https://apify.com/lentic_clockss/indeed-jobs-scraper)
- [Jobicy Remote Jobs Scraper](https://apify.com/lentic_clockss/jobicy-remote-jobs-scraper)
- [RemoteOK Jobs Scraper](https://apify.com/lentic_clockss/remoteok-all-jobs-scraper)
- [SEEK Jobs Scraper](https://apify.com/lentic_clockss/seek-scraper)
- [Upwork Jobs Scraper](https://apify.com/lentic_clockss/upwork-jobs-scraper)

#### Real Estate

- [Zillow & Zumper Scraper](https://apify.com/lentic_clockss/us-real-estate-scraper)
- [Realtor.com Scraper](https://apify.com/lentic_clockss/realtor-com-scraper)
- [99.co Scraper](https://apify.com/lentic_clockss/ninetynine-co-sg-scraper)
- [Realtor.com Agents Scraper](https://apify.com/lentic_clockss/realtor-com-agents-scraper)
- [Apartments.com Rental Scraper](https://apify.com/lentic_clockss/apartments-com-rental-scraper)
- [Bayut Scraper](https://apify.com/lentic_clockss/bayut-uae-scraper)
- [Craigslist Housing Scraper](https://apify.com/lentic_clockss/craigslist-housing-scraper)
- [Daft.ie Scraper](https://apify.com/lentic_clockss/daft-property-scraper)
- [Dot Property Scraper](https://apify.com/lentic_clockss/dot-property-th-scraper)
- [FINN.no Scraper](https://apify.com/lentic_clockss/finn-scraper)
- [Funda Scraper](https://apify.com/lentic_clockss/funda-scraper)
- [Hepsiemlak Scraper](https://apify.com/lentic_clockss/hepsiemlak-scraper)
- [Idealista Scraper](https://apify.com/lentic_clockss/idealista-scraper)
- [Immobiliare.it Scraper](https://apify.com/lentic_clockss/immobiliare-property-scraper)
- [ImmoScout24 Scraper](https://apify.com/lentic_clockss/immobilienscout24-scraper)
- [Naver Land Scraper](https://apify.com/lentic_clockss/naver-land-scraper)
- [OpenSooq Scraper](https://apify.com/lentic_clockss/opensooq-real-estate-scraper)
- [Otodom Scraper](https://apify.com/lentic_clockss/otodom-scraper)
- [Property Finder Scraper](https://apify.com/lentic_clockss/property-finder-uae-scraper)
- [PropertyGuru Scraper](https://apify.com/lentic_clockss/propertyguru-sg-scraper)
- [realestate.com.au Scraper](https://apify.com/lentic_clockss/realestate-com-au-scraper)
- [Realtor.ca Scraper](https://apify.com/lentic_clockss/realtor-ca-scraper)
- [Rightmove Scraper](https://apify.com/lentic_clockss/rightmove-property-scraper)
- [SeLoger Scraper](https://apify.com/lentic_clockss/seloger-property-scraper)
- [SUUMO Scraper](https://apify.com/lentic_clockss/suumo-property-scraper)
- [Zillow Group Scraper](https://apify.com/lentic_clockss/zillow-group-scraper)

#### E-commerce

- [Shopee Search Scraper](https://apify.com/lentic_clockss/shopee-search-scraper)
- [E-commerce Scraper](https://apify.com/lentic_clockss/ecommerce-scraper)
- [1688 Global Product Search Scraper](https://apify.com/lentic_clockss/1688-global-scraper)
- [Allegro Scraper](https://apify.com/lentic_clockss/allegro-scraper)
- [Amazon Search Scraper](https://apify.com/lentic_clockss/amazon-search-results-collector)
- [ASOS Product Scraper](https://apify.com/lentic_clockss/asos-scraper)
- [Cdiscount Product Scraper](https://apify.com/lentic_clockss/cdiscount-scraper)
- [Costco Product Scraper](https://apify.com/lentic_clockss/costco-scraper)
- [Coupang Product Scraper](https://apify.com/lentic_clockss/coupang-scraper)
- [Etsy Scraper](https://apify.com/lentic_clockss/etsy-scraper)
- [Lazada Scraper](https://apify.com/lentic_clockss/lazada-ph-search-results-collector)
- [MercadoLibre Scraper](https://apify.com/lentic_clockss/mercadolibre-scraper)
- [Mercari Japan Scraper](https://apify.com/lentic_clockss/mercari-scraper)
- [Rakuten Japan Scraper](https://apify.com/lentic_clockss/rakuten-scraper)
- [SHEIN Product Scraper](https://apify.com/lentic_clockss/shein-scraper)
- [Target Product Scraper](https://apify.com/lentic_clockss/target-scraper)
- [Temu Product Scraper](https://apify.com/lentic_clockss/temu-scraper)
- [Walmart Product Scraper](https://apify.com/lentic_clockss/walmart-scraper)

#### Travel & Stays

- [Booking.com & Airbnb Scraper](https://apify.com/lentic_clockss/booking-airbnb-scraper)
- [Agoda Scraper](https://apify.com/lentic_clockss/agoda-scraper)
- [Airbnb Listings Scraper](https://apify.com/lentic_clockss/airbnb-listings-scraper)
- [Booking.com Hotels Scraper](https://apify.com/lentic_clockss/booking-hotels-scraper)
- [Despegar Scraper](https://apify.com/lentic_clockss/despegar-scraper)
- [Expedia Scraper](https://apify.com/lentic_clockss/expedia-scraper)
- [Traveloka Scraper](https://apify.com/lentic_clockss/traveloka-scraper)
- [Travelstart Flights Scraper](https://apify.com/lentic_clockss/travelstart-scraper)
- [Trip.com Scraper](https://apify.com/lentic_clockss/trip-com-scraper)
- [TripAdvisor Scraper](https://apify.com/lentic_clockss/tripadvisor-scraper)

#### Social & Content

- [TikTok Scraper](https://apify.com/lentic_clockss/tiktok-scraper)
- [Reddit Scraper](https://apify.com/lentic_clockss/reddit-scraper)
- [YouTube Shorts Scraper](https://apify.com/lentic_clockss/youtube-shorts-scraper)
- [YouTube Research Scraper](https://apify.com/lentic_clockss/youtube-research-scraper)
- [Hacker News Scraper](https://apify.com/lentic_clockss/hacker-news-scraper)

#### Ads Intelligence

- [Facebook Ad Library Scraper](https://apify.com/lentic_clockss/facebook-ad-library-scraper)
- [Google Ads Transparency VN](https://apify.com/lentic_clockss/google-ads-transparency-center-vn)
- [TikTok Ads Scraper](https://apify.com/lentic_clockss/tiktok-ads-top-ads-actor)

#### Local & Maps

- [Google Maps Scraper](https://apify.com/lentic_clockss/google-maps-scraper)

#### General Tools

- [Stealth Web Scraper](https://apify.com/lentic_clockss/stealth-web-scraper)
- [Email Risk Validator](https://apify.com/lentic_clockss/email-risk-validator)
- [Phone Number Intelligence](https://apify.com/lentic_clockss/phone-number-intelligence)

→ Browse the full profile: [apify.com/lentic\_clockss](https://apify.com/lentic_clockss)

# Actor input Schema

## `keywords` (type: `array`):

Amazon search keywords. Required for keyword mode. Optional for category mode (search within a category). Ignored for pure bestsellers browsing when empty.

## `mode` (type: `string`):

keyword = Amazon search results; category = category browse or in-category search; bestsellers = Best Sellers ranking pages.

## `market` (type: `string`):

Amazon storefront to query.

## `category` (type: `string`):

Stable ecommerce department key (e.g. electronics, books, kitchen). Required for category/bestsellers unless categoryNodeId or categorySlug is set.

## `categoryNodeId` (type: `string`):

Optional Amazon browse node ID. Overrides the mapped node for any subcategory.

## `categorySlug` (type: `string`):

Optional Best Sellers path slug (e.g. electronics). Overrides the mapped slug.

## `pages` (type: `integer`):

Maximum number of result pages to request for each task.

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

Global cap for total emitted dataset items across all tasks (1–100). Free Apify plan users: also limited to 10 total runs of this Actor (Actor developer policy).

## `maxItemsPerKeyword` (type: `integer`):

Per-task cap applied before the global maxItems limit. Free Apify plan users share the same 100/run result cap.

## `workerBaseUrl` (type: `string`):

Override the Cloud Run worker origin for this run. Defaults to Actor env WORKER\_BASE\_URL. Production migrations should update WORKER\_BASE\_URL in Actor settings (no code change).

## `requestTimeoutSecs` (type: `integer`):

HTTP timeout for each Amazon request.

## `userAgent` (type: `string`):

Optional HTTP User-Agent override for local debugging.

## `debug` (type: `boolean`):

Enable verbose diagnostic logging and extra debugging artifacts.

## `includeRawHtml` (type: `boolean`):

Persist raw HTML snapshots to the default key-value store for debugging.

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

Optional. By default the Cloud Run worker uses its own durable PROXY\_URL (WORKER\_PROVIDES\_PROXY=1). Unset that flag if you need the Actor to mint Apify RESIDENTIAL and forward proxyUrl.

## `fixtureHtmlPath` (type: `string`):

Optional local HTML fixture path for deterministic offline validation and gate runs.

## Actor input object example

```json
{
  "keywords": [
    "usb hub"
  ],
  "mode": "keyword",
  "market": "SG",
  "pages": 1,
  "maxItems": 40,
  "maxItemsPerKeyword": 40,
  "workerBaseUrl": "",
  "requestTimeoutSecs": 30,
  "debug": false,
  "includeRawHtml": false
}
```

# Actor output Schema

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

Normalized Amazon search result items from the default dataset.

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

Structured summary record stored in the default key-value store.

## `inputEcho` (type: `string`):

Normalized input saved at run start.

## `errorSummary` (type: `string`):

Present when a failed run stores structured terminal error information.

# 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 = {
    "keywords": [
        "usb hub"
    ],
    "workerBaseUrl": ""
};

// Run the Actor and wait for it to finish
const run = await client.actor("lentic_clockss/amazon-search-results-collector").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 = {
    "keywords": ["usb hub"],
    "workerBaseUrl": "",
}

# Run the Actor and wait for it to finish
run = client.actor("lentic_clockss/amazon-search-results-collector").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "keywords": [
    "usb hub"
  ],
  "workerBaseUrl": ""
}' |
apify call lentic_clockss/amazon-search-results-collector --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=lentic_clockss/amazon-search-results-collector",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/2wXwPs0tGELEsfRvZ/builds/WJcJJAbra16KxZW6d/openapi.json