Arcadium Data Scrapers
Home / Actors / Etsy Scraper

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

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

What you get

FieldWhat it holds
listingId, title, urlThe listing id (the number in the link), its title and link.
price, currency, priceUsdPrice in the seller's currency (lowest option when options change the price), and Etsy's US-dollar figure.
salePrice, discountPercent, onSaleThe sale price and discount while a sale runs.
favoritesHow many shoppers saved the listing.
rating, reviewCount, ratingCountsThis listing's own reviews: average, count and per-star counts.
tags, materialsThe seller's search tags and materials.
category, categoryPath, taxonomyIdEtsy category.
variationsBuyer options (color, size, personalization...) with the price per option when it differs.
imagesFull-size image links.
whenMade, isDigital, isCustomizable, isMadeToOrder, isBestsellerWhat kind of item it is.
shippingShips from, free or cost, delivery estimate to the US, returns policy.
shopThe shop as a business: name, link, lifetime sales, rating, review count, location, active listings, favorites, opening date, Star Seller badge.
createdAt, updatedAtListing dates (a renewal resets createdAt).
searchInput, searchRank, isAdThe keyword or URL that found it, the organic position, and whether it was a paid placement.
scrapedAtWhen 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,000FreeBronzeSilverGoldPlatinumDiamond
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

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

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