Crawl: the most reliable web crawler APISee what’s new
Zenrows
Talk to sales Start free

Etsy scraper

The Zenrows Etsy scraper turns an Etsy search or market URL into structured JSON: listing ID, title, price, original price, discount, free shipping, rating, review count, shop name, Star Seller flag and bestseller badge. You send the URL, Fetch in Adaptive Stealth Mode opens the page, and Extract returns the fields. Run it from an API call, the CLI or an AI agent.

Site
etsy.com
Returns
Listings, prices, shops, ratings and badges
Runs on
Fetch, Extract, Batch, Crawl
Updated
{
  "listings": [
    {
      "badge": null,
      "currency": null,
      "discount_percent": 25,
      "free_shipping": true,
      "is_ad": null,
      "is_star_seller": null,
      "listing_id": "4491753413",
      "listing_url": "https://www.etsy.com/listing/4491753413/handmade-stoneware-coffee-mug-16oz-large?click_key=…",
      "original_price": 34.99,
      "price": 26.24,
      "review_count": null,
      "review_rating": 4.8,
      "shop_name": "NovaCeramicsCo",
      "shop_url": "https://www.etsy.com/shop/NovaCeramicsCo",
      "thumbnail_url": "https://i.etsystatic.com/36752604/r/il/24186c/7933063958/il_794xN.7933063958_cfzi.jpg",
      "title": "Handmade Stoneware Coffee Mug 16oz, Large Ceramic Mug with Handle, Artisan Pottery Mug, Modern Coffee Cup, Gift for Coffee Lovers"
    }
  ],
  "related_searches": [],
  "search_context": {
    "canonical_url": "https://www.etsy.com/market/handmade_mug",
    "query": "handmade_mug",
    "total_results": null
  }
}

Request and output of a live call to an Etsy search page on Oct 20, 2026, trimmed for length. The full response held 60 listings. A field is returned when the card shows it.

What data can you scrape from Etsy?

An Etsy search returns one record per listing card, in the order Etsy ranks them, plus the search context.

These are the fields that come back, with the path where each lives in the JSON.

FieldWhat it holdsExample
listings[].listing_id Etsy's listing ID, the number in every /listing/ URL 4491753413
listings[].title Listing title, usually packed with the seller's keywords Handmade Stoneware Coffee Mug 16oz…
listings[].price The price a buyer pays today 26.24
listings[].original_price The price before the sale, when a discount runs 34.99
listings[].discount_percent Size of the sale 25
listings[].currency Currency symbol, when the card shows one Rp
listings[].free_shipping Whether the card carries the free shipping label true
listings[].review_rating Shop rating out of 5 shown on the card 4.8
listings[].review_count Number of reviews shown next to the rating (2.2k)
listings[].shop_name The Etsy shop selling the item NovaCeramicsCo
listings[].shop_url The shop's page, ready to request https://www.etsy.com/shop/NovaCeramicsCo
listings[].is_star_seller Whether the shop holds Etsy's Star Seller badge true
listings[].badge Etsy's ranking badges, such as bestseller or popular now bestseller
listings[].is_ad Whether the card is a paid placement null
listings[].thumbnail_url The listing's main photo https://i.etsystatic.com/…jpg
search_context.canonical_url The /market/ page Etsy maps the query to https://www.etsy.com/market/handmade_mug
search_context.query The query as Etsy normalised it handmade_mug

How to scrape Etsy with Zenrows

  1. Create a free Zenrows account and copy your API key from the dashboard.
  2. Pick the Etsy URL. A search (/search?q=…), a market page (/market/handmade_mug), a category (/c/…) or a shop (/shop/ShopName). Set Etsy's own filters in the browser first, such as price, ship-to country or Star Seller, and copy the URL they produce.
  3. Send it with the default configuration: Adaptive Stealth Mode to open the page and Extract to return the fields. Add the country when you need prices as a buyer there sees them.
  4. Read parsed.listings from the response. To keep only some fields, list their paths and the response returns just those.
  5. Run every keyword and page in Batch when one search returns what you need, with the keyword or listing ID as your external_id.
# pip install requests
import json
import requests

params = {
    "apikey": "YOUR_ZENROWS_API_KEY",
    "url": "https://www.etsy.com/search?q=handmade+mug",
    "mode": "auto",      # Adaptive Stealth Mode
    "extract": "auto",   # structured JSON
}
response = requests.get("https://api.zenrows.com/v1/", params=params, timeout=180)
response.raise_for_status()

data = response.json()["parsed"]
for item in data["listings"]:
    print(item["listing_id"], item["price"], item["shop_name"], item["badge"])
print(json.dumps(data["search_context"], indent=2))

Input

The scraper takes one Etsy URL per request, plus the options below.

A Batch job applies the same options to every task, so tracking 300 keywords is a list of search URLs with these settings.

ParameterTypeDefaultDescription
url string required Any Etsy page: search (/search?q=…), market (/market/…), category, listing (/listing/ID) or shop (/shop/Name)
mode string auto Adaptive Stealth Mode: starts with the lightest setup and adds rendering and protected-site handling only when the page needs them
extract string auto Returns the page's fields as JSON in parsed, next to the raw html
extract_fields string all fields Comma-separated paths to keep, such as listings.listing_id,listings.price,listings.badge
proxy_country string any Two-letter country code. Etsy converts prices to the visitor's local currency and changes shipping labels by location
wait_for string none A CSS selector to wait for before the page is read
session_id integer none Keep the same session across several requests, up to 10 minutes, for example while you page through one search
Batch input
{
  "type": "regular",
  "status": "closed",
  "zenrows_params": {
    "mode": "auto",
    "extract": "auto"
  },
  "tasks": [
    { "url": "https://www.etsy.com/search?q=handmade+mug", "external_id": "kw-handmade-mug" },
    { "url": "https://www.etsy.com/search?q=handmade+mug&page=2", "external_id": "kw-handmade-mug-p2" },
    { "url": "https://www.etsy.com/market/handmade_mug", "external_id": "market-handmade-mug" }
  ]
}

Output

Every response is JSON with two keys: html, the page as Etsy served it, and parsed, the structured record. A search page returns listings[], related_searches[] and search_context. The sample below shows three more listings from the same live search: a bestseller with free shipping, a discounted item and a popular-now listing.

Need a spreadsheet? Load listings into pandas with pd.json_normalize(...) and write CSV or Excel. Need the page for an LLM? Ask for Markdown instead of JSON.

Search results
{
  "listings": [
    {
      "badge": "bestseller",
      "currency": null,
      "discount_percent": null,
      "free_shipping": true,
      "is_ad": null,
      "is_star_seller": true,
      "listing_id": "4296141840",
      "listing_url": "https://www.etsy.com/listing/4296141840/coffee-mug-kj-pottery?click_key=…",
      "original_price": null,
      "price": 57,
      "review_count": null,
      "review_rating": 4.9,
      "shop_name": "KJPottery",
      "shop_url": "https://www.etsy.com/shop/KJPottery",
      "thumbnail_url": "https://i.etsystatic.com/7825028/r/il/553467/6863380541/il_794xN.6863380541_5poq.jpg",
      "title": "Coffee Mug - KJ Pottery"
    },
    {
      "badge": null,
      "currency": null,
      "discount_percent": 10,
      "free_shipping": true,
      "is_ad": null,
      "is_star_seller": true,
      "listing_id": "1179506710",
      "listing_url": "https://www.etsy.com/listing/1179506710/seconds-sale-handmade-pottery-large-mug?click_key=…",
      "original_price": 38,
      "price": 34.2,
      "review_count": null,
      "review_rating": 4.9,
      "shop_name": "JKCreativeWood",
      "shop_url": "https://www.etsy.com/shop/JKCreativeWood",
      "thumbnail_url": "https://i.etsystatic.com/11111774/r/il/dac199/3772432579/il_794xN.3772432579_3grh.jpg",
      "title": "SECONDS SALE | Handmade Pottery | Large Mug (8 colors)"
    },
    {
      "badge": "popular_now",
      "currency": null,
      "discount_percent": null,
      "free_shipping": null,
      "is_ad": null,
      "is_star_seller": true,
      "listing_id": "837615700",
      "listing_url": "https://www.etsy.com/listing/837615700/handmade-ceramic-coffee-mug-large?click_key=…",
      "original_price": null,
      "price": 35.7,
      "review_count": null,
      "review_rating": 4.9,
      "shop_name": "BZceramics",
      "shop_url": "https://www.etsy.com/shop/BZceramics",
      "thumbnail_url": "https://i.etsystatic.com/18265806/r/il/c16dd8/7360466365/il_794xN.7360466365_61zd.jpg",
      "title": "Handmade Ceramic Coffee Mug: Porcelain Espresso Cup"
    }
  ],
  "related_searches": [],
  "search_context": {
    "canonical_url": "https://www.etsy.com/market/handmade_mug",
    "query": "handmade_mug",
    "total_results": null
  }
}

Connect the MCP server (Claude Code)

claude mcp add zenrows -e ZENROWS_API_KEY=YOUR_ZENROWS_API_KEY -- npx -y @zenrows/mcp

MCP config (Cursor, Claude Desktop, Windsurf)

{
  "mcpServers": {
    "zenrows": {
      "command": "npx",
      "args": ["-y", "@zenrows/mcp"],
      "env": { "ZENROWS_API_KEY": "YOUR_ZENROWS_API_KEY" }
    }
  }
}

Or run the CLI

npx -y @zenrows/cli init
zenrows extract "https://www.etsy.com/search?q=handmade+mug"

Then ask your agent

Use Zenrows to search Etsy for "handmade mug" and "ceramic mug", first two
pages each. Group the listings by shop, and show me the 10 shops with the most
bestseller badges, their price range and whether they are Star Sellers.

Scrape Etsy from your coding agent

Claude Code, Cursor, Codex and any MCP client can scrape Etsy from a prompt.

The agent sends the same Fetch and Extract request a developer would and reads the same listings array. Connect the Zenrows MCP server once, or install the CLI and let the agent run it in the terminal. No key is needed to try either: the first call creates a free account.

Scrape Etsy at scale with Batch and Crawl

Batch runs a list of Etsy URLs as one job, in parallel, with your own ID on each result. Use it for weekly keyword research: one task per keyword and results page, so you can see which listings and shops hold the top spots and how their prices move.

Crawl finds the URLs for you. Start it on a shop or a market page, keep only links that contain /listing/, and it returns every listing page it reaches. Send that list to Batch when you want to track the same items over time.

Scheduled jobs run the same Batch job on a timetable, on Zenrows' side: every few hours, once a day, at set times on chosen days, or once at a future date. Each run keeps its own results, a webhook can tell your app when a run finishes, and you can pause or resume the schedule at any time, with no cron server to keep alive.

curl -X POST "https://async.api.zenrows.com/v1/jobs" \
  -H "X-API-Key: YOUR_ZENROWS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "regular",
    "status": "closed",
    "zenrows_params": { "mode": "auto", "extract": "auto" },
    "tasks": [
      { "url": "https://www.etsy.com/search?q=handmade+mug", "external_id": "kw-handmade-mug" },
      { "url": "https://www.etsy.com/search?q=ceramic+planter", "external_id": "kw-ceramic-planter" }
    ]
  }'

# Read the results when the job finishes
curl "https://async.api.zenrows.com/v1/jobs/JOB_ID/results?status=successful" \
  -H "X-API-Key: YOUR_ZENROWS_API_KEY"

What teams do with Etsy data

Use caseData they pullWho runs it
Product and niche research Listings per keyword, bestseller and popular-now badges, price spread Etsy sellers and print-on-demand shops
Etsy SEO and rank tracking Position of each listing for a keyword, title wording, ad flag Sellers and Etsy agencies
Competitor shop monitoring A shop's listings, prices, sales and rating over time Shop owners and brand teams
Pricing and discount analysis Price, original price and discount percent across a category Makers, wholesalers and analysts
Trend spotting New listings and badges in a niche week over week Product designers and buyers
Design and IP watch Titles and photos that copy a protected design, and the shops behind them Brand protection and legal teams

Tips for scraping Etsy

  • Page through search with page=. /search?q=handmade+mug&page=2 is the second page. Each page returns its own set of listings, so loop until a page comes back with none.
  • Clean the listing URL before you store it. Search cards carry long tracking parameters (click_key, ref, ga_*). https://www.etsy.com/listing/LISTING_ID opens the same item, so keep listing_id as your key.
  • Market pages are stable keyword pages. search_context.canonical_url shows the /market/ page Etsy ties a query to. Track that URL when you want the same keyword page every week.
  • Pin the currency. Etsy converts prices to the visitor's local currency, and currency follows the card. Send every request for a dataset from the same country so prices compare.
  • Read badges as ranking signals. bestseller, popular_now and the Star Seller flag are Etsy's own labels. Counting them per shop shows who wins a niche faster than prices do.
  • Parse review counts as text. Cards show counts like (173) or (2.2k). Strip the brackets and expand the k before you sort.

Frequently asked questions

  • Collecting public Etsy data, such as listing titles, prices, ratings and shop names shown to every visitor, is common practice for market research and pricing. Shop pages and reviews can name individual makers and buyers, and personal data is protected by laws such as the GDPR and the CCPA, so collect only what you have a legitimate reason to use. Check Etsy's terms of use for your use case and ask your lawyer if you are unsure.

  • Yes. The Etsy Open API v3 returns listings, shops and reviews to registered apps. You need an approved API key, sellers' own data needs their OAuth consent, and each app gets a request quota per second and per day. Commercial use needs Etsy's approval. Teams scrape Etsy when they need search rankings, badges and the page exactly as shoppers see it, without waiting on an app review.

  • Search results, market pages (/market/…), category pages, single listings (/listing/ID) and shop pages (/shop/Name). Send the URL as it appears in your browser, with any filters you set on Etsy.

  • Yes. Send the shop URL to see its listings, or start a Crawl on the shop and keep the links that contain /listing/ to collect every item it sells. Run the result in Batch each week to see new listings, price changes and items that sold out.

  • Each card carries the shop's rating and review count. For review text, request the listing or shop page, where Etsy shows the reviews, and read them from the response, or ask for the page as Markdown and pass it to an LLM.

  • Send a GET request to https://api.zenrows.com/v1/ with your API key, the Etsy URL, Adaptive Stealth Mode and Extract turned on, as in the Python example above. The response's parsed key holds the listings as a Python dictionary. The zenrows package on PyPI wraps the same request.

  • Send one URL per request, or a whole list as a Batch job that runs the URLs in parallel and keeps your own ID on each result. One Batch job accepts more than 10,000 URLs, sent inline or as a CSV file.

  • Yes. Connect the Zenrows MCP server to Claude, Cursor, Codex or any MCP client, or give your agent the Zenrows CLI. Ask for the searches or shops you want in plain language and the agent calls Fetch and Extract for you.

  • Yes. Create a scheduled Batch job with your Etsy URLs and the same settings as a single request, and Zenrows runs it on its side: every few hours, once a day, at set times on chosen days, or once at a future date. Each run keeps its own results, a webhook can notify your app when a run finishes, and the schedule can be paused or resumed at any time.

  • Zenrows works with n8n, Make, Zapier, Clay, Dify, LangChain, LlamaIndex, CrewAI and Mastra, plus the Python, Node.js and Go SDKs and any HTTP client. Send listings to Google Sheets, Airtable or a database from the workflow tool you already use. See the integrations page for the full list.

  • JSON by default, with the structured record in parsed and the original page in html. You can also ask for the page as Markdown or plain text, which is what most LLM and RAG pipelines want.

Turn the live web into usable data.

Start building free 5,000 credits/month, always