Etsy Scraper

Thirdwatch portfolio: 8,800+ users across 140+ public Actors, 2M+ records delivered, >95% run success. Explore all Thirdwatch Actors.

Scrape Etsy search results for handmade, vintage, craft-supply, gift, jewellery, clothing, home, wedding, and other marketplace categories. Collect structured listing and shop data for research, monitoring, or product discovery.

What you get

• Listing and product IDs
• Product name
• Shop name
• Current price, original price, and discount percentage
• Currency
• Rating when available
• Product image and canonical URL
• Category and source query

Use cases

• Handmade and vintage market research
• Product and price monitoring
• Shop and competitor discovery
• Trend, niche, and keyword analysis
• Catalog enrichment
• Gift and merchandising research

Input parameters

Provide search queries, select an Etsy category, or combine both.

Parameter	Required	Description
queries	No	Search phrases to run against Etsy (e.g. "silver ring").
category	No	Etsy category to search within, instead of or alongside queries.
subcategorySlug	No	Narrows results to a specific subcategory within category.
sortBy	No	Result order (e.g. relevance, most recent, price).
trending	No	When enabled, returns Etsy's trending listings for the query/category.
minPrice	No	Lowest listing price to include.
maxPrice	No	Highest listing price to include.
maxResults	No	Maximum listings returned per query, up to 1,000.
proxyConfiguration	No	Proxy settings. Leave default for best results.

{
  "queries": ["silver ring", "personalized wedding gift"],
  "category": "jewelry",
  "sortBy": "relevance",
  "maxResults": 100
}

Example output

{
  "product_id": "1234567890",
  "product_name": "Handmade Sterling Silver Ring",
  "brand": "ExampleShop",
  "shop": "ExampleShop",
  "price": 42.5,
  "original_price": 50,
  "discount_percent": 15,
  "currency": "USD",
  "rating": 4.9,
  "image_url": "https://...",
  "url": "https://www.etsy.com/listing/...",
  "source_query": "silver ring"
}

Integrations

Export results through the Apify dataset API or connect the Actor to webhooks, Make, Zapier, n8n, Google Sheets, warehouses, BI tools, and AI workflows.

Limitations

• Etsy can change its listing pages without notice, which may affect some fields temporarily until the Actor is updated.
• Optional fields (rating, original price, discount) depend on what each listing actually displays — a listing with no discount simply omits discount_percent rather than showing a zero.
• Prices and currency reflect the market/session the listing was fetched under, so the same item can show different currencies across runs with different settings.
• Result volume is capped at 1,000 items per query; split very broad queries into narrower ones (by subcategory or price range) for deeper coverage.

Need help or a custom field? Contact support@thirdwatch.dev.

Last verified: 2026-09