# Amazon Fast Product Scraper (`ilborso/amazon-product-finder`) Actor

Extract Amazon search results, Buy Box pricing, multi-seller offers & technical specs by keyword or ASIN. Scrape Amazon products (free search & ASINs list). Extract product data, seller offers, and detailed specifications. Ideal for price monitoring, market research, and competitive analysis.

- **URL**: https://apify.com/ilborso/amazon-product-finder.md
- **Developed by:** [Fabio Borsotti](https://apify.com/ilborso) (community)
- **Categories:** E-commerce, Agents, Lead generation
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $0.59 / 1,000 results

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/actors/running/actors-in-store.md#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 Product Finder

An Apify Actor that searches for Amazon products and optionally retrieves detailed offer information for each product found.

### What does this Actor do?

This Actor:

1. Searches for Amazon products using a keyword or ASINs list
2. Automatically paginates through search results
3. Extracts product information (ASIN, title, price, URL, etc.)
4. Optionally retrieves detailed offer information for each product ASIN
5. Saves all results to an Apify dataset in structured JSON format

Perfect for market research, price monitoring, competitor analysis, or building large-scale product catalogs.

### Why use Amazon Product Finder?

- **Automated pagination** - Handles multi-page results without manual intervention
- **Scalable data collection** - Retrieve thousands of products efficiently
- **Offer enrichment** - Get detailed seller and pricing information per product
- **Configurable limits** - Control max pages and max products to manage costs
- **Robust error handling** - Gracefully handles transient errors and continues processing
- **Production-ready** - Built with best practices for reliability and monitoring

### Input Schema

| Field | Type | Required | Default | Description |
|-------|------|----------|---------|-------------|
| `keyword` | string | Conditional | - | Search term for Amazon products. Required if `ASINs` is not provided. |
| `ASINs` | array/string | Conditional | \[] | List of explicit Amazon ASINs to fetch. Required if `keyword` is not provided. Not affected by `max_products`. |
| `geocode` | string | No | "it" | Geographic code (it, en, de, fr, es, uk, ca, au, jp, br) |
| `max_products` | integer | No | 1000 | Maximum total products to return from free search. (Does not restrict explicitly provided `ASINs`). |
| `offer_listing` | boolean | No | false | Retrieves every seller listing for a specific product, including pricing, shipping costs, seller information, and Buy Box status. |
| `detailed_info` | boolean | No | false | Extracts comprehensive product information from any Amazon product page (PDP). |

### Output Schema

**Base information**

| Field        | Type    | Description                                                            |
| ------------ | ------- | ---------------------------------------------------------------------- |
| asin         | string  | Product ASIN number                                                    |
| title        | string  | Product title                                                          |
| url          | string  | Product detail page URL                                                |
| imageUrl     | string  | Product thumbnail image URL                                            |
| price        | object  | Price with currencyCode and amount                                     |
| rating       | object  | Rating with value, count, and stars                                    |
| reviewCount  | string  | Number of reviews as displayed                                         |
| isSponsored  | boolean | Whether this is a sponsored/ad placement                               |
| isPrime      | boolean | Whether Prime shipping is available                                    |
| position     | number  | Position on the search results page                                    |
| badge        | string  | Special badge if present (e.g., Best Seller, Overall Pick)             |

**With offer\_listing = true**

| Field               | Type    | Description                                                |
| ------------------- | ------- | ---------------------------------------------------------- |
| condition           | string  | Product condition (New, Used, Refurbished, etc.)           |
| offerHeader         | string  | Offer header text                                          |
| sellerId            | string  | Unique seller identifier                                   |
| merchantName        | string  | Seller/merchant display name                               |
| shippingTime        | object  | Shipping time details including deliveryDate               |
| listingPrice        | object  | Current offer price with currencyCode and amount           |
| listPrice           | object  | Original list price (if discounted)                        |
| discount            | object  | Discount details with percentage, amount, and currencyCode |
| shipping            | object  | Shipping cost with currencyCode and amount                 |
| shipsFrom           | string  | Shipping origin location                                   |
| isFulfilledByAmazon | boolean | Whether the offer is FBA (Fulfilled by Amazon)             |
| primeInformation    | object  | Prime eligibility details                                  |
| isBuyBoxWinner      | boolean | Whether this offer holds the Buy Box                       |
| quantity            | number  | Available stock quantity                                   |

**With detailed\_info = true**

| Field                | Type    | Description                                                               |
| -------------------- | ------- | ------------------------------------------------------------------------- |
| asin                 | string  | Product ASIN number                                                       |
| is\_sponsored         | boolean | Whether the product is a sponsored listing                                |
| brand                | string  | Brand name                                                                |
| name                 | string  | Full product title                                                        |
| url                  | string  | Canonical product URL                                                     |
| thumbnail            | string  | Primary product image URL                                                 |
| rating               | number  | Average star rating (0–5)                                                 |
| total\_ratings        | number  | Total number of customer ratings                                          |
| price                | number  | Current selling price                                                     |
| list\_price           | number  | Original list price (if discounted)                                       |
| currency             | string  | Currency code (e.g., USD, EUR, GBP)                                       |
| currency\_symbol      | string  | Currency symbol (e.g., $, €, £)                                           |
| is\_prime             | boolean | Whether Prime shipping is available                                       |
| description          | string  | Long-form product description parsed from the PDP, when Amazon exposes it |
| shipping\_info        | array   | Shipping and delivery information strings                                 |
| more\_buying\_choices  | object  | Alternative seller options with links                                     |
| images               | array   | All product images with URLs and dimensions                               |
| best\_seller\_rankings | array   | Category rankings with rank numbers                                       |
| technical\_details    | object  | Key-value pairs of product specifications                                 |
| status               | string  | Request status (success or error)                                         |
| errorMessage         | string  | Error message if request failed                                           |
| html                 | string  | Full raw HTML of the Amazon page (only present when include\_html=true)    |

### Example Input

```json
{
  "keyword": "Lenovo Legion Tab",
  "geocode": "it",
  "max_products": 100,
  "offer_listing": true,
  "detailed_info": true
}
```

### Output

The Actor saves multiple dataset records, one per product. Each record has this structure:

**Complete product record with offers and details:**

```json
[
  {
    "asin": "B0G1MQVMPF",
    "title": "HP Laptop 15-fd1004sl, 15\" Laptop, FHD Display, Notebook, (Intel Core Ultra 7 155H, RAM 16GB, SSD 512GB, Windows 11), Laptop, Daily Use, Italian Keyboard, QWERTY, Silver",
    "url": "https://www.amazon.it/-/en/HP-15-fd1004sl-Display-Notebook-Keyboard/dp/B0G1MQVMPF/ref=sr_1_1?dib=eyJ2IjoiMSJ9.RTwssI-S-LMCX4qSc2nhun61nJwbUBl1vYUf2-hqkLu_CSjRutYtCITugiUZ0JpvAIVQnKQUS1yWadusnuB3piTRHSQ8Uy2YwiwBGztoTtZyWtId0AmYKQWZktr282_4y6TyfbB4li5W9HqEGxdmwij-BpeBA06JuHVwhf1UqpRORZFNQ3XcUVnTpaYNZoOiRAOoHR9-MQtww5jXR79m9lSGWoVhUNda_L-Zwyb-Ksd2OyB6Db0n_iGfs4rxFo1xGCQXKVqoCIx5aPSLn0QBvzEzgnSX3l2OT-1hlBces8s.4Ro4uMDrXzaO1nUXxDgCz0PEKShQXuoRzGO7Fp2GQxw&dib_tag=se&keywords=laptop&qid=1787736604&sr=8-1",
    "imageUrl": "https://m.media-amazon.com/images/I/61dyRuH3ocL._AC_UL320_.jpg",
    "price": {
      "currencyCode": "EUR",
      "amount": 549.99
    },
    "rating": {
      "value": 4.5,
      "count": 0,
      "stars": 5
    },
    "reviewCount": "(4)",
    "isSponsored": false,
    "position": 3,
    "badge": "Limited time deal",
    "sales_volume": "100+ bought in past month",
    "delivery": {
      "isFree": true,
      "date": "Thu 3 Sept",
      "rawText": "FREE delivery Thu 3 Sept"
    },
    "offers": [
      {
        "condition": "New",
        "offerHeader": "New",
        "sellerId": "APJ6JRA9NG5V4",
        "merchantName": "Amazon",
        "shippingTime": {
          "minimumHours": 24,
          "maximumHours": 72,
          "deliveryDate": "Thursday, 3 September",
          "isFree": true
        },
        "listingPrice": {
          "currencyCode": "EUR",
          "amount": 549.99
        },
        "priceNotice": null,
        "promotion": null,
        "listPrice": {
          "currencyCode": "EUR",
          "amount": 599.99
        },
        "discount": {
          "percentage": 8.33,
          "amount": 50,
          "currencyCode": "EUR"
        },
        "shipping": {
          "currencyCode": "EUR",
          "amount": 0
        },
        "ships_from": "Amazon",
        "isFulfilledByAmazon": true,
        "primeInformation": {
          "isPrime": false,
          "isNationalPrime": false
        },
        "isBuyBoxWinner": true,
        "quantity": 2
      }
    ],
    "details": {
      "asin": "B0G1MQVMPF",
      "parent_asin": "B0G1MQVMPF",
      "is_sponsored": false,
      "brand": "HP",
      "name": "HP Laptop 15-fd1004sl, 15\" Laptop, FHD Display, Notebook, (Intel Core Ultra 7 155H, RAM 16GB, SSD 512GB, Windows 11), Laptop, Daily Use, Italian Keyboard, QWERTY, Silver",
      "url": "https://www.amazon.it/dp/B0G1MQVMPF",
      "thumbnail": "https://m.media-amazon.com/images/I/61dyRuH3ocL._AC_SX300_SY300_QL70_ML2_.jpg",
      "rating": 4.5,
      "total_ratings": 4,
      "price": 549.99,
      "list_price": 599.99,
      "currency": "EUR",
      "currency_symbol": "€",
      "is_prime": true,
      "has_buy_box": true,
      "max_quantity": 2,
      "availability_text": "In stock",
      "sales_volume": "100+ bought in past month",
      "sold_by": "Amazon",
      "other_sellers_count": 0,
      "shipping_info": [
        "FREE Delivery Thursday, 3 September. Details",
        "FREE Delivery by Amazon",
        "Deliver to 89020‌"
      ],
      "shipping": {
        "is_prime": true,
        "location": {
          "zipcode": "89020"
        },
        "options": [
          {
            "type": "free",
            "price": 0,
            "is_prime": false,
            "delivery_date": {
              "by": "Thursday, 3 September",
              "formatted": "Thursday, 3 September"
            },
            "raw_text": "FREE Delivery Thursday, 3 September. Details"
          }
        ]
      },
      "images": [
        {
          "url": "https://m.media-amazon.com/images/I/61dyRuH3ocL._AC_SL1500_.jpg"
        },
        {
          "url": "https://m.media-amazon.com/images/I/71Pp0jD3bcL._AC_SL1500_.jpg"
        },
        {
          "url": "https://m.media-amazon.com/images/I/61YQyrcghyL._AC_SL1500_.jpg"
        },
        {
          "url": "https://m.media-amazon.com/images/I/51OIxL0PCBL._AC_SL1500_.jpg"
        },
        {
          "url": "https://m.media-amazon.com/images/I/61KOcNyEi9L._AC_SL1500_.jpg"
        },
        {
          "url": "https://m.media-amazon.com/images/I/81vsL3nugXL._AC_SL1500_.jpg"
        },
        {
          "url": "https://m.media-amazon.com/images/I/71u9EFCosJL._AC_SL1500_.jpg"
        },
        {
          "url": "https://m.media-amazon.com/images/I/71M0Qng58JL._AC_SL1500_.jpg"
        },
        {
          "url": "https://m.media-amazon.com/images/I/71pfJMfuiYL._AC_SL1500_.jpg"
        },
        {
          "url": "https://m.media-amazon.com/images/I/71pHaDMBiqL._AC_SL1500_.jpg"
        },
        {
          "url": "https://m.media-amazon.com/images/I/717i-hr6nuL._AC_SL1500_.jpg"
        },
        {
          "url": "https://m.media-amazon.com/images/I/71--EqxJ3BL._AC_SL1500_.jpg"
        },
        {
          "url": "https://m.media-amazon.com/images/I/71vvvPsWd+L._AC_SL1500_.jpg"
        }
      ],
      "videos": [
        {
          "title": "HP Laptop serie 15-fd (Intel)",
          "url": "https://m.media-amazon.com/images/S/vse-vms-transcoding-artifact-eu-west-1-prod/0cd16e93-1129-4228-b8db-33554705e2d4/default.jobtemplate.hls.m3u8",
          "thumbnail_url": "https://m.media-amazon.com/images/I/21j6NJwBXLL.SX522_.jpg",
          "duration_seconds": 6,
          "duration_timestamp": "00:06",
          "width": 1920,
          "height": 1080,
          "group_type": "IB_G1",
          "is_hero_video": false
        }
      ],
      "best_seller_rankings": [
        {
          "category": "Computers",
          "rank": 297
        },
        {
          "category": "Traditional Laptops",
          "rank": 5
        }
      ],
      "category_path": [
        {
          "name": "Computers",
          "link": "https://www.amazon.it/-/en/b/ref=dp_bc_1?ie=UTF8&node=425916031",
          "node": "425916031"
        },
        {
          "name": "Laptops",
          "link": "https://www.amazon.it/-/en/b/ref=dp_bc_2?ie=UTF8&node=460158031",
          "node": "460158031"
        },
        {
          "name": "Traditional Laptops",
          "link": "https://www.amazon.it/-/en/b/ref=dp_bc_3?ie=UTF8&node=30117766031",
          "node": "30117766031"
        }
      ],
      "technical_details": {
        "ASIN": "B0G1MQVMPF",
        "Audio Output Type": "Speakers",
        "Audio Recording": "Yes",
        "Audio features": "Number of built-in speakers: 2",
        "Automatic Backup Software Included": "Windows 11 Home",
        "Battery Cell Type": "Lithium Polymer",
        "Battery Life": "6.25 Hours",
        "Bluetooth Version": "5.4",
        "Bluetooth support?": "Yes",
        "Box Contents": "HP 15-fd1004sl",
        "Brand Name": "HP",
        "CPU L3 Cache": "24 MB",
        "CPU Model Generation": "Intel Core Ultra (Series 1)",
        "CPU Model Number": "155H",
        "CPU Model Speed Maximum": "4.8 GHz",
        "Cache Memory Installed Size": "24 MB",
        "Camera Description": "Front",
        "Chipset Type": "Intel SoC",
        "Colour": "Silver",
        "Colour Gamut Value": "62.5",
        "Compatible Devices": "HDMI, USB, Bluetooth, Wi-Fi devices",
        "Display Technology": "LCD",
        "Display Type": "LCD",
        "Form Factor": "Clamshell",
        "Graphics Coprocessor": "Intel Arc Graphics",
        "Graphics Description": "Integrated",
        "Graphics Ram Type": "Shared",
        "Hard Disk Description": "SSD",
        "Hard Disk Interface": "Solid State",
        "Hard-Drive Size": "512 GB",
        "Hardware Interface": "Bluetooth, HDMI, Headphone, USB 3.2 Gen 1, USB 3.2 Gen 2",
        "Human Interface Types": "Touch Pad",
        "Item Dimensions L x W x Thickness": "23.6L x 36W x 1.9Th centimetres",
        "Item Weight": "1590 Grams",
        "Keyboard Description": "Full Size",
        "Lithium Battery Energy Content": "41 Watt Hours",
        "Manufacturer": "HP",
        "Maximum Display Brightness": "250 Candela Per Square Meter",
        "Maximum Display Resolution": "1920x1080 Pixel",
        "Memory Clock Speed": "5600 MHz",
        "Memory Speed": "5600 MHz",
        "Microphone Form Factor": "Built-in microphone",
        "Model Name": "D15G4EA",
        "Model Number": "D15G4EA#ABZ",
        "Model Year": "2025",
        "Native Resolution": "1920 x 1080 pixels",
        "Network Connectivity Technology": "Bluetooth, HDMI, USB, Wi-Fi",
        "Notebook Pointing Device Description": "Touchpad",
        "Number Of Cells": "3",
        "Number of Ports": "4",
        "Operating Systems": "Windows 11 Home",
        "Optical Storage Device": "No",
        "Other Special Features of the Product": "Anti-glare coating (anti-reflective coating), Full Keyboard, Numeric keypad (numeric keypad)",
        "Power Device": "Power supply not included",
        "Processor Brand": "Intel",
        "Processor Count": "16",
        "Processor Series": "Intel Core Ultra 7",
        "Processor Speed": "1.4 GHz",
        "Product Warranty": "1 Year",
        "RAM Memory Installed": "16 GB",
        "RAM Memory Technology": "DDR5",
        "RAM Type": "DDR5 RAM",
        "Ram Memory Maximum Size": "16 GB",
        "Resolution": "1080p",
        "Screen Size": "15.6 Inches",
        "Speaker Description": "Number of built-in speakers: 2",
        "Specific Uses For Product": "Home",
        "Total HDMI Port": "1",
        "Total USB Ports": "3",
        "Touchpad Feature": "Numberpad",
        "UPC": "199896071215",
        "Video Output": "1 x HDMI",
        "Video Processor": "Intel",
        "Webcam Capability": "Yes",
        "Wi-Fi Generation": "Wi-Fi 6",
        "Wireless Compability": "802.11ax",
        "Wireless Technology Type": "Bluetooth, Wi-Fi"
      },
      "about_item": [
        "RELIABLE PERFORMANCE EVERY DAY: With an Intel Core Ultra 7 155H processor, 16GB of RAM and 512GB storage, this laptop delivers responsive performance for multitasking, content creation, and demanding tasks",
        "FHD ANTI-GLARE SCREEN: Enjoy crisp, detailed images on a large 15.6\" Full HD (1920 x 1080) display panel ensures accurate and consistent colour reproduction with up to 178° viewing angle",
        "Unlimited connectivity: Whether wired (USB, HDMI, USB-C) or wireless (Wi-Fi, Bluetooth), you can count on quick and easy connections to stay productive wherever you go",
        "EPEAT GOLD: EPEAT Gold registered products represent the highest level of rating and meet all criteria required by EPEAT",
        "WINDOWS 11: Familiarity and innovation together: a modern interface, intelligent AI features and advanced protection for a simple and powerful experience",
        "Ports: 2 USB Type-A 5Gbps signaling rate; 1 AC smart pin; 1 HDMI 1.4b; 1 headphone/microphone combo; 1 USB Type-C 10Gbps signaling rate (USB Power Delivery, DisplayPort 1.4b, HP Sleep and Charge)",
        "45W power supply not included in the package: recommended accessory, sold separately"
      ],
      "description": "From the manufacturer Previous page Next page",
      "reviews": [
        {
          "review_id": "R23HHG788W70SY",
          "author": "Daniele",
          "date": "Reviewed in Italy on 9 August 2026",
          "verified_purchase": true
        },
        {
          "review_id": "R131MNTVGUW596",
          "author": "Gianfranco",
          "date": "Reviewed in Italy on 6 August 2026",
          "verified_purchase": true
        },
        {
          "review_id": "R2YSY1UE1SBBD9",
          "author": "Cliente Amazon",
          "date": "Reviewed in Italy on 31 July 2026",
          "verified_purchase": true
        }
      ],
      "deal": {
        "deal_id": "d4feb077",
        "label": "Limited time deal",
        "discount_percent": 8,
        "price_before_deal": 599.99
      },
      "amazon_choice": false,
      "best_seller": false,
      "climate_pledge_friendly": true,
      "status": "success"
    }
  }
]
```

**Without enrichment (both false):**

```json
[
  {
    "asin": "B0G1MQVMPF",
    "title": "HP Laptop 15-fd1004sl, 15\" Laptop, FHD Display, Notebook, (Intel Core Ultra 7 155H, RAM 16GB, SSD 512GB, Windows 11), Laptop, Daily Use, Italian Keyboard, QWERTY, Silver",
    "url": "https://www.amazon.it/-/en/HP-15-fd1004sl-Display-Notebook-Keyboard/dp/B0G1MQVMPF/ref=sr_1_1?dib=eyJ2IjoiMSJ9.RTwssI-S-LMCX4qSc2nhun61nJwbUBl1vYUf2-hqkLu_CSjRutYtCITugiUZ0JpvAIVQnKQUS1yWadusnuB3piTRHSQ8Uy2YwiwBGztoTtZyWtId0AmYKQWZktr282_4y6TyfbB4li5W9HqEGxdmwij-BpeBA06JuHVwhf1UqpRORZFNQ3XcUVnTpaYNZoOiRAOoHR9-MQtww5jXR79m9lSGWoVhUNda_L-Zwyb-Ksd2OyB6Db0n_iGfs4rxFo1xGCQXKVqoCIx5aPSLn0QBvzEzgnSX3l2OT-1hlBces8s.4Ro4uMDrXzaO1nUXxDgCz0PEKShQXuoRzGO7Fp2GQxw&dib_tag=se&keywords=laptop&qid=1787736489&sr=8-1",
    "imageUrl": "https://m.media-amazon.com/images/I/61dyRuH3ocL._AC_UL320_.jpg",
    "price": {
      "currencyCode": "EUR",
      "amount": 549.99
    },
    "rating": {
      "value": 4.5,
      "count": 0,
      "stars": 5
    },
    "reviewCount": "(4)",
    "isSponsored": false,
    "position": 3,
    "badge": "Limited time deal",
    "sales_volume": "100+ bought in past month",
    "delivery": {
      "isFree": true,
      "date": "Thu 3 Sept",
      "rawText": "FREE delivery Thu 3 Sept"
    }
  }
]
```

**Notes**:

- If `offer_listing=false`, the `offers` field is omitted
- If `detailed_info=false`, the `details` field is omitted
- If enrichment fails for an ASIN, the field is set to empty object `{}`

#### Max Products Limit

The Actor respects `max_products` strictly:

- Stops pagination as soon as the limit is reached
- If a page would exceed the limit, only takes what's needed
- **Important**: Never returns more than `max_products` items

**Example**: With `max_products=100`:

- Page 1: 50 products (total: 50)
- Page 2: 40 products (total: 90)
- Page 3: Takes only first 10 products to reach 100, stops pagination

### Offer Retrieval

When `offer_listing=true`:

- For each product in the final output, the Actor fetches seller offers
- Uses the product's ASIN to query the offer-listing endpoint
- Adds an `offers` field to each product with all available sellers
- If ASIN is missing/invalid or the request fails, sets `offers: {}`
- Errors on individual offers do NOT stop the Actor

### Product Details Retrieval

When `detailed_info=true`:

- For each product in the final output, the Actor fetches comprehensive product details
- Uses the product's ASIN to query the PDP (Product Detail Page) endpoint
- Adds a `details` field to each product with full product information
- Returned details include: specifications, descriptions, images, ratings, rankings, and more
- If ASIN is missing/invalid or the request fails, sets `details: {}`
- Errors on individual details do NOT stop the Actor

### Troubleshooting

#### No products found

- Verify the `keyword` is valid and has results on Amazon
- Check the `geocode` is supported
- Some searches may genuinely return no results

#### Offers are empty `{}`

- Normal if the product has limited offers
- Check offer-listing endpoint is working in Scrape.do

#### Details are empty `{}`

- Normal if the product page is unavailable or content is blocked
- Some products may have restricted access

# Actor input Schema

## `keyword` (type: `string`):

Search term for Amazon products

## `ASINs` (type: `array`):

List of explicit Amazon product ASINs to fetch. The max\_products parameter does not affect these explicitly specified ASINs.

## `geocode` (type: `string`):

Geographic code (e.g. 'it' for Italy, 'en' for USA)

## `max_products` (type: `integer`):

Maximum total number of products to return. When the limit is reached, the Actor stops pagination and does not process additional products.

## `offer_listing` (type: `boolean`):

When enabled, retrieves every seller listing for a specific product, including pricing, shipping costs, seller information, and Buy Box status. This is the same data you see on Amazon's 'All Offers' page (structured as JSON for easy price comparison, seller analysis, and competitive intelligence).

## `detailed_info` (type: `boolean`):

When enabled, extracts comprehensive product information from any Amazon product page. It returns structured JSON data including the product title, pricing, ratings, images, long-form description, best seller rankings, and technical specifications (all parsed and ready to use without any HTML processing on your end)

## Actor input object example

```json
{
  "keyword": "laptop",
  "ASINs": [],
  "geocode": "it",
  "max_products": 1,
  "offer_listing": false,
  "detailed_info": false
}
```

# Actor output Schema

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

No description

# API

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

## JavaScript example

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

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

// Prepare Actor input
const input = {
    "keyword": "laptop",
    "ASINs": [],
    "geocode": "it",
    "max_products": 1
};

// Run the Actor and wait for it to finish
const run = await client.actor("ilborso/amazon-product-finder").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 = {
    "keyword": "laptop",
    "ASINs": [],
    "geocode": "it",
    "max_products": 1,
}

# Run the Actor and wait for it to finish
run = client.actor("ilborso/amazon-product-finder").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 '{
  "keyword": "laptop",
  "ASINs": [],
  "geocode": "it",
  "max_products": 1
}' |
apify call ilborso/amazon-product-finder --silent --output-dataset

```

## MCP server setup

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

```

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/gxa6BcmCwJ0t6SP4R/builds/ggY22Q3omSER1yXg2/openapi.json