🔥 Etsy Listings Scraper – Live Carts & Ads

Legal Disclaimer: This Actor is an independent development utility and is not affiliated with, endorsed by, or sponsored by Etsy, Inc. "Etsy" is a registered trademark of Etsy, Inc. All trademarks and registered brand names belong to their respective owners.

---

⚡ What Data Can This Etsy Scraper Extract?

Every run returns 40 structured attributes per listing, delivering instant visibility into conversion rates, store sales volume, and competitor pricing:

• Live In-Cart Demand: Access real-time shopper telemetry (inCartCount) to see which products buyers have active in their carts right now.
• Paid Ad Slot Index: Discover which competitors are bidding on Etsy Ads and the exact sponsored slot positions (adSlot) they hold.
• Automated Deduplication: Scrape across up to 50 keywords simultaneously with cross-query deduplication (dedupeAcrossQueries) across 22 countries.

Instant Dataset Output Preview

{
  "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](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](https://www.etsy.com/shop/WilshireGoodsShop)",
  "listingUrl": "[https://www.etsy.com/listing/1042603482/japanese-apron-with-pockets-vintage](https://www.etsy.com/listing/1042603482/japanese-apron-with-pockets-vintage)",
  "price": 23.50,
  "discountedPrice": null,
  "discountPct": null,
  "currencyCode": "USD",
  "onSale": false,
  "inCartCount": 592,
  "shopRating": 4.85,
  "shopRatingCount": 4210,
  "shopSales": 38389,
  "shopSince": 1594249332,
  "sellerLocation": "United States",
  "isBestseller": true,
  "isStarSeller": true,
  "isTopRated": false,
  "isScarce": false,
  "isMadeToOrder": false,
  "isDigital": false,
  "isHandmade": true,
  "isCustomizable": false,
  "isPersonalizable": false,
  "isFreeShipping": false,
  "quantity": 1037,
  "minProcessingDays": 1,
  "maxProcessingDays": 2,
  "photoCount": 10,
  "lastSaleDate": 1778131264,
  "createDate": 1627135063,
  "runningAds": false,
  "adSlot": null,
  "sourceQuery": "linen apron"
}

---

🟢 How to Run It in 4 Easy Steps (No Coding Needed)

You do not need an Etsy developer account or approved API credentials:

1. 1️⃣ Click "Try for free": Click the blue Try for free button at the top right of this page to launch the Actor inside your Apify Console.
2. 2️⃣ Enter Keywords: In the Input tab, type your target search terms (e.g., linen apron, ceramic mug), one per line. Batch up to 50 keywords in a single run!
3. 3️⃣ Click "Save & Run": Leave sort set to carts to find what is selling right now, then hit the green Save & Run button. Results begin streaming within seconds.
4. 4️⃣ Export Spreadsheet: When finished, click Export on the run results screen to download your data as Excel (XLSX), CSV, or JSON.

---

⚖️ Feature Comparison: Why It Beats Other Tools

Feature / Signal	Official Etsy API	Generic Scrapers	eRank / EverBee	This Scraper
Live In-Cart Demand (inCartCount)	❌ Hidden	❌ Not parsed	❌ Rough estimates only	✅ ONLY Scraper on Market
Paid Ad Placement & Slot (adSlot)	❌ Excluded	⚠️ Rarely logged	❌ Missing	✅ Exact Ad Slot Index
Multi-Keyword Parallel Batches	❌ 1 at a time	❌ Sequential only	❌ N/A	✅ Up to 50 Queries
Cross-Query Deduplication	❌ Manual code	❌ Inflates rows	❌ N/A	✅ Built-in Automatic

---

⚡ Pro Tips & Essential Run Notes

Pro Tip for Sellers: Sort by carts rather than score to bypass stale listings and surface what real buyers are actively purchasing this week.

Cross-Query Deduplication: When querying overlapping terms like ceramic mug and pottery coffee cup, duplicate items are consolidated into one row by default (dedupeAcrossQueries: true).

Deep Pagination: Beyond page 15, low-volume keyword results naturally dry up. The scraper halts safely without consuming unnecessary compute.

---

Complete Field Dictionary

Data Dimension	Exported JSON / Spreadsheet Columns
🛒 Buyer Cart Telemetry	inCartCount, lastSaleDate, quantity, isScarce
🎯 PPC Ads & Badges	runningAds, adSlot, isBestseller, isStarSeller, isTopRated
💰 Pricing & Discounting	price, discountedPrice, discountPct, onSale, currencyCode, isFreeShipping
🏬 Shop Authority	shopName, shopUrl, shopSales, shopRating, shopRatingCount, sellerLocation, shopSince
📦 Fulfillment & Specs	listingId, title, listingUrl, image, isHandmade, isDigital, isPersonalizable, minProcessingDays

---

💰 Transparent Pricing & Free Usage

This Actor uses a predictable Pay-Per-Event (PPE) pricing model:

• Base Rate: $8.00 per 1,000 scraped listings ($0.008 per product).
• Monthly Free Usage: Apify provides $5.00 in free platform usage credits every month. This means you can scrape over 625 complete listings every month for free without entering a credit card.
• All-Inclusive Runs: Headless browser automation and compute overhead are fully included with no hidden fees.

---

🤖 AI Agent & Model Context Protocol (MCP) Integration

This Actor connects directly to AI agents, LLMs, and conversational tools via Apify’s hosted Model Context Protocol (MCP) server (https://mcp.apify.com).

MCP Client Setup (Claude Desktop, Cursor, OpenCode)

Add this configuration snippet to your client's mcp.json file:

{
  "mcpServers": {
    "apify": {
      "url": "[https://mcp.apify.com?tools=fetch-actor-details,yumitori/etsy-listings-scraper](https://mcp.apify.com?tools=fetch-actor-details,yumitori/etsy-listings-scraper)"
    }
  }
}

Example AI Agent Prompts

• "Find the top 10 trending physical products under $35 on Etsy for 'ceramic mug' sorted by live cart demand using the Etsy Listings Scraper."
• "Identify which shops are running sponsored ads for 'wedding gifts' and extract their pricing, bestseller status, and ad slot index in a Markdown table."

---

⚙️ Simple Settings Cheat Sheet

Setting	What It Does	Recommended Choice
queries	Your search terms (1 to 50 keywords)	Type your main product keywords
sort	How to order search results	Set to carts to see what's hot right now
country	Target buyer marketplace	US, GB, DE, CA, AU, etc.
maxPages	How deep to crawl (1 page ≈ 36 items)	3 to 5 pages is plenty for quick sweeps
handmadeOnly	Restrict exclusively to handmade goods	Set to true if you only want handmade
digitalOnly	Filter strictly for instant downloads	Set to true for printables & SVGs
includeAds	Include sponsored listings	Leave true to map competitor ad spots

---

🎯 1-Click Search Presets & Use Cases

1. High-Demand Holiday Product Validation

Discover which items real buyers are actively holding in their shopping carts right now:

{
  "queries": ["halloween decor", "thanksgiving table", "christmas gifts"],
  "sort": "carts",
  "maxPages": 5,
  "country": "US",
  "handmadeOnly": true
}

2. Digital Download & Template Research

Benchmark price points and transaction velocity for instant download products:

{
  "queries": ["budget planner digital", "wedding invitation printable"],
  "digitalOnly": true,
  "sort": "score",
  "maxPages": 5
}

3. Competitor Sponsored Ad Mapping

Audit which storefronts are paying for search placement on high-value terms:

{
  "queries": ["personalized gifts"],
  "includeAds": true,
  "sort": "score",
  "maxPages": 3
}

---

💻 API & Developer Integration

Trigger runs programmatically and pull dataset comps directly into your applications.

cURL

curl --request POST \
  --url "[https://api.apify.com/v2/acts/yumitori~etsy-listings-scraper/runs?token=YOUR_API_TOKEN](https://api.apify.com/v2/acts/yumitori~etsy-listings-scraper/runs?token=YOUR_API_TOKEN)" \
  --header "Content-Type: application/json" \
  --data '{"queries": ["linen apron"], "sort": "carts", "maxPages": 3, "country": "US"}'

Python (Apify Client SDK)

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

run_input = {
    "queries": ["linen apron", "ceramic mug"],
    "sort": "carts",
    "maxPages": 3,
    "country": "US"
}

run = client.actor("yumitori/etsy-listings-scraper").call(run_input=run_input)

# Fetch structured results from the default dataset
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{item['title']} - In Carts: {item['inCartCount']} - Price: ${item['price']}")

---

🔗 Related Etsy Market Research Tools

Complete your e-commerce analysis pipeline by combining this Actor with sibling intelligence tools:

• Etsy Shop & Seller Finder: Bulk extract storefront metrics, lifetime sales volumes, and seller review histories by niche.
• Etsy Dropshipping & Supplier Finder: Identify third-party production partners and print-on-demand fulfillment providers behind popular listings.
• Etsy Keyword Research Tool: Extract high-volume buyer search terms and autocomplete suggestions directly from Etsy's search bar.

---

❓ Frequently Asked Questions (FAQ)

Can I export Etsy listing data to Excel or CSV?

Yes. Once your Actor run completes, click the Export button directly above the dataset results on the run page. You can download all 40 scraped product fields into Excel (XLSX), CSV, JSON, or JSONL formats.

Does this Etsy scraper require an official API key?

No. The scraper runs entirely on Apify's managed cloud infrastructure. You do not need an approved Etsy developer account or API credentials.

What is live in-cart count data?

It reflects active buyer interest right on Etsy search and listing cards, showing exactly how many shoppers currently have a listing stored in their active shopping carts.

Why is the final dataset row count lower than maxPages × 36?

Etsy search pagination frequently repeats items across consecutive pages. When dedupeAcrossQueries is enabled, the Actor consolidates duplicate listings into a single record so you only pay for unique, actionable data.

Is scraping public Etsy listings legal?

Yes. Collecting publicly available product titles, prices, shop ratings, and badge data for competitive intelligence complies with international web scraping standards, provided personal data privacy and rate limits are respected.