Etsy Product Search Scraper

Search Etsy product listings by one keyword and receive flat, rank-aware product rows for price monitoring, product discovery, and marketplace research.

Use this actor for keyword-based Etsy product search. Do not use it for direct listing-page enrichment, shop catalogs, or customer reviews; use the Etsy All-in-One Scraper for those broader workflows.

What it returns

Field	Description
listingId, listingUrl, title	Stable Etsy listing identity and product title
price, currency, isOnSale	Search-card price and promotion signals
rating, reviewCount	Visible buyer feedback signals when Etsy provides them
shopName, shopUrl	Seller identity shown on the search card
badges, hasFreeShipping	Recognized Etsy badges and delivery signal
dataSource	etsySearch or searchIndexFallback provenance
searchQuery, page, position	Search provenance and rank context

Output

The default dataset contains one normalized row for each saved Etsy product result. The OUTPUT key contains the terminal outcome, result and charge counters, warnings, and a link to that dataset.

Pricing

Event	Price
Actor start	$0.00005 per run
Etsy product search result	$0.005 per saved listing

Platform compute and proxy usage are charged separately through Apify's Pay per event + usage setting. maxResults is both the output and result-charge cap: a 50-result run has at most $0.25005 in event charges, plus platform usage.

Input example

{
  "searchQuery": "handmade necklace",
  "maxResults": 50,
  "maxPages": 3
}

API and MCP use

Use the actor when a workflow needs Etsy search-result listings for a single keyword. The actor returns one structured item per product; fetch the default dataset after the run for paginated output. Invalid queries produce an INVALID_INPUT run summary; valid queries with no listings produce VALID_EMPTY; blocks that leave no useful data fail honestly as UPSTREAM_FAILED.

Limits and data freshness

Etsy can change search markup and rate-limit automated traffic. The actor first uses a browser route with residential proxy sessions; if Etsy blocks it, it may return genuine Etsy listing URLs from a public search-index fallback. Fallback rows set unavailable search-card fields to null and identify themselves as dataSource: "searchIndexFallback"; this actor does not offer destination, sorting, price, sale, or shipping filters. Listing detail data, shop catalog data, and reviews are deliberately outside this actor's contract.

Legal note

Use this actor only for data you are entitled to collect and in compliance with applicable law, Etsy's terms, and your own privacy obligations.