Etsy Product Search Scraper

Extract Etsy product listings by keyword and collect structured product, shop, shipping, return-policy, and image information.

What is the Etsy Product Search Scraper?

The Etsy Product Search Scraper is designed to collect product listings from Etsy based on product search keywords. It extracts structured information from matching product listings, including product titles, prices, currencies, product URLs, shop ratings, shipping-related information, return policies, and product image URLs.

The extracted data is stored in a structured Apify Dataset, making it suitable for marketplace research, product analysis, competitor research, pricing analysis, and other data-processing workflows.

What Can This Etsy Scraper Extract?

The Actor extracts the following information for each product listing:

Field	Description
title	Full title of the Etsy product listing.
price	Listed product price.
currency_code	Currency code associated with the product price, such as USD.
url	Direct URL of the Etsy product listing.
shop_average_rating	Average rating of the shop selling the product.
shop_total_rating_count	Total number of ratings associated with the shop.
origin_country_id	Country identifier associated with the product's shipping origin.
min_processing_days	Minimum processing time indicated for the product.
max_processing_days	Maximum processing time indicated for the product.
origin_postal_code	Postal code associated with the product's shipping origin.
are_returns_accepted	Indicates whether returns are accepted for the product.
are_exchanges_accepted	Indicates whether exchanges are accepted for the product.
return_deadline_in_days	Number of days specified for the applicable return period. A value of 0 may indicate that no return period is specified or applicable.
image_urls	Array containing image URLs associated with the product listing.

Key Features

• Search Etsy products using keywords
• Extract structured product information
• Collect product pricing and currency information
• Extract shop rating and rating-count information
• Collect shipping-origin information
• Extract minimum and maximum processing days
• Extract return and exchange policy information
• Collect product image URLs
• Configurable item limit
• Apify Proxy configuration support
• Store results in an Apify Dataset

Quick Start

Getting started is straightforward:

1. Open the Etsy Product Search Scraper in the Apify Console.
2. Enter the product keywords you want to search for.
3. Set the desired itemLimit.
4. Configure the Apify Proxy if required.
5. Start the Actor.
6. When the run finishes, open the Dataset tab to view or export the results.

Input

The Actor accepts the following input parameters:

Parameter	Type	Required	Description
keywords	Array	Yes	Product search keywords used to find matching Etsy listings.
itemLimit	Integer	Yes	Maximum number of product items to collect.
proxyConfiguration	Object	No	Configuration for using the Apify Proxy.
proxyConfiguration.useApifyProxy	Boolean	No	Determines whether the Apify Proxy is enabled.

Input Parameters Explained

keywords

An array containing the product search terms you want to use.

Example:

{
  "keywords": ["flower"]
}

itemLimit

Controls the number of product results to collect.

Example:

{
  "itemLimit": 100
}

proxyConfiguration

Optional proxy settings for the Actor.

Example:

{
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

Input Example

{
  "keywords": [
    "phone cover"
  ],
  "itemLimit": 100,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

Output

The Actor stores the extracted product listings in an Apify Dataset.

Each dataset item represents a product listing and contains product information, shop information, processing details, return-policy information, and image URLs.

Output Structure

Product
├── title
├── price
├── currency_code
├── url
├── shop_average_rating
├── shop_total_rating_count
├── origin_country_id
├── min_processing_days
├── max_processing_days
├── origin_postal_code
├── are_returns_accepted
├── are_exchanges_accepted
├── return_deadline_in_days
└── image_urls
    └── image URL

Output Example

{
  "title": "Flower Wall Backdrop [Pink Petal Rose Garden Roll-Up Fabric Panel] for Ceremony & Photo Booth",
  "price": "400.00",
  "currency_code": "USD",
  "url": "https://www.etsy.com/listing/1267811367/wedding-flower-wall-backdrop-pink-rose",
  "shop_average_rating": "4.87",
  "shop_total_rating_count": "2507",
  "origin_country_id": 209,
  "min_processing_days": 1,
  "max_processing_days": 2,
  "origin_postal_code": "77060",
  "are_returns_accepted": false,
  "are_exchanges_accepted": false,
  "return_deadline_in_days": 0,
  "image_urls": [
    "https://i.etsystatic.com/23442336/r/il/dbeabc/4849979857/il_fullxfull.4849979857_ouu5.jpg"
  ]
}

Understanding the Output

Product Information

The title, price, currency_code, and url fields identify the product and provide its listed price and direct Etsy listing URL.

Shop Information

The shop_average_rating and shop_total_rating_count fields provide rating information associated with the shop selling the product.

Processing and Shipping Information

The origin_country_id, origin_postal_code, min_processing_days, and max_processing_days fields provide information about the product's shipping origin and processing timeframe.

Return and Exchange Information

The are_returns_accepted and are_exchanges_accepted fields indicate whether returns and exchanges are accepted.

The return_deadline_in_days field represents the specified return period in days. In the supplied example, the value is 0 and both returns and exchanges are not accepted.

Product Images

image_urls is an array containing image URLs associated with the product listing. A product may contain one or more image URLs depending on the available listing data.

Use Cases

The extracted Etsy product data can be useful for several purposes.

Marketplace Research

Collect product information for researching products and categories available on Etsy.

Competitor Research

Compare product prices, shop ratings, processing times, and policies across listings.

Pricing Analysis

Analyze listed product prices and currencies across search results.

Shop Analysis

Study shop ratings and rating counts alongside individual product listings.

Product Research

Discover products matching specific search terms and organize their details into structured datasets.

Shipping and Policy Research

Compare processing times, shipping-origin information, return policies, and exchange policies across products.

Data Analysis

Export the dataset for further analysis, reporting, visualization, or integration with external workflows.

Using the Output

After an Actor run is completed, the extracted products are available in the Apify Dataset.

You can use the dataset for further processing through available Apify dataset options, APIs, exports, integrations, or external applications.

A typical workflow looks like this:

Etsy Search Keywords
        ↓
Etsy Product Search Scraper
        ↓
Apify Dataset
        ↓
JSON / CSV / Excel / API
        ↓
Analysis / Automation / Application

The structured output can be incorporated into data-analysis tools, databases, applications, or other workflows.

Proxy Configuration

The Actor supports an optional proxyConfiguration parameter.

To enable the Apify Proxy, use:

{
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

Proxy configuration can be useful when making requests through Apify's proxy infrastructure.

Proxy usage does not guarantee successful access to the source website, and scraping behavior can vary depending on source-website conditions and configuration.

Important Notes

• The keywords parameter should contain the product search terms you want to use.
• itemLimit controls the maximum number of product items collected.
• The availability and completeness of extracted information depend on the data available from Etsy at the time of the run.
• Product prices and currencies may vary between listings.
• Shop ratings and rating counts can change over time.
• Processing times and return policies can vary between sellers and products.
• image_urls may contain one or more image URLs depending on the listing data available.
• A return_deadline_in_days value of 0 does not by itself indicate a specific return period; interpret it together with the return-policy fields.
• Source websites can change their page structure, which may affect data extraction.
• Proxy configuration is optional.
• Use extracted data responsibly and in accordance with applicable laws, website terms, and data-use requirements.

Support

If you experience problems with the Actor, contact the support team.

Email: support@getdataforme.com

Website: getdataforme.com/contact

When contacting support, please provide:

• Actor name
• Input configuration
• Error message
• Relevant logs
• Expected result
• Actual result

Providing these details helps the support team investigate and reproduce issues more efficiently.

Start Scraping

Ready to collect Etsy product data?

Enter your product keywords, choose the desired item limit, configure the Apify Proxy if needed, and start the Actor.

Your extracted product listings will be available in the Apify Dataset in a structured format, ready for analysis and further processing.