Etsy Listings Scraper — Official API | from $1.50/1K | No Bot Blocks

Built for Etsy sellers doing competitor research, e-commerce analysts tracking pricing trends, and dropshippers validating handmade/supply niches.

Pricing: Pay per listing — $1.50/1K. First 10 results free.

Requires a free Etsy API key (5 min to register at etsy.com/developers). Once set up, zero COGS — the official API has no proxy or compute costs.

Scrape active Etsy listings using the official Etsy Open API v3 — structured, reliable data without anti-bot headaches. Search by keyword across all of Etsy or scrape all active listings from a specific shop.

What you get

Field	Description
listing_id	Numeric Etsy listing ID
shop_id	Numeric shop ID
title	Listing title
description	Full product description
price	Price as float (amount ÷ divisor, e.g. 28.00)
currency	ISO 4217 currency code (e.g. USD, EUR, GBP)
quantity	Available inventory quantity
views	View count (when available)
favorers	Number of users who favorited this listing
tags	Array of listing tags
taxonomy_id	Etsy taxonomy/category ID
listing_type	physical / download / both
who_made	i_did / someone_else / collective
when_made	Era string (made_to_order, 2020_2026, 1990s, …)
is_supply	Whether this is a supply/craft material
url	Full URL to the listing on etsy.com
scraped_at	ISO 8601 timestamp of this scrape
parse_confidence	Data quality score 0–1
warnings	Array of field-level quality warnings

Prerequisites

A free Etsy API key is required. Get one at: 👉 https://www.etsy.com/developers/register

Register a new app, and Etsy provides a keystring you pass as etsyApiKey input. The free tier is sufficient for most use cases.

Input

Parameter	Type	Required	Description
etsyApiKey	string (secret)	Yes	Your Etsy Open API v3 key
searchKeywords	string	No	Keyword search (e.g. "handmade candle")
shopId	string	No	Numeric shop ID to scrape
maxItems	integer	No	Max listings (default 100, 0 = unlimited)

At least one of searchKeywords or shopId is required.

Example inputs

Search listings:

{
  "etsyApiKey": "your_etsy_api_key",
  "searchKeywords": "handmade soy candle",
  "maxItems": 200
}

Scrape a shop:

{
  "etsyApiKey": "your_etsy_api_key",
  "shopId": "12345678",
  "maxItems": 500
}

How it works

• Keyword search: GET /v3/application/listings/active?keywords=<q>&limit=100&offset=N
• Shop scraping: GET /v3/application/shops/{shop_id}/listings/active?limit=100&offset=N
• Paginates automatically (100 listings/page, spec maximum)
• Price normalized from Etsy's Money object: price = amount / divisor
• Both modes can run together (deduplication by listing_id)

Technical notes

• Uses the official Etsy Open API v3
• API specification: https://www.etsy.com/openapi/generated/oas/3.0.0.json
• Endpoint paths and response schema validated against the spec at build time
• Unauthenticated probe at build time: GET /v3/application/listings/active → HTTP 403 (not 404), confirming the endpoint path is correct
• Live data validation: this actor is spec-validated. Live validation against real Etsy data happens on the buyer's first run with their own API key

vs. competitors

Feature	This actor	epctex/etsy-scraper
Data source	Official Etsy API v3	HTML scraping
Anti-bot risk	None	High (breaks on Etsy layout changes)
Structured fields	23 clean fields	8–12 inconsistent
tags, views, favorites	Yes	Rarely
Price	$1.50/1K	$3–5/1K

parse_confidence trust signal

Every record ships a parse_confidence score (0.0–1.0). Detects API drift early — your pipeline knows before buyers complain.

Use with AI agents (MCP)

This actor is tagged MCP_SERVERS — compatible with Claude, GPT-4o, and other MCP-aware agents:

https://mcp.apify.com/?tools=bovi/etsy-listings

Monetization

Pay-per-result (PPE): charged per listing returned. No charge for failed runs.

Integrations

Built for Etsy sellers and e-commerce analysts benchmarking competitor pricing, tags, and shop inventory — the JSON/dataset output drops into the tools you already run, no glue code:

• n8n / Make / Zapier — trigger a run or pipe every new dataset item into 500+ apps (Google Sheets, Airtable, Slack, HubSpot, your database) with no code: n8n, Make, Zapier.
• Webhooks — fire your own endpoint the moment a run finishes, to push results straight into your pipeline (docs).
• MCP server — expose this actor as a tool to Claude, Cursor, or any MCP client so an AI agent can pull this data mid-conversation (guide).
• API & SDKs — fetch the dataset as JSON, CSV, or Excel through the Apify REST API or the Python / JS SDKs.

See all Apify integrations.

Pricing example

Volume	Cost
100 listings	$0.15
1,000 listings	$1.50
10,000 listings	$15.00

First 10 results are free. You pay only for listings actually returned.

FAQ

Do I need an Etsy API key? Yes — a free key is required. Register at etsy.com/developers/register (takes ~5 minutes). No credit card needed. The free tier covers most use cases.

Is there a risk of being blocked? No. This actor uses Etsy's official API v3 — there is no anti-bot, no scraping, and no CAPTCHA risk.

What output formats are available? JSON (default), CSV, and Excel — via the Apify dataset export or API.

What if the actor returns empty? If searchKeywords returns no results, try a broader term. If you get a 403 error, your API key may be invalid — regenerate it at etsy.com/developers. If shopId returns not found, confirm the numeric ID (not the shop name).

Not affiliated with Etsy

This actor is an independent tool that uses Etsy's public API. It is not affiliated with, endorsed by, or connected to Etsy, Inc.