Etsy Listings Scraper

Scrape Etsy listings by keyword and get the data the official seller dashboard quietly hides — live in-cart counts, "X people bought in 24h" snudges, paid-ad slot positions, production-partner disclosure, bestseller and star-seller badges, and seller velocity.

Other Etsy scrapers force you into one search at a time and return shallow snippets. This one batches up to 50 keywords in parallel, dedupes across them, and ships 40 fields per listing — all in one run. No proxy, no captcha, no setup.

---

Quick start

{
  "queries": ["linen apron", "ceramic mug", "leather journal"],
  "maxPages": 10,
  "sort": "carts",
  "country": "US"
}

Three keywords, ~360 listings each, sorted by current cart pressure, deduped — runs in roughly 30 seconds.

---

What you get on every listing

Demand signals — inCartCount (live shopping-cart count), lastSaleDate, the in-demand snudge from Etsy's own listing payload, scarcity flag, quantity remaining.

Paid placement intel — runningAds, adSlot (which slot the seller bought), Bestseller / Star Seller / Top Rated badges.

Pricing — price, discountedPrice, discountPct, onSale, currencyCode, free-shipping flag.

Shop intel — shopName, shopRating, shopRatingCount, shopSales, shopSince, seller location.

Product type — isHandmade, isDigital, isCustomizable, isPersonalizable, isMadeToOrder, photo and review-photo / review-video counts.

Plus sourceQuery so you know which keyword surfaced each listing.

---

What you control

Knob	Default	What it does
queries	—	1–50 keywords, batched in one run
maxPages	3	1–30 pages per keyword (1 page ≈ 36 listings)
sort	score	score · carts · lastsale · created · price-asc · price-desc
country	US	22 ship-to countries — US, UK, DE, FR, JP, AU, CA, +15 more
concurrentQueries	2	1–5 keywords running in parallel
dedupeAcrossQueries	true	Same listing matching two queries is counted once

Filters: minPrice / maxPrice, onSaleOnly, freeShippingOnly, digitalOnly, handmadeOnly, includeAds: false to strip sponsored placements.

---

Use it for

Niche research. Sweep 20 keyword variants in one run, sort by carts, see what's actually moving versus what just looks pretty.

{
  "queries": ["mushroom lamp", "fungi lamp", "morel lamp", "cottagecore lamp"],
  "maxPages": 10,
  "sort": "carts",
  "handmadeOnly": true,
  "includeAds": false
}

Competitor ad-spend mapping. Pull a keyword, filter the result for runningAds: true — you've got every advertiser on that keyword with their slot positions.

{
  "query": "personalized mug",
  "maxPages": 5,
  "country": "US"
}

Pricing teardowns. Sort by price-desc, slice with minPrice / maxPrice, see how the niche prices itself across the curve.

Localized research. UK / EU / JP markets often look like entirely different niches on the same keyword. Set country: "GB", "DE", "JP".

---

Output

Lands in the default dataset — export as JSON, CSV, Excel, or JSONL. Three pre-built views ship with the dataset:

• Overview — thumbnail, title, shop, price, carts, badges
• Shop intel — shop-level stats for sourcing competitors
• Pricing — price, discount, ad slot, carts for pricing teardowns

A run summary (totals, per-keyword breakdown, dedupe counts) lands in the key-value store under SUMMARY.

Sample row (all 40 fields)

A real row from a linen apron run, sorted by carts. WilshireGoodsShop's Japanese apron — Bestseller, Star Seller, 592 active carts on a $23.50 product, 38,389 lifetime shop sales.

{
  "listingId": 1042603482,
  "title": "Japanese Apron with pockets, Vintage Style Cooking Smock for Women, Small to Plus Size",
  "image": "https://i.etsystatic.com/24091653/r/il/8f1a48/4030105345/il_fullxfull.4030105345_n3rg.jpg",
  "shopId": 24091653,
  "shopName": "WilshireGoodsShop",
  "shopUrl": "https://www.etsy.com/shop/WilshireGoodsShop",
  "listingUrl": "https://www.etsy.com/listing/1042603482/japanese-apron-with-pockets-vintage",
  "price": 23.5,
  "discountedPrice": null,
  "discountPct": null,
  "currencyCode": "USD",
  "onSale": false,
  "inCartCount": 592,
  "shopRating": null,
  "shopRatingCount": 0,
  "shopSales": 38389,
  "shopSince": 1594249332,
  "sellerLocation": "United States",
  "isBestseller": true,
  "isStarSeller": true,
  "isTopRated": false,
  "isScarce": false,
  "isMadeToOrder": false,
  "isDigital": false,
  "isHandmade": false,
  "isCustomizable": false,
  "isPersonalizable": false,
  "isFreeShipping": false,
  "quantity": 1037,
  "minProcessingDays": 1,
  "maxProcessingDays": 2,
  "photoCount": 10,
  "reviewPhotoCount": 63,
  "reviewVideoCount": 3,
  "lastSaleDate": 1778131264,
  "createDate": 1627135063,
  "location": null,
  "runningAds": false,
  "adSlot": null,
  "sourceQuery": "linen apron"
}

---

Speed & limits

Run shape	Time
1 keyword, 1 page (~36 listings)	1–2s
1 keyword, 10 pages (~360)	6–10s
3 keywords parallel, 2 pages each (~200 deduped)	~5s
50 keywords, 30 pages each (max scale)	~10–15 min

Why your row count is below maxPages × 36. Etsy's index naturally returns overlapping listings across pages, especially on trending or broad niches. A 30-page run that mathematically caps at 1,080 typically lands at 400–600 unique rows after dedupe. Set dedupeAcrossQueries: false if you'd rather see every match (and read sourceQuery yourself to know which keywords ranked which listings).

maxPages caps at 30. concurrentQueries caps at 5. Deep pages (15+) sometimes return partial — the actor stops cleanly when Etsy's pagination dries up.

---

Built and maintained by Yakugusa Yumitori. Custom data work and "can you scrape X?" challenges → logic.deploy@pm.me.

---

⚠️ Unofficial. This actor is not affiliated with, endorsed by, or sponsored by Etsy, Inc. "Etsy" is a trademark of Etsy, Inc., used here for descriptive purposes only.