Etsy Scraper

Etsy Scraper

Etsy Scraper extracts full product details from Etsy listings: price and sale price, variations with the price of each option, all images, tags, materials, favorites, stock, category, when it was made and the shop that sells it. Paste listing URLs or IDs and get clean JSON, CSV or Excel.

Get 40+ fields per Etsy listing in any of 20 currencies, including the sale price and discount, the VAT-inclusive price for your buyer country, every option of every variation with its own price, full-size images, the seller's tags with their Etsy market links, and stock and availability. Hundreds of listings per minute, no proxy needed.

Copy to your AI assistant

Copy this block into ChatGPT, Claude, Cursor or any other LLM to start using this Actor.

Use the Apify Actor "parsebird/etsy-scraper" (Etsy Scraper) to get product details of Etsy listings. Call it with the apify-client package: Python `ApifyClient("<APIFY_TOKEN>").actor("parsebird/etsy-scraper").call(run_input={...})`, or JavaScript `new ApifyClient({ token }).actor('parsebird/etsy-scraper').call({...})`, then read items from the run's default dataset. Inputs: startUrls (array of {url}: Etsy listing URLs like https://www.etsy.com/listing/1544000459/..., country versions like etsy.com/uk/listing/... and shop subdomain links like shopname.etsy.com/listing/... also work; search, category and shop pages are not supported), listingIds (array of listing ID strings), currency ("USD" default, "EUR", "GBP", "CAD", "AUD", "NZD", "CHF", "SEK", "DKK", "NOK", "PLN", "JPY", "INR", "MXN", "BRL", "HKD", "SGD", "ILS", "TRY", "MYR"), country (optional two-letter buyer country for VAT in priceDisplay, e.g. "DE"), includeDescription (bool, default true), includeVariations (bool, default true), maxItems (int, optional), proxyConfiguration (object, default no proxy). Each item has listingId, url, name, description, price (seller's price before VAT, in the chosen currency), priceMax (highest option price for listings with variation pricing), currency, priceDisplay (price as Etsy shows it to a buyer in that country, VAT included where it applies), priceInclVat, onSale, salePrice, discountPercent, priceUsd, salePriceUsd, hasVariationPricing, quantity, isAvailable, isSoldOut, state (active, sold_out, vacation), favorites, images (full-size URLs), imageCount, seller {name, url, shopId, userId, avatar}, shopSection, variations [{label, values, options [{value, price, available}]}], highlights, materials, whenMade, isDigital, isMadeToOrder, isBestseller, isTopRated, category, categoryPath, categoryId, tags, relatedSearches [{name, link}], shipsFrom, listedOn, listedAt, updatedAt, input, scrapedAt. Deleted or expired listings are skipped and not charged. Pricing: pay per listing saved. API docs: https://apify.com/parsebird/etsy-scraper/api. Get a token at https://console.apify.com/settings/integrations.

What is Etsy Scraper?

Etsy Scraper turns Etsy listings into structured data. Give it the URLs or IDs of the listings you care about, such as your competitors' best sellers, your own shop's products or a list of items you track, and it returns each listing's price, sale price and discount, variations, images, tags, materials, favorites, stock, category and shop.

It works as an Etsy API alternative for product data: no Etsy developer account, API key or OAuth app is needed, and prices come back in any of 20 currencies.

To try it, open the Input tab and click Start. The prefill scrapes three listings: a leather watch band, an engraved cutting board and a digital planner download.

What can Etsy Scraper do?

• 🛍️ Full listing details: title, description, price, stock quantity, favorites, state (active, sold out, shop on vacation), when it was made, materials, category, shipping country and listing dates.
• 🏷️ Sale prices and discounts: see whether a listing is on sale, the discounted price and the discount percentage.
• 🎨 Variations with prices: every option of every variation (size, color, material, personalization choice), with its own price and availability, plus the price range for listings with variation pricing.
• 🖼️ All images: full-size image URLs for every photo of the listing.
• 🔖 Tags and related searches: the seller's tags, each with its Etsy market page link, which is useful for Etsy SEO research.
• 💱 20 currencies and VAT: prices in USD, EUR, GBP, CAD, AUD, JPY and 14 more, plus the VAT-inclusive price Etsy shows to buyers in the country you choose.
• 🏪 Shop details: shop name, shop URL, shop and user IDs, avatar and the shop section the listing belongs to.
• ⚙️ Built for automation: schedule runs to track prices, stock and favorites over time, call the Actor through the Apify API, send results to Make, Zapier, n8n, Google Sheets, Slack and more, and export as JSON, CSV, Excel or HTML.

What data can you extract from Etsy?

Field	Description
listingId, url, name	Etsy listing ID, listing URL and title
description	The seller's full description
price, priceMax, currency	Price before VAT in your currency, and the highest option price when options change the price
priceDisplay, priceInclVat	Price as Etsy shows it to a buyer in your country, with VAT where it applies (for example €46.48 in France)
onSale, salePrice, discountPercent	Whether the listing is discounted, the discounted price and the discount
priceUsd, salePriceUsd	The same prices in US dollars
quantity, isAvailable, isSoldOut, state	Stock quantity, availability and state (active, sold_out, vacation)
favorites	Number of people who added the listing to their favorites
images, imageCount	Full-size image URLs
seller	Shop name, shop URL, shop ID, user ID and avatar
shopSection	The section of the shop the listing is in
variations	Each variation with its label, values and options (value, price, available)
highlights, materials, whenMade	Digital download, made to order or the period it was made in, and the materials
isDigital, isMadeToOrder, isBestseller, isTopRated	Etsy's flags for the listing
category, categoryPath, categoryId	Etsy category, such as Home & Living > Kitchen & Dining > Cookware > Cutting Boards
tags, relatedSearches	The seller's tags and their Etsy market page links
shipsFrom	Country the item ships from
listedOn, listedAt, updatedAt	Listing date (Etsy resets it when a listing is renewed) and last update
input, scrapedAt	The listing ID you asked for and the collection time

How to scrape Etsy listings

1. Open Etsy Scraper on Apify Store and go to the Input tab.
2. Paste Etsy listing URLs into Etsy listing URLs, or listing IDs into Listing IDs. Use Bulk edit to paste many URLs at once.
3. Choose a Currency and, optionally, a Buyer country for VAT-inclusive prices.
4. Turn off Include description or Include variations if you don't need them.
5. Click Start. When the run finishes, download the dataset as JSON, CSV, Excel or HTML, or read it with the dataset API.

Input parameters

Parameter	Type	Default	Description
startUrls	array	—	Etsy listing URLs, including country versions (etsy.com/uk/listing/...) and shop subdomain links (shopname.etsy.com/listing/...)
listingIds	array	—	Etsy listing IDs, such as 1544000459
currency	string	USD	One of 20 currencies: USD, EUR, GBP, CAD, AUD, NZD, CHF, SEK, DKK, NOK, PLN, JPY, INR, MXN, BRL, HKD, SGD, ILS, TRY, MYR
country	string	currency's home country	Two-letter buyer country, used for the VAT in priceDisplay and priceInclVat
includeDescription	boolean	true	Add the full description
includeVariations	boolean	true	Add variations and option prices
maxItems	integer	all	Maximum listings to save
proxyConfiguration	object	no proxy	Optional proxy. The Actor works without one

Example input:

{
    "startUrls": [
        { "url": "https://www.etsy.com/listing/1544000459/leather-watch-bands-watch-bands-watch" },
        { "url": "https://www.etsy.com/listing/1436683539/personalized-cutting-board-customized" }
    ],
    "currency": "EUR",
    "country": "FR"
}

Output example

A listing with a sale and variation pricing, in euros for a buyer in France (the description and lists are shortened):

{
    "listingId": 1436683539,
    "url": "https://www.etsy.com/listing/1436683539/personalized-cutting-board-customized",
    "name": "Personalized cutting board, Customized engraved cutting board, Gift for couple, wedding, birthday, anniversary, housewarming | CNM1",
    "description": "Hello! We're a family-run business in Canada that specializes in crafting beautiful cutting boards...",
    "price": 38.73,
    "priceMax": 111.54,
    "currency": "EUR",
    "priceDisplay": "€46.48",
    "priceInclVat": 46.48,
    "onSale": true,
    "salePrice": 33.34,
    "discountPercent": 14,
    "priceUsd": 43.38,
    "salePriceUsd": 37.34,
    "hasVariationPricing": true,
    "quantity": 88,
    "isAvailable": true,
    "isSoldOut": false,
    "state": "active",
    "favorites": 3,
    "images": [
        "https://i.etsystatic.com/40491098/r/il/a58e03/4909363935/il_fullxfull.4909363935_fjnw.jpg"
    ],
    "imageCount": 7,
    "seller": {
        "name": "Peeekabooo",
        "url": "https://www.etsy.com/shop/Peeekabooo",
        "shopId": 40491098,
        "userId": 741516312,
        "avatar": "https://i.etsystatic.com/site-assets/images/avatars/default_avatar.png?width=75"
    },
    "variations": [
        {
            "label": "Choose the board size and material",
            "values": ["Small Maple", "Small Walnut", "Medium Maple", "Medium Walnut", "Large Maple", "Large Walnut", "Block Maple w/j", "Block Walnut w/j"],
            "options": [
                { "value": "Small Maple", "price": 38.73, "available": true },
                { "value": "Block Walnut w/j", "price": 111.54, "available": true }
            ]
        }
    ],
    "highlights": ["Made to order", "Materials: Wood"],
    "materials": ["Wood"],
    "whenMade": "Made to order",
    "isDigital": false,
    "isMadeToOrder": true,
    "isBestseller": false,
    "isTopRated": false,
    "category": "Cutting Boards",
    "categoryPath": ["Home & Living", "Kitchen & Dining", "Cookware", "Cutting Boards"],
    "categoryId": 1038,
    "shipsFrom": "CA",
    "listedOn": "Sep 02, 2026"
}

Use Etsy Scraper from Python or JavaScript

Install the client with pip install apify-client or npm install apify-client, and get your API token from Apify Console.

Python

from apify_client import ApifyClient

client = ApifyClient("<APIFY_TOKEN>")
run = client.actor("parsebird/etsy-scraper").call(run_input={
    "listingIds": ["1544000459", "285428763", "1880766496"],
    "currency": "USD",
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["name"][:50], item["price"], item["salePrice"], item["favorites"], item["quantity"])

JavaScript

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<APIFY_TOKEN>' });
const run = await client.actor('parsebird/etsy-scraper').call({
    startUrls: [{ url: 'https://www.etsy.com/listing/1544000459/leather-watch-bands-watch-bands-watch' }],
    currency: 'GBP',
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((l) => console.log(l.name, l.priceDisplay, l.tags.join(', ')));

Use cases

• Competitor price tracking: schedule daily runs on your competitors' listings and follow their prices, sales, stock and favorites.
• Etsy SEO research: collect the titles and tags (up to 13 per listing) of top listings in your niche to find the keywords sellers use.
• Product research: compare materials, variations, price ranges and favorites before you launch a product.
• Shop monitoring: watch your own listings for stock running out, expired listings or changes.
• International pricing: see what buyers in Germany, the UK, Japan or Canada pay, with VAT included.
• Catalog and feed building: feed listing data and images into spreadsheets, dashboards or price comparison tools.

How much does it cost to scrape Etsy?

Etsy Scraper uses pay-per-event pricing: you pay for each listing saved to the dataset. Compute and proxy costs are included in the event price, so they aren't billed separately.

Event	Free	Bronze	Silver	Gold
Listing scraped	$3.99 / 1,000	$3.49 / 1,000	$2.99 / 1,000	$2.49 / 1,000

At Free plan prices, 100 listings cost about $0.40 and 10,000 listings cost $39.90. Deleted or expired listings aren't saved and aren't charged. To control spending, set Max listings. The run also stops when it reaches the maximum cost per run you set in Apify Console.

Is it legal to scrape Etsy?

Etsy Scraper only collects listing information that Etsy shows publicly to any visitor. It doesn't log in and doesn't access buyer accounts, orders or messages. Listings can include personal data such as a seller's name or shop avatar. If you store or use that data, you're responsible for complying with the GDPR and other privacy laws, and with Etsy's Terms of Use. Consult a lawyer if you're unsure. For more background, read Apify's article Is web scraping legal?

Other e-commerce scrapers from ParseBird

Actor	What it does
Redbubble Scraper	Redbubble products by keyword, category or artist shop
Shopify Products Scraper	Full product catalog of any Shopify store
Faire Scraper	Wholesale brands, supplier leads and products from Faire
Depop Scraper	Depop listings, shops, sellers and reviews
Vinted Scraper	Vinted listings from search, category or seller pages
Mercari US Scraper	Mercari US listings with price, brand, condition and seller
eBay Sold Listings Scraper	eBay sold listings with real transaction prices
Amazon Search Scraper	Amazon search results in 18 marketplaces

FAQ

Can I scrape Etsy search results, categories or whole shops? Not at the moment. Etsy blocks automated access to its search, category and shop pages with bot protection, so Etsy Scraper takes listing URLs or IDs. If you paste a search, category or shop URL, the run log tells you it was skipped. To scrape a set of listings, collect their URLs first, for example from your browser, a spreadsheet or a Google search.

Does it return reviews, ratings or the shop's sales count? No. Those numbers aren't part of the listing data Etsy Scraper reads. You get favorites, stock quantity and Etsy's Bestseller and Top Rated flags instead.

Why is price lower than priceDisplay? price is the seller's price converted into your currency, before VAT. priceDisplay is what Etsy shows to a buyer in your Buyer country, which includes VAT in countries like Germany, France or the UK. For buyers in the US, both are the same. Variation option prices are before VAT, like price.

How is the sale price worked out? When a seller runs a sale, Etsy shows a discounted price next to the original one. Etsy Scraper reads the discounted price in US dollars (salePriceUsd) and applies the same discount to the price in your currency (salePrice). discountPercent is the discount, rounded.

Why do some listings have no price in my currency? Sold-out listings only come with a US dollar price. For them, price is in USD and currency is USD.

What happens with deleted or expired listings? Etsy no longer returns them, so they are skipped, listed in the run's status message and not charged.

Is listedOn the date the listing was first created? Not always. Etsy updates that date when a seller renews a listing, so for older listings it's usually the date of the latest renewal.

Do I need a proxy? No. The Actor runs without a proxy by default. In our tests on Apify, it handled 200 listing IDs in about 6 seconds. If Etsy starts refusing requests, add an Apify proxy in the Advanced section.

Can I run it on a schedule or from my own code? Yes. Use Apify schedules for daily or weekly runs, the Apify API or the Python and JavaScript clients shown above, and integrations to send results to Google Sheets, Slack, Make, Zapier or n8n.

Something doesn't work or a field is missing. What should I do? Open an issue on the Actor's Issues tab with your input and run ID, and we'll look into it.