Etsy Product Scraper

Search Etsy and get back clean, structured product data — price, discount, rating, review count, shop, category, and images. Give it one or more search terms (or direct listing links) and it returns the real listings Etsy shows.

Use this actor to:

• Market research — see what's selling, at what price, for a given product niche
• Competitor tracking — monitor specific shops' pricing, discounts, and ratings over time
• Price comparison — pull current prices across many search terms at once
• Sourcing & trend spotting — scan a category for popular, well-reviewed listings

Features

• Real, live Etsy data — anti-bot is handled by the scraping backend, so you don't manage proxies or fingerprints
• Rich fields: price, discount, currency, rating, item review count, images, shop name, category, and breadcrumbs
• Search by keyword or scrape a specific listing URL directly
• Control how many results you want per search

Input

Field	Type	Description
searchQueries	array	Keywords to search on Etsy, e.g. "handmade necklace". Each keyword is discovered separately.
listingUrls	array	Optional direct Etsy listing URLs to scrape instead of / alongside a search
maxItemsPerQuery	number	Maximum number of products to collect per search (default: 3, max: 250)

Example input

{
  "searchQueries": ["handmade necklace", "ceramic mug"],
  "maxItemsPerQuery": 5
}

What data you get

Each product includes:

Field	Description
product_id	Etsy listing id
url	Link to the listing on Etsy
title	Product title
final_price / initial_price	Current and original (list) price
discount_percentage	Discount off the original price, when on sale
currency	ISO currency code (e.g. USD)
rating	Star rating (1–5)
reviews_count_item	Number of reviews on the listing
seller_shop_name	Shop name
root_category	Product category
breadcrumbs	Category path
images	Product image URLs
search_query	Which search this result came from
scraped_at	When the data was collected

Output sample

{
  "product_id": "1883519936",
  "url": "https://www.etsy.com/listing/1883519936/secret-message-envelope-necklace-best",
  "title": "Secret Message Envelope Necklace, Best Friend Gift, Personalized Friendship Jewelry",
  "final_price": 9.87,
  "initial_price": 19.74,
  "discount_percentage": 50,
  "currency": "USD",
  "rating": 4.8,
  "reviews_count_item": 287,
  "seller_shop_name": "MishiuFerris",
  "root_category": "Jewelry < Necklaces < Lockets",
  "images": ["https://i.etsystatic.com/12416984/r/il/943fab/6765551533/il_fullxfull.6765551533_ra0y.jpg"],
  "breadcrumbs": ["Jewelry", "Necklaces", "Lockets"],
  "search_query": "handmade necklace"
}

Notes

• Keyword search discovers new listings for each term. For broader coverage, use several related search terms.
• If a term has no matching listings, that search returns no rows; if nothing at all can be collected, the run fails with a clear error instead of returning misleading empty data.

License

MIT

Disclaimer

This is an unofficial Actor. It is not affiliated with, endorsed by, or sponsored by Etsy, Inc. All product names, logos, and trademarks are the property of their respective owners and are used here for identification purposes only.

The Actor collects only publicly available information. It does not log in, create accounts, bypass paywalls, or access anything that is not visible to an ordinary visitor.

You are responsible for how you use the collected data, including compliance with applicable law and the source website's terms.