🛒 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
url	String	Conditional	None	Direct link to a specific Amazon product.
asin	String	Conditional	None	Amazon Standard Identification Number (e.g. B08N5WRWNW).
proxy_url	String	No	None	Optional custom proxy URL.

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

Example Input:

{
  "url": "https://www.amazon.com/dp/B08N5WRWNW"
}

📤 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": "B08N5WRWNW",
      "title": "Godrej 30 L Qube Personal Standard Single door Cooling Solution (TEC Qube 30L HS Q103, Black)",
      "brand": "Visit the Godrej Store",
      "price": 7990.0,
      "price_text": "₹7,990.00",
      "rating": "3.7 out of 5 stars",
      "rating_value": 3.7,
      "review_count": 2535,
      "image": "https://m.media-amazon.com/images/I/51I44UB4OfL._SX679_.jpg",
      "url": "https://www.amazon.com/dp/B08N5WRWNW",
      "in_stock": true,
      "availability": "In stock"
    }
  ]
}

🚀 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: Python Entrypoint (Fastest)

Just run the Python entrypoint script directly. If no input configuration file 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:

   python main.py
   # or using uv
   uv run python main.py
   

3. Enter your product URL 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 the Actor directory.
2. Add your input JSON, for example:

   {
     "url": "https://www.amazon.com/dp/B08N5WRWNW"
   }
   

3. Run the actor using the command:

   python main.py
   # or using uv
   uv run python main.py
   

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!