Etsy Scraper
Research a niche before you open a shop, price your products against the market, or track the tags and best sellers of competing shops. Give it keywords, Etsy category links or listing URLs and it returns one JSON row per listing: price and sale price, favorites, the listing's own rating and review count, tags, materials, variations, shipping and delivery estimate, and the shop's sales count and rating. Review text is optional. $7.20 per 1,000 listings and $4.50 per 1,000 reviews; you pay only for rows you get.
$7.20 per 1,000 listings on the Free plan, down to $5.40 on higher plans
Why this actor
- A full listing for 10% less. Every row is a full listing (variations, sale price, the listing's rating, shop and shipping), not just a search card, at $7.20 per 1,000 against $8 at yumitori/etsy-listings-scraper, the most used Etsy scraper (free plan, Apify Store, 2026-10-31).
- Runs that finish. 14.9% of epctex/etsy-scraper's runs failed or timed out (1,997 time-outs and 69 failures of 13,904 runs, Apify Store, 30 days to 2026-10-31). 30 of our 30 runs since 2026-10-22 succeeded (scheduled and test runs, Apify run history). Unknown listing ids and unreadable inputs come back as free error rows.
- Etsy's own filters: price range, ship-to country and sort order. Run the same keywords weekly and you have a price, rank and favorites history.
Drop-in input
Drop-in input. Input written for yumitori/etsy-listings-scraper (queries, maxResults, maxPages, sort, country, onSaleOnly, freeShippingOnly), yumitori/etsy-search-scraper (searchTerms, maxResultsPerTerm, sortOn, sortOrder), epctex/etsy-scraper (startUrls, search, maxItems, includeDescription) or automation-lab/etsy-scraper (searchQuery, sort, freeShipping, onSale) works as it is.
As stated in the actor’s README. The full list of accepted input names is on the Store page.
Switching from another actor
- From Etsy Listings Scraper yumitori/etsy-listings-scraper, 10 input fields work as they are
What you get
| Field | What it holds |
|---|---|
listingId, title, url | The listing id (the number in the link), its title and link. |
price, currency, priceUsd | Price in the seller's currency (lowest option when options change the price), and Etsy's US-dollar figure. |
salePrice, discountPercent, onSale | The sale price and discount while a sale runs. |
favorites | How many shoppers saved the listing. |
rating, reviewCount, ratingCounts | This listing's own reviews: average, count and per-star counts. |
tags, materials | The seller's search tags and materials. |
category, categoryPath, taxonomyId | Etsy category. |
variations | Buyer options (color, size, personalization...) with the price per option when it differs. |
images | Full-size image links. |
whenMade, isDigital, isCustomizable, isMadeToOrder, isBestseller | What kind of item it is. |
shipping | Ships from, free or cost, delivery estimate to the US, returns policy. |
shop | The shop as a business: name, link, lifetime sales, rating, review count, location, active listings, favorites, opening date, Star Seller badge. |
createdAt, updatedAt | Listing dates (a renewal resets createdAt). |
searchInput, searchRank, isAd | The keyword or URL that found it, the organic position, and whether it was a paid placement. |
scrapedAt | When the row was collected. |
Review rows (rowType: "review") hold reviewId, listingId, rating, text, date, sellerResponse and hasPhoto.
Sample row (from the README example; long text shortened, lists cut to two items):
{
"rowType": "listing",
"platform": "etsy",
"listingId": "962939986",
"title": "Leather Envelope Wallet for Women, Personalized Mini Card Wallet, Full Grain Crazy Horse",
"url": "https://www.etsy.com/listing/962939986",
"price": 64,
"currency": "USD",
"salePrice": 57.6,
"discountPercent": 10,
"onSale": true,
"favorites": 4979,
"rating": 4.95,
"reviewCount": 245,
"tags": [
"Envelope Wallet",
"Women's Leather"
],
"materials": [
"Full Grain Crazy Horse Leather"
],
"category": "Wallets",
"variations": [
{
"name": "Primary color",
"options": [
{
"value": "Tan",
"price": null,
"available": true
}
]
}
],
"whenMade": "2020_2026",
"shipsFromCountry": "TR",
"shipping": {
"shipsFrom": "Türkiye",
"freeShipping": true,
"deliveryEstimate": "Oct 26-Nov 2",
"deliverTo": "United States",
"returns": "Returns & exchanges accepted within 30 days."
},
"shop": {
"shopId": "28165607",
"shopName": "YukonLeatherGoods",
"sales": 6583,
"rating": 4.92,
"reviewCount": 1412,
"location": "Dover, Delaware",
"isStarSeller": true
},
"searchInput": "leather wallet",
"searchRank": 3,
"isAd": false
}
Price
Live Apify price on 2026-11-01, per 1,000 rows, by Apify plan. You pay only for rows delivered; error and summary rows marked free in the README cost nothing. Plus $0.001 per GB of memory when a run starts.
| Per 1,000 | Free | Bronze | Silver | Gold | Platinum | Diamond |
|---|---|---|---|---|---|---|
| Listing (main) | $7.20 | $6.48 | $5.76 | $5.40 | $5.40 | $5.40 |
| Review | $4.50 | $4.05 | $3.60 | $3.38 | $3.38 | $3.38 |
Use cases
- Niche research: search a keyword, sort by favorites and review count, read the tags of the winners.
- Competitor tracking: run the same listing URLs weekly and compare price, sale, favorites and reviews.
- Category sizing: how many listings, what price bands, how many shop sales behind them.
- Product sourcing: filter by price and ship-to country, then check delivery estimates.
Run it from code or an AI agent
Actor ID arcadium/etsy-products. Set APIFY_TOKEN to your Apify API token. The input below is the actor’s prefilled example; see the guide for every field.
curl
curl -X POST "https://api.apify.com/v2/acts/arcadium~etsy-products/run-sync-get-dataset-items" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"searchTerms":["ceramic mug"],"maxResultsPerSearch":20}'JavaScript
// npm install apify-client
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('arcadium/etsy-products').call({
"searchTerms": [
"ceramic mug"
],
"maxResultsPerSearch": 20
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);Python
# pip install apify-client
import os
from apify_client import ApifyClient
client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("arcadium/etsy-products").call(run_input={
"searchTerms": ["ceramic mug"],
"maxResultsPerSearch": 20,
})
items = client.dataset(run.default_dataset_id).list_items().items # apify-client 3.x returns a Run object
print(items)MCP
{
"mcpServers": {
"apify": {
"url": "https://mcp.apify.com/?tools=arcadium/etsy-products",
"headers": {
"Authorization": "Bearer <APIFY_TOKEN>"
}
}
}
}LangChain
# pip install langchain-apify (reads APIFY_API_TOKEN from the environment)
from langchain_apify import ApifyActorsTool
tool = ApifyActorsTool("arcadium/etsy-products")
rows = tool.invoke({"run_input": {
"searchTerms": ["ceramic mug"],
"maxResultsPerSearch": 20,
}})
# or give `tool` to an agent: create_react_agent(llm, [tool])LlamaIndex
# pip install llama-index-readers-apify
import os
from llama_index.core import Document, VectorStoreIndex
from llama_index.readers.apify import ApifyActor
reader = ApifyActor(os.environ["APIFY_TOKEN"])
documents = reader.load_data(
actor_id="arcadium/etsy-products",
run_input={
"searchTerms": ["ceramic mug"],
"maxResultsPerSearch": 20,
},
dataset_mapping_function=lambda item: Document(text=str(item.get("text") or ""), metadata={"url": item.get("url")}),
)
index = VectorStoreIndex.from_documents(documents)CrewAI
# pip install crewai crewai-tools langchain-apify (reads APIFY_API_TOKEN from the environment)
from crewai import Agent
from crewai_tools import ApifyActorsTool
tool = ApifyActorsTool(actor_name="arcadium/etsy-products")
researcher = Agent(
role="Research analyst",
goal="Answer with data collected by the tool",
backstory="Uses public web data.",
tools=[tool],
)n8n
{
"nodes": [
{
"name": "Run arcadium/etsy-products",
"type": "n8n-nodes-base.httpRequest",
"typeVersion": 4,
"position": [
0,
0
],
"parameters": {
"method": "POST",
"url": "https://api.apify.com/v2/acts/arcadium~etsy-products/run-sync-get-dataset-items",
"authentication": "genericCredentialType",
"genericAuthType": "httpHeaderAuth",
"sendBody": true,
"specifyBody": "json",
"jsonBody": "{\"searchTerms\":[\"ceramic mug\"],\"maxResultsPerSearch\":20}",
"options": {
"timeout": 300000
}
}
}
],
"connections": {}
}Google Sheets
// Extensions > Apps Script. Store your token once: Project Settings > Script properties > APIFY_TOKEN.
function importLastRun() {
const token = PropertiesService.getScriptProperties().getProperty('APIFY_TOKEN');
const url = 'https://api.apify.com/v2/acts/arcadium~etsy-products/runs/last/dataset/items?status=SUCCEEDED&clean=true&format=json';
const res = UrlFetchApp.fetch(url, { headers: { Authorization: 'Bearer ' + token } });
const rows = JSON.parse(res.getContentText());
if (!rows.length) return;
const keys = Object.keys(rows[0]);
const values = rows.map((r) => keys.map((k) => (typeof r[k] === 'object' ? JSON.stringify(r[k]) : r[k])));
const sheet = SpreadsheetApp.getActiveSheet();
sheet.clearContents();
sheet.getRange(1, 1, 1, keys.length).setValues([keys]);
sheet.getRange(2, 1, values.length, keys.length).setValues(values);
}Limitations
- Public listing data only. Nothing behind a login.
- Prices are in the seller's currency (
currency), with Etsy's US-dollar figure inpriceUsd. Shipping and delivery estimates are for a US shopper. - Search pages show what Etsy decides to show at that moment: rank and paid placements change from run to run.
- A listing found by two keywords is returned (and charged) once, with the first keyword and its rank.
createdAtis the date Etsy keeps for the listing; a renewal resets it, so old listings can look new.- The number of sales of a single listing and "in carts" counts are not part of the public listing data; the shop's lifetime sales are.
FAQ
How fresh is the data? It is read when you run the actor, so it matches what Etsy shows at that moment.
Why are some listings marked isAd? With includeAds on, the paid placements on each results page are returned too and flagged. They carry no rank.
A keyword returned an error row. Why? no_match means Etsy has no results for it. blocked or unavailable means the page could not be read this time; try again later.
Something looks wrong in the output. Who do I tell? Open an issue on the actor page with the run link. We read them all.
Related actors
1688 Products Scraper
1688.com wholesale products scraper, $1.80 per 1,000 search rows and $4.49 with details: price tiers, MOQ, units sold, factory and supplier scores.
$1.80 per 1,000 product (search result)s on the Free plan, down to $1.35 on higher plans
Amazon Product & Best Sellers Scraper
Amazon product search, Best Sellers ranks and Buy Box offers on 21 stores, $0.54 per 1,000 search rows vs $1 at the two most used search actors.
$0.54 per 1,000 search results