+Etsy API
Etsy search, categories, listings, shops and buyer reviews as JSON, without waiting on Etsy app approval.
The API.SH Etsy API reads public Etsy pages. Search with Etsy's sorts and filters (price range, free shipping, on sale, Star Seller, Bestseller, customizable, personalizable, digital or physical, ship-to country, shop location and attribute filters such as color), or browse a category with its subcategories. A listing returns price, quantity, favorites, variations, shipping, returns, item highlights, sub-ratings and review topics. Shops return sales, admirers, rating, sections, policies and the owner's name, with every active listing paged. Listing and shop reviews, similar items and search suggestions complete the set.
- 9 endpoints
- from $1 / 1,000 calls
- 1,000 free credits / month
- failed calls free
GET https://api.api.sh/etsy/v1/ search
{"query": "ceramic mug","page": 1,"total_results": null,"next_page": 2,"url": "https://www.etsy.com/search?q=ceramic+mug&ref=pagination&page=1","count": 58,"bestseller_count": 16,"listing_ids": ["986959096","1702915637","… 43 more"],"listings": [{"id": "986959096","title": "Handmade Ceramic Coffee Mug","url": "https://www.etsy.com/listing/986959096","price": 33.5,"currency": "USD","original_price": null,"discount": null,"rating": 4.9,"reviews": 17000,"shop": "StonehousePotteryOH","shop_url": "https://www.etsy.com/shop/StonehousePotteryOH","shop_id": "8740835","ad": false,"bestseller": true,"star_seller": false,"free_shipping": false,"availability": null,"image": "https://i.etsystatic.com/8740835/r/il/5d9c6a/7287125227/il_255x319.7287125227_4xk9.jpg"},{"id": "1702915637","title": "Solstice Mug: Handmade Pottery Mug with Sun Design, Ceramic Coffee Cup in a Variety of Colors","url": "https://www.etsy.com/listing/1702915637","price": 34.87,"currency": "USD","original_price": 38.75,"discount": 10,"rating": 5,"reviews": 1100,"shop": "ShorProducts","shop_url": "https://www.etsy.com/shop/ShorProducts","shop_id": "19096197","ad": false,"bestseller": true,"star_seller": false,"free_shipping": false,"availability": null,"image": "https://i.etsystatic.com/19096197/r/il/00b10c/5918841167/il_255x319.5918841167_7pog.jpg"},"… 56 more"],"attribute_filters": [{"title": "Material","param": "attr_357","options": [{"name": "Ceramic","value": "83","active": false},{"name": "Stone","value": "255","active": false},"… 3 more"]},{"title": "Occasion","param": "attr_3","options": [{"name": "Birthday","value": "19","active": false},{"name": "Housewarming","value": "27","active": false},"… 3 more"]},"… 8 more"],"cached": false,"credits_used": 1} What you can build with the Etsy API
Niche and product research
Search a product idea with sort=reviews and bestseller=true to see which listings already sell, at what price, and how many favorites and reviews they collect; drill into categories to size the niche.
Competitor shop analysis
Read a rival shop's sales count, admirers, rating, year joined and sections, then page through every active listing with prices to see what they sell and how they price it.
Review mining for product improvements
Pull a listing's reviews sorted lowest first, with star distribution and the topics buyers mention, to find complaints about sizing, shipping or quality before you make a similar product.
Etsy SEO and tag ideas
Type the start of a phrase into Etsy's search suggestions to collect the queries buyers use, then check how crowded each one is with a search call and its listing count per page.
Price and discount monitoring
Re-read listings on a schedule to log price, original price and discount, availability and quantity, and catch when competitors put items on sale.
Finding related products and shops
From one listing, get the 'Similar items' module from other shops and more items from the same shop, to discover competitors and complementary products.
Etsy data you get
Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.
Etsy API endpoints and prices
Every Etsy endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing
| Etsy search suggestions /etsy/ | $1 · $2 PAYG 1 credit |
| Etsy search /etsy/ | $1 · $2 PAYG 1 credit |
| Etsy listing reviews /etsy/ | $1 · $2 PAYG 1 credit |
| Etsy shop reviews /etsy/ | $1 · $2 PAYG 1 credit |
| Etsy category listings /etsy/ | $1 · $2 PAYG 1 credit |
| Etsy listing /etsy/ | $1 · $2 PAYG 1 credit |
| Etsy shop listings /etsy/ | $1 · $2 PAYG 1 credit |
| Etsy similar listings /etsy/ | $1 · $2 PAYG 1 credit |
Call the Etsy API
Etsy search: GET https://api.api.sh/etsy/
curl "https://api.api.sh/etsy/v1/search?q=ceramic+mug" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/etsy/v1/search",
params={"q": "ceramic mug"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/etsy/v1/search");
url.searchParams.set("q", "ceramic mug");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); # Google Sheets (API.SH add-on)
=APISH("/etsy/v1/search", "q", "ceramic mug")
# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Etsy" and "Etsy search".
# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp - Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
- Create an API keyOne key works for all 918 platforms.
- Send the requestJSON back in one call. Add
output=csvoroutput=ndjsonfor files.
Why API.SH for Etsy data
- Public data only: no Etsy login, cookies or account needed
- One key and one response shape for Etsy and 917 other platforms
- Built and maintained by API.SH, not third-party publishers
- Pay per call; errors on our side cost nothing
- No rate limits: run as many calls in parallel as you need
- Live status for every endpoint
API.SH vs the official Etsy API
Etsy's Open API v3 uses OAuth 2.0 and an app key that Etsy must approve; personal apps that read data beyond your own shop can wait for review, and it is aimed at managing your own listings and orders. API.SH needs no app approval and returns public search, listing, shop and review data for any shop.
Etsy scrapers on Apify or guides from Oxylabs and ZenRows still leave you handling page changes and blocks. API.SH returns search, categories, listings, shops and reviews under one key with a fixed price per call.
Etsy API questions
What Etsy data can I get?+
Search (/etsy/v1/search) and search suggestions (/etsy/v1/autocomplete), category listings (/etsy/v1/category), one listing in full (/etsy/v1/listing) and its reviews (/etsy/v1/listing_reviews), similar items (/etsy/v1/similar), shop profiles (/etsy/v1/shop), all of a shop's listings (/etsy/v1/shop_listings) and shop reviews (/etsy/v1/shop_reviews).
How much does the Etsy API cost?+
Every Etsy endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.
Is there a free trial?+
Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /etsy/v1/autocomplete at 1 credit each.
How long does Etsy API approval take?+
With Etsy's own API, a personal app can sit in 'pending approval' before it works. API.SH needs no Etsy app at all: sign up, copy your key and the first call works right away.
Can I see another seller's Etsy sales?+
The shop endpoint returns the sales count, admirers, rating and review count that Etsy shows on the shop page, and the shop listings endpoint lists every active item with its price. Per-item sales figures are not public, so they are not included.
Can I filter for digital downloads or personalized items?+
Yes. /etsy/v1/search takes item_format=digital or physical, personalizable, customizable, bestseller, star_seller, on_sale and free_shipping, plus attributes for the page's own filters such as color or material.
How does pagination work?+
Search, category, shop, shop listings and both review endpoints return next_page; pass it back as page, and it is null on the last page. Listing reviews come 8 a page, shop listings 36.
Do I need an Etsy account?+
No. API.SH reads public Etsy pages only: no Etsy login, no OAuth token and no shop of your own.
How do I get started?+
Sign up at api.sh, copy your key and call /etsy/v1/search?q=personalized+necklace, then pass any listing id to /etsy/v1/listing. Docs are at https://api.sh/docs; the SDKs, Google Sheets, Zapier, Make, n8n and the MCP server (https://api.sh/mcp) take the same key.
Does the Etsy API have a rate limit?+
No. API.SH puts no rate limit on your key: send as many Etsy calls in parallel as you need and pay only for the calls that run. If Etsy itself slows down, the call returns 503 with a retry-after header and is not charged.