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: json { "productUrl": "https://www.amazon.com/your-product-url" } 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: json { "asin": "B0BRKPVZB4", "title": "Product title...", "prices": { "price": { "currency": "$", "value": 43.99, "formatted": "$43.99" }, "regular_price": { ... }, "deal_price": { ... }, "prime_with_price": { ... }, "price_without_prime": { ... } }, "rating": "4.4", "review_count": 23236, "purchase_count": "10K+ bought in past month", "availability": "In Stock Only 2 left in stock - order soon.", "features": [ "Feature 1", "Feature 2", ... ], "main_image": "https://image-url.jpg", "images": [ "url1", "url2", ... ], "variants": [ { ... variant details ... } ], "brand": "Brand name", "categories": [ { ... category details ... } ], "specifications": { ... detailed specs ... }, "prime_eligible": false, "amazon_choice": true, "best_seller": false, "shipping": { ... shipping details ... }, "seller": { ... seller info ... }, "source_url": "original-url", "timestamp": "2025-04-18T12:35:39.836Z" } ## 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 javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_API_TOKEN', }); const input = { productUrl: 'https://www.amazon.com/your-product-url', }; // Run the actor and wait for it to finish const run = await client.actor('pintostudio/amazon-product-description').call(input); // Fetch and print actor results const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log('Products:', items); ### Using with Python python from apify_client import ApifyClient client = ApifyClient(token='YOUR_API_TOKEN') run_input = { 'productUrl': 'https://www.amazon.com/your-product-url' } # Run the actor and wait for it to finish run = client.actor('pintostudio/amazon-product-description').call(run_input=run_input) # Fetch and print actor results items = client.dataset(run['defaultDatasetId']).list_items().items print('Products:', items) ## Example Output Here's a sample of what the extracted data might look like for a Bluetooth speaker: json { "asin": "B0BRKPVZB4", "title": "Bluetooth Speaker with HD Sound, Portable Wireless, IPX5 Waterproof, Up to 20H Playtime, TWS Pairing, BT5.3...", "prices": { "price": {"currency": "$", "value": 43.99, "formatted": "$43.99"}, "prime_with_price": {"currency": "$", "value": 24.61, "formatted": "$24.61"} }, "rating": "4.4", "review_count": 23236, "availability": "In Stock Only 2 left in stock - order soon.", "features": [ "Immersive Sound Experience & Dual Connectivity", "Tough & Weather-Resistant", "Long-lasting Playtime & Extended Bluetooth Connectivity", "Vibrant Light Effects", "Everything You Need" ], "specifications": { "Model Name": "C27C", "Speaker Type": "Built-In", "Battery Life": "24 Hours", "Is Waterproof": "True", "Maximum Range": "33 Feet" } } ## 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!