# ๐Ÿ”ฅ Etsy Listings Scraper โ€“ Live Carts & Ads (`yumitori/etsy-listings-scraper`) Actor Scrape Etsy listings by keyword with data no other scraper exposes โ€” live cart counts, "X people bought in 24h" signals, Etsy Ads slot positions, bestseller and star-seller badges, seller velocity. Up to 1,080 per keyword, any country. No proxy or captcha needed. - **URL**: https://apify.com/yumitori/etsy-listings-scraper.md - **Developed by:** [Yakugusa Yumitori](https://apify.com/yumitori) (community) - **Categories:** E-commerce, Lead generation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $8.00 / 1,000 etsy listings This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 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 ```json { "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. ```json { "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. ```json { "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. ```json { "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 โ†’ . โš ๏ธ **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. -------------------------- > โš ๏ธ **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. # Actor input Schema ## `queries` (type: `array`): One or more Etsy search keywords. Add a single term for a focused run, or paste many for bulk research โ€” each keyword runs independently and its rows are tagged with `sourceQuery`. ## `maxPages` (type: `integer`): How many search-result pages to scrape. Etsy returns ~36 listings per page, so this is the simplest knob: 1 = 36, 10 = 360, 30 = 1080. If both `maxPages` and `maxResults` are set, the smaller wins. ## `maxResults` (type: `integer`): Optional hard cap on listings returned. Useful when you want exactly N rows (e.g. "first 50"). If unset, you get every listing across the chosen `maxPages`. ## `sort` (type: `string`): How to rank results. "score" = Etsy's relevance algorithm. "carts" = re-ranked client-side by in-cart count (best for hot products). ## `country` (type: `string`): Two-letter ISO code. Localizes results to listings shipping to that country. Default US. ## `minPrice` (type: `integer`): Filter listings cheaper than this (in the country's local currency). ## `maxPrice` (type: `integer`): Filter listings more expensive than this. ## `onSaleOnly` (type: `boolean`): Only return listings that are currently discounted. ## `freeShippingOnly` (type: `boolean`): Only return listings that ship free to the chosen country. ## `digitalOnly` (type: `boolean`): Restrict to digital downloads (PDFs, SVGs, etc.). ## `handmadeOnly` (type: `boolean`): Restrict to listings flagged handmade by Etsy. ## `includeAds` (type: `boolean`): If true, ad placements appear in results with `runningAds: true`. If false, ads are stripped. ## `dedupeAcrossQueries` (type: `boolean`): When running multiple keywords, drop a listing on subsequent queries if its `listingId` was already seen on an earlier one. The first row keeps its `sourceQuery`. ## `concurrentQueries` (type: `integer`): How many keywords to scrape in parallel. 1 = strictly sequential. Higher = faster but risks Etsy rate-limiting on shared bursts. ## Actor input object example ```json { "queries": [ "linen apron" ], "maxPages": 3, "sort": "score", "country": "US", "onSaleOnly": false, "freeShippingOnly": false, "digitalOnly": false, "handmadeOnly": false, "includeAds": true, "dedupeAcrossQueries": true, "concurrentQueries": 2 } ``` # Actor output Schema ## `listings` (type: `string`): All scraped listings (overview / shop intel / pricing views available). ## `summary` (type: `string`): Totals + per-keyword counts + run config. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "queries": [ "linen apron" ] }; // Run the Actor and wait for it to finish const run = await client.actor("yumitori/etsy-listings-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "queries": ["linen apron"] } # Run the Actor and wait for it to finish run = client.actor("yumitori/etsy-listings-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "queries": [ "linen apron" ] }' | apify call yumitori/etsy-listings-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=yumitori/etsy-listings-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "๐Ÿ”ฅ Etsy Listings Scraper โ€“ Live Carts & Ads", "description": "Scrape Etsy listings by keyword with data no other scraper exposes โ€” live cart counts, \"X people bought in 24h\" signals, Etsy Ads slot positions, bestseller and star-seller badges, seller velocity. Up to 1,080 per keyword, any country. No proxy or captcha needed.", "version": "0.1", "x-build-id": "Uog5llXy3vqtbQIOs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yumitori~etsy-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yumitori-etsy-listings-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/yumitori~etsy-listings-scraper/runs": { "post": { "operationId": "runs-sync-yumitori-etsy-listings-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/yumitori~etsy-listings-scraper/run-sync": { "post": { "operationId": "run-sync-yumitori-etsy-listings-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "queries": { "title": "Search keywords", "minItems": 1, "maxItems": 50, "uniqueItems": true, "type": "array", "description": "One or more Etsy search keywords. Add a single term for a focused run, or paste many for bulk research โ€” each keyword runs independently and its rows are tagged with `sourceQuery`.", "items": { "type": "string" } }, "maxPages": { "title": "Pages to fetch", "minimum": 1, "maximum": 30, "type": "integer", "description": "How many search-result pages to scrape. Etsy returns ~36 listings per page, so this is the simplest knob: 1 = 36, 10 = 360, 30 = 1080. If both `maxPages` and `maxResults` are set, the smaller wins.", "default": 3 }, "maxResults": { "title": "Max results (cap)", "minimum": 1, "maximum": 1080, "type": "integer", "description": "Optional hard cap on listings returned. Useful when you want exactly N rows (e.g. \"first 50\"). If unset, you get every listing across the chosen `maxPages`." }, "sort": { "title": "Sort", "enum": [ "score", "carts", "lastsale", "created", "price-asc", "price-desc" ], "type": "string", "description": "How to rank results. \"score\" = Etsy's relevance algorithm. \"carts\" = re-ranked client-side by in-cart count (best for hot products).", "default": "score" }, "country": { "title": "Ship-to country", "enum": [ "US", "GB", "CA", "AU", "NZ", "DE", "FR", "IT", "ES", "NL", "IE", "BE", "AT", "PT", "JP", "BR", "MX", "CH", "SE", "NO", "DK", "PL" ], "type": "string", "description": "Two-letter ISO code. Localizes results to listings shipping to that country. Default US.", "default": "US" }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Filter listings cheaper than this (in the country's local currency)." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Filter listings more expensive than this." }, "onSaleOnly": { "title": "On-sale listings only", "type": "boolean", "description": "Only return listings that are currently discounted.", "default": false }, "freeShippingOnly": { "title": "Free-shipping listings only", "type": "boolean", "description": "Only return listings that ship free to the chosen country.", "default": false }, "digitalOnly": { "title": "Digital downloads only", "type": "boolean", "description": "Restrict to digital downloads (PDFs, SVGs, etc.).", "default": false }, "handmadeOnly": { "title": "Handmade only", "type": "boolean", "description": "Restrict to listings flagged handmade by Etsy.", "default": false }, "includeAds": { "title": "Include sponsored (ad) listings", "type": "boolean", "description": "If true, ad placements appear in results with `runningAds: true`. If false, ads are stripped.", "default": true }, "dedupeAcrossQueries": { "title": "Dedupe across queries", "type": "boolean", "description": "When running multiple keywords, drop a listing on subsequent queries if its `listingId` was already seen on an earlier one. The first row keeps its `sourceQuery`.", "default": true }, "concurrentQueries": { "title": "Concurrent queries", "minimum": 1, "maximum": 5, "type": "integer", "description": "How many keywords to scrape in parallel. 1 = strictly sequential. Higher = faster but risks Etsy rate-limiting on shared bursts.", "default": 2 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```