Amazon Product Description Actor Documentation

Introduction

The Amazon Product Description Actor is a powerful tool that allows you to extract detailed product information from Amazon product pages. This actor scrapes essential details such as pricing, features, specifications, ratings, and more, transforming them into structured JSON data for your use.

This documentation will guide you through setting up and using the actor, even if you're new to Apify or web scraping.

What This Actor Does

The actor takes an Amazon product URL as input and returns comprehensive product data including:

• Basic product information (title, ASIN, brand)
• Current pricing and deals
• Customer ratings and review count
• Product availability
• Features and specifications
• Images
• Color/style variants
• Seller information
• Shipping details
• And more!

Prerequisites

• An Apify account (register at apify.com)
• Basic understanding of JSON format

Getting Started

Step 1: Access the Actor

1. Log in to your Apify account
2. Navigate to the Amazon Product Description Actor page
3. Click "Try Actor" to test it without deploying

Step 2: Configure Input

The actor requires a simple JSON input:

1{
2  "productUrl": "https://www.amazon.com/your-product-url"
3}

If no URL is provided, the actor will use a default example URL.

Step 3: Run the Actor

Click the "Run" button to start the actor. The actor will:

1. Visit the specified Amazon product page
2. Extract all available product data
3. Structure the data into JSON format
4. Save the results to your Apify storage

Step 4: View Results

Once the run completes:

1. Go to the "Storage" tab
2. Find your run in the "Dataset" section
3. View or download the extracted data in JSON format

Input Parameters

Parameter	Type	Required	Description
productUrl	String	Yes	The full URL of the Amazon product page you want to scrape

Output Data Structure

The actor returns a comprehensive JSON object with the following structure:

1{
2  "asin": "B0BRKPVZB4",
3  "title": "Product title...",
4  "prices": {
5    "price": { "currency": "$", "value": 43.99, "formatted": "$43.99" },
6    "regular_price": { ... },
7    "deal_price": { ... },
8    "prime_with_price": { ... },
9    "price_without_prime": { ... }
10  },
11  "rating": "4.4",
12  "review_count": 23236,
13  "purchase_count": "10K+ bought in past month",
14  "availability": "In Stock Only 2 left in stock - order soon.",
15  "features": [ "Feature 1", "Feature 2", ... ],
16  "main_image": "https://image-url.jpg",
17  "images": [ "url1", "url2", ... ],
18  "variants": [ { ... variant details ... } ],
19  "brand": "Brand name",
20  "categories": [ { ... category details ... } ],
21  "specifications": { ... detailed specs ... },
22  "prime_eligible": false,
23  "amazon_choice": true,
24  "best_seller": false,
25  "shipping": { ... shipping details ... },
26  "seller": { ... seller info ... },
27  "source_url": "original-url",
28  "timestamp": "2025-04-18T12:35:39.836Z"
29}

Use Cases

• Price monitoring and comparison
• Product research and analysis
• E-commerce data enrichment
• Market research
• Building product catalogs
• Competitive analysis

Integration Examples

Using with Node.js

1import { ApifyClient } from 'apify-client';
2
3const client = new ApifyClient({
4    token: 'YOUR_API_TOKEN',
5});
6
7const input = {
8    productUrl: 'https://www.amazon.com/your-product-url',
9};
10
11// Run the actor and wait for it to finish
12const run = await client.actor('pintostudio/amazon-product-description').call(input);
13
14// Fetch and print actor results
15const { items } = await client.dataset(run.defaultDatasetId).listItems();
16console.log('Products:', items);

Using with Python

1from apify_client import ApifyClient
2
3client = ApifyClient(token='YOUR_API_TOKEN')
4
5run_input = {
6    'productUrl': 'https://www.amazon.com/your-product-url'
7}
8
9# Run the actor and wait for it to finish
10run = client.actor('pintostudio/amazon-product-description').call(run_input=run_input)
11
12# Fetch and print actor results
13items = client.dataset(run['defaultDatasetId']).list_items().items
14print('Products:', items)

Example Output

Here's a sample of what the extracted data might look like for a Bluetooth speaker:

1{
2  "asin": "B0BRKPVZB4",
3  "title": "Bluetooth Speaker with HD Sound, Portable Wireless, IPX5 Waterproof, Up to 20H Playtime, TWS Pairing, BT5.3...",
4  "prices": {
5    "price": {"currency": "$", "value": 43.99, "formatted": "$43.99"},
6    "prime_with_price": {"currency": "$", "value": 24.61, "formatted": "$24.61"}
7  },
8  "rating": "4.4",
9  "review_count": 23236,
10  "availability": "In Stock Only 2 left in stock - order soon.",
11  "features": [
12    "Immersive Sound Experience & Dual Connectivity",
13    "Tough & Weather-Resistant",
14    "Long-lasting Playtime & Extended Bluetooth Connectivity",
15    "Vibrant Light Effects",
16    "Everything You Need"
17  ],
18  "specifications": {
19    "Model Name": "C27C",
20    "Speaker Type": "Built-In",
21    "Battery Life": "24 Hours",
22    "Is Waterproof": "True",
23    "Maximum Range": "33 Feet"
24  }
25}

Limitations

• Some product information may vary based on region, user account, or time of scraping

Troubleshooting

If you encounter issues:

1. Actor fails to run: Verify the product URL is valid and accessible
2. Missing data: Some products may not have all fields available (e.g., no variants)

Best Practices

• Use the actor for legitimate research purposes
• Don't make excessive concurrent requests to Amazon
• Consider adding delays between requests if running multiple times

Support

If you need assistance with this actor:

• Check the Apify documentation at docs.apify.com
• Contact us through our main page
• Contact us via Telegram: @pintoflow

Happy coding!