Etsy Search Scraper

Scrape Etsy search results by keyword and extract 38 fields per listing — pricing, shop metrics, badges, ad placement, product type, color variants, and video — all from a single run.

Runs up to 50 keywords in parallel. Each page yields ~64 listings. At full scale (50 keywords × 30 pages), expect around 60,000 listings in under 8 minutes.

No proxy setup required. No captcha-solving service needed. Proxies are bundled — just provide keywords and run.

Pricing: $4.00 $2.00 per 1,000 listings — 50% off for a limited time. Platform usage is included — no extra compute charges.

Quick start

{
  "keywords": ["personalized necklace", "custom mug", "wall art print"],
  "maxPages": 5,
  "country": "US"
}

Three keywords, ~900 listings each, in roughly 30 seconds.

What you get on every listing

Search context — the keyword that surfaced the listing, its position in results (rank), its organic rank excluding ads (organic_rank), and the page it appeared on.

Listing — listing_id, title, direct url, and image_url.

Shop — shop_name, shop_id, shop_url, star rating (shop_rating), total review count (shop_review_count), and years on Etsy (shop_age_years).

Pricing — price, currency, original_price, discount_pct, is_on_sale, is_free_shipping.

Ad placement — is_ad, ad_slot (position of the sponsored listing on the page).

Badges — is_bestseller, is_popular_now, is_etsys_pick, is_star_seller, is_limited_stock.

Product type — is_digital, has_personalization.

Media — has_video, video_url, color_variant_count, color_variants (list of color names shown in swatches).

Logistics — ships_from.

Meta — total_result_count (Etsy's total for the keyword), scraped_at.

What you control

Field	Default	Description
keywords	—	1–50 search terms, batched in one run
maxPages	5	Pages to scrape per keyword (1–30). Pages yield ~64 listings each.
country	US	22 countries — sets locale, language, and currency
sortOrder	Most relevant	Most relevant, Price low→high, Price high→low, Top reviews, Newest
minPrice	—	Minimum price in the selected country's currency
maxPrice	—	Maximum price in the selected country's currency
maxResults	—	Cap listings per keyword. Leave empty for no cap.

Filters: onSale, freeShipping, starSeller, customizable, etsyPick, listingType (all / digital / physical), excludeSponsored to drop ads from output.

Use cases

Niche research. Run 20 keyword variants in one go, sort by organic_rank, see what Etsy's algorithm pushes organically versus what sellers are paying to promote.

{
  "keywords": ["mushroom lamp", "fungi lamp", "cottagecore lamp", "morel lamp"],
  "maxPages": 10,
  "excludeSponsored": true
}

Competitor ad mapping. Pull a keyword and filter results where is_ad: true — you get every active advertiser with their exact slot position.

{
  "keywords": ["personalized mug"],
  "maxPages": 5,
  "sortOrder": "most_relevant"
}

Pricing teardowns. Combine minPrice / maxPrice with sortOrder: price_desc to slice a niche by price tier and see how sellers position across the curve.

{
  "keywords": ["linen dress", "boho dress"],
  "maxPages": 10,
  "minPrice": 50,
  "sortOrder": "price_desc"
}

Localized market research. The same keyword often surfaces an entirely different competitive landscape by country. Run the same terms across US, GB, and DE to compare.

{
  "keywords": ["handmade candle", "soy candle"],
  "maxPages": 10,
  "country": "GB"
}

Star Seller landscape. Filter to top-rated shops only and sort by review count to benchmark the most established players in a niche.

{
  "keywords": ["enamel pin"],
  "maxPages": 15,
  "starSeller": true,
  "sortOrder": "highest_reviews"
}

Output

Results land in the default dataset — export as JSON, CSV, Excel, or JSONL from the Apify console or via API.

A run summary lands in the key-value store under SUMMARY with per-keyword breakdowns: pages fetched, listing count, and whether Etsy's results were exhausted before maxPages was reached.

Sample row

A real listing from a mug keyword run — rank 1 organic, 50% off, 21,500 reviews, 10 color variants.

{
  "keyword": "mug",
  "page": 1,
  "rank": 3,
  "organic_rank": 2,
  "listing_id": "4384679177",
  "title": "Custom Photo Collage Mug, Your Photo, Your Text, Personalized Photo Mug, Custom Coffee Cup Gift for Family and Friend, Memory Keepsake",
  "url": "https://www.etsy.com/listing/4384679177/custom-photo-collage-mug-your-photo-your",
  "image_url": "https://i.etsystatic.com/30637927/r/il/715b79/8042175906/il_1588xN.8042175906_ijkp.jpg",
  "shop_name": "ArtsifOfficial",
  "shop_id": 30637927,
  "shop_url": "https://www.etsy.com/shop/ArtsifOfficial",
  "shop_rating": 4.9,
  "shop_review_count": 21500,
  "shop_age_years": 4.0,
  "price": 6.99,
  "currency": "USD",
  "original_price": 13.99,
  "discount_pct": 50,
  "is_on_sale": true,
  "is_free_shipping": false,
  "is_ad": false,
  "ad_slot": null,
  "is_bestseller": false,
  "is_popular_now": true,
  "is_etsys_pick": false,
  "is_star_seller": false,
  "is_limited_stock": false,
  "is_digital": false,
  "has_personalization": true,
  "has_video": true,
  "video_url": "https://v.etsystatic.com/video/upload/ac_none,du_15,q_auto:good/tfadzvtf7adbe63cipsx.mp4",
  "color_variant_count": 8,
  "color_variants": ["Green", "Red", "Dark blue", "Purple", "Black", "Yellow", "Light blue", "Pink"],
  "ships_from": null,
  "total_result_count": 3061962,
  "scraped_at": "2026-06-29T21:37:43.489448+00:00"
}

Speed & scale

Measured locally, single proxy session per keyword:

Run shape	Time	Listings
1 keyword, 1 page	5s	13
1 keyword, 5 pages	15s	266
1 keyword, 10 pages	29s	582
3 keywords parallel, 3 pages each	14s	414
5 keywords parallel, 5 pages each	18s	1,324
10 keywords parallel, 5 pages each	22s	2,664
50 keywords, 30 pages each (max scale)	7m 21s	62,087

Why your row count may be below maxPages × 64. Etsy's index caps most keyword searches at around 20–22 pages of results (~1,200–1,400 listings), regardless of how many pages you request. The scraper stops cleanly when Etsy's pagination is exhausted — you won't be charged for empty pages. For broad or trending keywords, maxPages: 30 is the right ceiling; for niche terms, 10–15 is usually enough.

maxPages caps at 30.

---

⚠️ 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.