---

Etsy Product Search Spider

Introduction

The Etsy Product Search Spider is a powerful tool designed to automate the extraction of product data from Etsy based on specified keywords. This Apify Actor enables users to efficiently gather detailed information about products for various applications, including market research and competitive analysis.

Features

• Automated Data Extraction: Seamlessly scrape product details using customizable search terms.
• High-Quality Data: Reliable and accurate product information with comprehensive attributes.
• Flexible Configuration: Set item limits and keywords to tailor the scraping process.
• Efficient Performance: Optimized for speed and efficiency, ensuring timely data retrieval.
• Versatile Output Formats: Export results in JSON, CSV, or Excel formats.

Input Parameters

Parameter	Type	Required	Description	Example
Keywords	Array	No	The keywords for the spider.	["phone cover"]
item_limit	Integer	No	Maximum items to scrape per actor run. Set to 0 for no limit.	10

Example Usage

Input JSON

{
  "Keywords": ["phone cover"],
  "item_limit": 10
}

Output JSON

[
  {
    "title": "Real Pressed Flower Phone Case for iPhone 17 16 15 14 13 12 11 Pro Max X case, Samsung S23 S24 25 26 Ultra case, Google Pixel 8 9 Pro case",
    "price": "30.27",
    "currency_code": "USD",
    "url": "https://www.etsy.com/listing/1634486966/real-pressed-flower-phone-case-for",
    "shop_average_rating": "4.88",
    "shop_total_rating_count": "11747",
    "origin_country_id": 219,
    "min_processing_days": 3,
    "max_processing_days": 7,
    "origin_postal_code": "",
    "are_returns_accepted": true,
    "are_exchanges_accepted": true,
    "return_deadline_in_days": 30,
    "image_urls": [
      "https://i.etsystatic.com/25926642/r/il/9da8fb/6325793285/il_fullxfull.6325793285_227x.jpg"
    ],
    "actor_id": "Txmp6U3yfjDMuLKBw",
    "run_id": "buW3U6XYsfEBvzEuT"
  },
  {
    "title": "Stained Glass Wildflower Phone Case – Mosaic Floral Cover for Samsung S26 Ultra S25 FE S24 S23 iPhone 17 Pro Max 16 15 Plus 14 13 Pixel 10",
    "price": "27.76",
    "currency_code": "USD",
    "url": "https://www.etsy.com/listing/4470243048/stained-glass-wildflower-phone-case",
    "shop_average_rating": "4.8",
    "shop_total_rating_count": "4535",
    "origin_country_id": 146,
    "min_processing_days": 1,
    "max_processing_days": 2,
    "origin_postal_code": "LV1006",
    "are_returns_accepted": true,
    "are_exchanges_accepted": true,
    "return_deadline_in_days": 21,
    "image_urls": [
      "https://i.etsystatic.com/27459213/r/il/189807/7841696321/il_fullxfull.7841696321_2mmy.jpg"
    ],
    "actor_id": "Txmp6U3yfjDMuLKBw",
    "run_id": "buW3U6XYsfEBvzEuT"
  }
]

Use Cases

• Market Research and Analysis: Gain insights into product trends and consumer preferences.
• Competitive Intelligence: Monitor competitor offerings to inform strategic decisions.
• Price Monitoring: Track pricing changes across different products for competitive pricing strategies.
• Content Aggregation: Collect data for content creation, such as blogs or market reports.
• Academic Research: Use the data for research projects and academic studies in e-commerce.
• Business Automation: Integrate with business processes to automate data-driven decision-making.

Installation and Usage

1. Search for "Etsy Product Search Spider" in the Apify Store.
2. Click "Try for free" or "Run".
3. Configure input parameters as needed.
4. Click "Start" to begin extraction.
5. Monitor progress in the log.
6. Export results in your preferred format (JSON, CSV, Excel).

Output Format

The output is a JSON array of product objects, each containing:

• title: Product title
• price: Product price
• currency_code: Currency code for the price
• url: URL to the Etsy listing
• shop_average_rating: Average shop rating
• shop_total_rating_count: Total number of ratings
• origin_country_id: Country ID where the product is made
• min_processing_days and max_processing_days: Estimated processing time
• origin_postal_code: Postal code of origin
• are_returns_accepted, are_exchanges_accepted: Return and exchange policies
• return_deadline_in_days: Deadline for returns in days
• image_urls: List of image URLs
• actor_id and run_id: Unique identifiers for the actor run

Error Handling Information

The Actor is designed to handle common errors such as network issues or changes in Etsy's HTML structure. If an error occurs, it will be logged, and you can review these logs to understand what went wrong. For persistent issues, please contact support.

Rate Limiting and Best Practices

To avoid being blocked by Etsy, adhere to the following best practices:

• Use a reasonable item_limit to prevent overloading the server.
• Avoid running multiple instances simultaneously on the same account.
• Respect Etsy's terms of service regarding data scraping.

Limitations and Considerations

• The Actor may not capture all product variations or options available on Etsy.
• Changes in Etsy’s website structure can affect data extraction accuracy.
• Ensure compliance with Etsy’s terms of use when using scraped data.