Etsy Search Scraper 2026

Scrape Etsy Data: Listings, Prices, Media & Shop Data at Scale

Etsy product research needs structured rows you can pivot, not screenshots you can scroll. The Etsy Product Data Scraper finds Etsy listings three ways - by keyword, by photo, or by an existing listing ID - and then enriches each listing with its full product details. Every record includes price and sale price, the complete image gallery and videos, tags, materials, taxonomy, shop location and sales, stock, and engagement signals. Run one query, batch a niche catalog, or hand over a photo and get visually matching products back.

🛒 What It Does

The Actor finds listings from any of three sources and then retrieves the full product detail for each one. Results come back already structured: title, price, sale price, all gallery images, videos, badges, and the sponsored-placement flag.

• Keyword search - one or more search terms.
• Search by photo - provide image URLs or base64 images and get visually similar Etsy products.
• Visually similar to a listing - provide Etsy listing IDs or URLs and get products that look like that listing.

With detail enrichment on (the default), the Actor also adds description, tags, materials, category, shop name, location, total shop sales, stock quantity, and rating data. Each row also tells you how it was found — the source column is search, image, or similar.

🛒 How It Works

You give the Actor one or more things to look for, and it returns matching Etsy listings with their details. There are three ways to search, and you can use them together in a single run:

• 🔎 By keyword — add search terms such as "ceramic mug" or "monster high". The Actor collects the listings Etsy shows for each term.
• 🖼️ By photo — add image links (or images as text). The Actor finds Etsy listings that look like each picture.
• 🎯 By listing ID — add an Etsy listing link or its ID. The Actor finds products that look like that listing's main photo.

How the results come together

1. The Actor searches every source you provide and gathers the listings it finds.
2. Duplicates are removed automatically, so the same product never appears twice.
3. Your Maximum Results limit is split evenly between the sources you use — for example, one keyword plus one photo with a limit of 20 returns up to 10 each.
4. With Full Product Details on, the Actor adds the description, tags, materials, category, shop and stock information for every listing.
5. Each row tells you how it was found: source is search, image, or similar, and source_input shows the exact query, image, or listing ID behind it.

🛒 Why use this Actor?

• Dropshippers and resellers building niche catalogs from real Etsy listings with prices, sales, stock, and media.
• Market researchers comparing shops, price ranges, categories, and bestsellers in a vertical.
• Visual sourcing - upload a product photo and find the Etsy listings that match what you are looking at.
• AI / ML teams training product-search and recommendation models on structured Etsy records.
• Trend hunters monitoring sponsored vs organic results, bestseller badges, and category shifts over time.

🛒 Data You Get

Field	Description
listing_id	Unique Etsy listing ID
title / title_en	Listing title from search / detail
price_num, price_int	Numeric price and minor-unit price
discount_price	Sale price when the listing is discounted
price_with_shipping	Price including shipping
has_variation_pricing	Whether the price varies by variant
currency_code	Currency (USD, EUR, GBP, …)
shop_name, shop_id, shop_url	Shop identity and link
shop_location, shop_sold_count	Shop location and total sales
shop_rating, shop_review_count	Shop reputation signals
rating, review_count	Listing rating and review count
image_url, images	Primary image and full gallery
videos	Product video URLs
detail_url	Direct link to the listing
quantity	Available stock
favorites	Demand signal (number of saves)
is_available, is_sold_out	Stock state
is_bestseller, is_top_rated, is_ad	Badges and sponsored flag
tags, materials	Seller tags and materials
ships_from_country, when_made	Shipping origin and production date
taxonomy_path, category_name, section_name	Category breadcrumb and shop section
description	Full product description
create_date, update_date	Listing created / last updated timestamps
source	How the listing was found: search, image, or similar
source_input	The query, image reference, or listing ID that produced the row

🛒 How to use it

1. Open the Actor and click Try for free — the input prefills with ["monster high"].
2. Edit searchQueries to one or more niche terms, or use the Search by Image section (photo or listing ID).
3. Search by photo: paste direct image links (not product pages) or base64 into imageSearch.
4. Visually similar: paste Etsy listing IDs or listing URLs into visuallySimilarListings.
5. Set maxListings and leave Enrich with Full Product Details on for the complete record.
6. Start the run and download the dataset as CSV, JSON, or Excel.

🛒 Input

Parameter	Type	Default	Description
searchQueries	array of strings	["monster high"]	One or more Etsy search terms.
imageSearch	array of strings	[]	A direct image link (any website) or base64 / data-URI image. Must point to the image itself, not to a product page. Returns visually similar products.
visuallySimilarListings	array of strings	[]	Etsy listing IDs or listing URLs. Returns visually similar products.
currency	string	USD	Currency for all prices (also sets the search region). Options: USD, EUR, GBP, CAD, AUD, JPY, INR, BRL.
maxListings	integer	48	Maximum unique listings across all queries, images, and listing IDs.
enrichWithDetails	boolean	true	Fetch the full product details for every listing.

🛒 Output

{
  "listing_id": "4577825069",
  "shop_id": "66534999",
  "title": "3D Printed Vase, Modern Ribbed Flower Vase, Sculptural Home Decor",
  "title_en": "3D Printed Vase, Modern Ribbed Flower Vase, Minimalist Table Centerpiece, Housewarming Gift",
  "description": "Fluted Ceramic Vase with Ruffled Rim...",
  "price": "$42.47",
  "price_num": 42.47,
  "price_int": 4247,
  "currency_code": "USD",
  "discount_price": "$16.99",
  "price_with_shipping": "$20.99",
  "has_variation_pricing": false,

  "shop_name": "Hexlayerworks",
  "shop_url": "https://www.etsy.com/shop/Hexlayerworks",
  "shop_location": "Pittsburgh, Pennsylvania",
  "shop_sold_count": 9,
  "shop_rating": 4.9,
  "shop_review_count": 128,

  "rating": 4.8,
  "review_count": 26,

  "image_url": "https://i.etsystatic.com/53330866/r/il/09da89/8261484691/il_fullxfull.8261484691_jdq2.jpg",
  "images": [
    "https://i.etsystatic.com/53330866/r/il/09da89/8261484691/il_fullxfull.8261484691_jdq2.jpg",
    "https://i.etsystatic.com/53330866/r/il/340bf5/8205227113/il_fullxfull.8205227113_shlt.jpg"
  ],
  "videos": ["https://v.etsystatic.com/c/video/upload/ac_none,du_15,q_auto:good/emsang5pqqtpkcsdpkej.mp4"],
  "detail_url": "https://www.etsy.com/listing/4577825069",

  "quantity": 887,
  "favorites": 3294,
  "is_available": true,
  "is_sold_out": false,
  "is_bestseller": false,
  "is_top_rated": false,

  "tags": ["3d printed vase", "modern flower vase", "ribbed vase"],
  "materials": ["PLA"],
  "ships_from_country": "US",
  "when_made": "made_to_order",
  "taxonomy_path": "Home And Living > Home Decor > Home Accents > Vases",
  "category_name": "",
  "section_name": "Vases",

  "is_ad": true,
  "create_date": 1790879142,
  "update_date": 1790879142,

  "source": "image",
  "source_input": "https://example.com/my-photo.jpg"
}

You can download the dataset in various formats such as JSON, HTML, CSV, or Excel.

🛒 Tips

• Combine sources in one run: keyword queries, photo searches, and listing-ID searches all share maxListings, so results are deduplicated automatically.
• Run one query per niche for clean, comparable datasets.
• Keep enrichment on for descriptions, tags, materials, and shop data.
• For photo search, smaller images upload faster and cost less; large photos are automatically resized and re-encoded.
• Schedule the Actor weekly and diff favorites / price_num to track trends.

🛒 FAQ

Can I search Etsy by image?

Yes. Put image URLs (or base64 images) in the Search by Photo field and the Actor returns visually similar Etsy listings. You can also pass an Etsy listing ID or URL to get products that look like that listing.

Does scraping Etsy violate their terms of service?

Etsy's terms restrict automated access at high volumes. This Actor is intended for research, price comparison, and analytics. Consult Etsy's terms for your use case.

Search-only vs enriched output?

Search-only output returns title, price, sale price, all images, videos, badges, and shop ID for every listing. Enriched output adds the full product detail: description, tags, materials, taxonomy, shop location and sales, stock, and ratings.

How is this different from HTML scraping?

The Actor works directly with Etsy's product data, so results are already structured and include the full media gallery — including videos — without opening product pages.

🛒 Related Actors

🔍 Search Etsy by image — Etsy Visual Search Scraper

Have a picture but not the words? The Etsy Visual Search Scraper finds Etsy listings that look just like a photo, or similar to an existing listing — ideal for visual sourcing and product research.

👉 Etsy Visual Search Scraper — find similar Etsy products by image.

🛒 Disclaimer

This Actor is not affiliated with or endorsed by Etsy. Use it responsibly and in line with applicable laws and Etsy's terms.