Etsy+API.SH

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
Etsy search
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}
1 credit · $1 per 1,000 calls

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 search suggestions/etsy/v1/autocomplete
qmugcount11shop_search_urlhttps://www.etsy.com/search/shop…
suggestions[]query · url · search_types
Etsy category listings/etsy/v1/category
pathhome-and-living/kitchen-and-diningnameKitchen & Diningpage1next_page2urlhttps://www.etsy.com/c/home-and-…count63
breadcrumbs[]name · url
subcategories[]path · name · url
listings[]id · title · url · price · currency · original_price · discount · rating · reviews · shop · shop_url · shop_id
Etsy listing/etsy/v1/listing
id1371848548titleHandmade Ceramic Mug - Large Sizeurlhttps://www.etsy.com/listing/137…price35currencyUSDavailabilityInStockquantity5638rating5reviews251shopNeherpotteryshop_id5855415shop_urlhttps://www.etsy.com/shop/Neherp…descriptionThis large ceramic mug is the bi…categoryHome & Living < Kitchen & Dining…favorites792ships_fromMilton Freewater, ORlisted_onOct 23, 2026free_shippingtrue
shipping_rate[]value · currency
variations[]name · options
json_ld[]@type · @context · url · name · sku · description · image · category · brand · logo · aggregateRating · offers

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

Search and discovery2
Etsy search suggestions
/etsy/v1/autocomplete
params qdocstry
$1 · $2 PAYG
1 credit
Etsy search
/etsy/v1/search
params q +14 optionaldocstry
$1 · $2 PAYG
1 credit
Comments and reviews2
Etsy listing reviews
/etsy/v1/listing_reviews
params none required +6 optionaldocstry
$1 · $2 PAYG
1 credit
Etsy shop reviews
/etsy/v1/shop_reviews
params none required +3 optionaldocstry
$1 · $2 PAYG
1 credit
Products, listings and places4
Etsy category listings
/etsy/v1/category
params none required +10 optionaldocstry
$1 · $2 PAYG
1 credit
Etsy listing
/etsy/v1/listing
params none required +2 optionaldocstry
$1 · $2 PAYG
1 credit
Etsy shop listings
/etsy/v1/shop_listings
params none required +6 optionaldocstry
$1 · $2 PAYG
1 credit
Etsy similar listings
/etsy/v1/similar
params none required +2 optionaldocstry
$1 · $2 PAYG
1 credit
More data1
Etsy shop
/etsy/v1/shop
params none required +4 optionaldocstry
$1 · $2 PAYG
1 credit

Call the Etsy API

Etsy search: GET https://api.api.sh/etsy/v1/search

curl "https://api.api.sh/etsy/v1/search?q=ceramic+mug" \
  -H "x-api-key: $APISH_KEY"
  1. Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
  2. Create an API keyOne key works for all 918 platforms.
  3. Send the requestJSON back in one call. Add output=csv or output=ndjson for 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.

More e-commerce APIs all e-commerce APIs →

Start with 1,000 free credits
Every month, on every account. One key works for all 918 platforms.
Get a free API key