🛒 Amazon Product Scraper

Amazon Product Scraper is a powerful and fast Apify actor that uses Playwright and Google Chrome to extract live product details directly from Amazon search results or individual product pages.

🌟 Features

• Keyword Search: Extract product listings based on any search term.
• Direct ASIN / URL: Extract deep metadata from a single Amazon product page.
• Live Playwright Data: Uses real headless Google Chrome to bypass basic blocks and grab dynamic DOM data.
• Clean Output: Data is structured and delivered in JSON format suitable for e-commerce monitoring.

📥 Input Configuration

When running this actor, you need to configure the input. The actor takes a simple JSON object:

Field	Type	Required	Default	Description
query	String	Conditional	None	The keyword to search for (e.g. "Bluetooth Keyboard").
url	String	Conditional	None	Direct link to a specific Amazon product.
asin	String	Conditional	None	Amazon ASIN (e.g., "B0XXXXXXX").
country	String	No	US	Two-letter country code.
page	Integer	No	1	Page number to start scraping from.
max_results	Integer	No	20	Maximum number of products to scrape from search results.

Note: You must provide at least one of query, url, or asin.

Example Input (Search):

{
  "query": "Bluetooth Keyboard",
  "country": "US",
  "page": 1,
  "max_results": 20
}

📤 Output Configuration

The actor stores its results in the default Apify Dataset. The output will always be wrapped in a products array to ensure consistent data structures.

Example Output:

{
  "products": [
    {
      "asin": "B0XXXXXXX",
      "title": "Logitech K380 Bluetooth Keyboard",
      "price": 39.99,
      "rating": "4.6 out of 5 stars",
      "image": "https://m.media-amazon.com/images/I/sample.jpg",
      "url": "https://www.amazon.com/dp/B0XXXXXXX"
    }
  ]
}

🚀 How to Run Locally

If you are a developer and want to test this actor directly on your machine without using Docker, there are two easy methods:

Method 1: Interactive Terminal (Fastest)

Just run the Python module directly from the root of the project. If no Apify configuration is found, it will safely prompt you in the terminal.

1. Ensure you have uv and Python installed.
2. Run the actor using the command:

   $uv run python -m src.amazon_scraper
   

3. Enter your search query or ASIN into the terminal prompt.

Method 2: Simulate Apify using INPUT.json

To test exactly how it runs on the Apify platform, you can create a local JSON file that the Apify SDK automatically parses.

1. Create a file at storage/key_value_stores/default/INPUT.json inside your project root.
2. Add your input JSON, for example:

   {
     "query": "Bluetooth Keyboard",
     "max_results": 5
   }
   

3. Run the actor using the command:

   $uv run python -m src.amazon_scraper
   

4. The scraper will silently read the JSON file and dump the results into storage/datasets/default/.

🐳 Building with Docker

If you want to build the Docker image locally to test the exact environment Apify uses:

Because Apify projects use the root folder for context, you must run the build command from the root directory of the project, pointing it to the .actor/Dockerfile:

$docker build -t amazon-scraper -f .actor/Dockerfile .

💬 Support

If you find any bugs or have feature requests, please reach out via the Apify platform!