Etsy Product Details Actor Documentation

Overview

The Etsy Product Details Actor is a powerful Apify scraper designed to extract comprehensive product information from Etsy listings. This actor retrieves detailed product data including pricing, inventory, images, descriptions, and metadata from any Etsy product URL.

Features

• Complete Product Information: Extracts all essential product details including title, description, pricing, and availability
• Multi-Currency Support: Retrieve pricing information in different currencies (USD, EUR, GBP, etc.)
• Localization Options: Support for multiple languages and country-specific data
• Rich Media Data: Captures all product images with detailed metadata (dimensions, colors, blur hashes)
• Inventory Details: Real-time stock availability and quantity information
• Shop Information: Includes seller details and shop metadata
• Taxonomy Data: Product categorization and tagging information
• No Proxy Required: Lightweight implementation that works without proxy configuration

Input Parameters

The actor accepts the following input parameters:

Parameter	Type	Required	Default	Description
productUrl	String	No	Sample URL	The full Etsy product listing URL
currency	String	No	USD	Currency code for pricing (USD, EUR, GBP, CAD, etc.)
language	String	No	en-GB	Language code for localized content (en-US, de, fr, es, etc.)
country	String	No	US	Country code for region-specific data

Input Example

{
  "productUrl": "https://www.etsy.com/listing/4373914722/custom-photo-hunting-ornament-hunting",
  "currency": "USD",
  "language": "en-GB",
  "country": "US"
}

Output Data Structure

The actor returns a comprehensive JSON object containing the following sections:

Basic Information

• listingId: Unique identifier for the listing
• shopId: Shop identifier
• title: Product title
• description: Full product description
• state: Listing status (active, sold out, etc.)
• url: Direct link to the product
• shopName: Name of the seller's shop

Pricing

• price: Formatted price
• priceInt: Price in cents/smallest currency unit
• currencyCode: Currency code
• currencySymbol: Currency symbol
• formattedPrice: Human-readable price string

Inventory

• quantity: Available stock
• isAvailable: Availability status
• isSoldOut: Whether the product is sold out
• isActive: Listing active status

Product Details

• categoryName: Product category
• tags: Array of product tags
• materials: Materials used
• whenMade: Production method (made_to_order, etc.)
• isMadeToOrder: Custom order flag
• isCustomizable: Customization availability
• isDigital: Digital product flag
• shipsFromCountry: Origin country

Media

• images: Array of image URLs
• imageDetails: Detailed image metadata including:
  • Dimensions (width/height)
  • Color codes
  • Blur hashes
  • Saturation and hue values

Metrics

• views: Number of views
• favorites: Favorite count
• isBestseller: Bestseller status
• isTopRated: Top-rated flag

Dates

• created: Creation timestamp
• updated: Last update timestamp

Additional Information

• Payment methods
• Shipping details
• Localization options
• Taxonomy hierarchy
• Shop section information

Output Example

{
  "basic": {
    "listingId": 4373914722,
    "title": "Custom Photo Hunting Ornament...",
    "state": "active",
    "shopName": "CraftopiaByLH"
  },
  "pricing": {
    "price": 18.72,
    "currencyCode": "USD",
    "formattedPrice": "$18.72"
  },
  "inventory": {
    "quantity": 1801,
    "isAvailable": true
  },
  "media": {
    "images": ["https://i.etsystatic.com/..."],
    "imageDetails": [...]
  }
}

Use Cases

E-commerce Analytics

• Track competitor pricing and inventory
• Monitor product availability
• Analyze product descriptions and marketing strategies

Market Research

• Collect data on trending products
• Analyze pricing strategies across sellers
• Study product categorization and tagging

Price Monitoring

• Track price changes over time
• Compare prices across different currencies
• Identify pricing patterns

Inventory Management

• Monitor stock levels
• Track product availability
• Get alerts on low inventory

Content Aggregation

• Build product catalogs
• Create comparison websites
• Aggregate product information for marketplaces

Technical Details

Implementation

• Built with Apify SDK
• Uses Axios for HTTP requests
• ESM module structure
• Error handling and validation included

Performance

• Fast execution time
• Minimal resource usage
• No proxy configuration required
• Efficient data extraction

Data Storage

• Results saved to Apify dataset
• Output stored in key-value store
• Supports batch processing

Error Handling

The actor includes robust error handling:

• Validates input parameters
• Catches and logs errors
• Provides meaningful error messages
• Graceful failure with proper exit codes

Best Practices

1. URL Validation: Ensure product URLs are valid and properly formatted
2. Rate Limiting: Be mindful of request frequency to avoid rate limits
3. Currency Codes: Use standard ISO 4217 currency codes
4. Language Codes: Use ISO 639-1 language codes
5. Batch Processing: For multiple products, process in manageable batches

Limitations

• Requires valid Etsy product URLs
• Respects Etsy's robots.txt and terms of service
• Real-time data only (no historical tracking built-in)
• Some data may vary based on user location and settings

Support and Updates

For issues, feature requests, or questions:

• Check the Apify platform documentation
• Contact us

Version History

• Current Version: 1.0
• Initial release with comprehensive product data extraction
• Support for multiple currencies and languages
• Full media and metadata extraction

---