Product and niche research
Search a niche, then open the top listings for price, favorites, reviews, bestseller badges and tags. See what sells before you make it.
- 1search-by-keyword
- 2product-info-by-url
- Niche report
Listings, keyword search, shop catalogs, reviews, search suggestions and similar items: every Etsy endpoint Scrapier ships returns typed JSON in the same response envelope. Public data only.
Pick the data you need. Each live endpoint takes a listing, a shop or a keyword and gives you clean JSON back, for 1 or 2 credits per successful call. Cards without a GET path are on our final API list and show the input they take.
GET/api/v2/etsy-product-info-by-url/One listing by URL or ID: price, rating, favorites, stock, shipping, tags, materials and shop.
GET/api/v2/etsy-search-by-keyword/Etsy search results for a keyword, a page at a time: title, price, rating, reviews and shop.
GET/api/v2/etsy-search-suggestions/Autocomplete suggestions Etsy offers for partial search text, 20 per page.
GET/api/v2/etsy-shop-products/Every listing in one shop, a page at a time, with price, discount, badges and shipping.
GET/api/v2/etsy-product-reviews/Reviews of one listing or a whole shop: rating, text, buyer, date and seller response.
GET/api/v2/etsy-similar-products/Listings Etsy shows as similar to one listing, 20 per page, with price, rating and shop.
INkeywordsPublic email addresses on Etsy pages that match a keyword, with the page title, description and URL.
INkeywordsPublic phone numbers on Etsy pages that match a keyword, with the country and dial code.
Pick an endpoint, fill in the input and press Run. Without a key you see the catalog sample and nothing is billed. With your API key it runs a real call from your browser.
Every successful call costs 1 credit, whether the page holds one profile or a page of comments. Failed calls cost nothing. A free tier lets you try it first.
On Pro, 1,000 calls at 1 credit cost $1.58. Scale brings that to $1.20, so 250,000 Etsy calls a month is $299.
See all plans →| Plan | Price / mo | Credits / mo | Per 1,000 calls |
|---|---|---|---|
| Free | $0 | Free tier | — |
| Hobby | $29 | 15,000 | $1.93 |
| Pro | $79 | 50,000 | $1.58 |
| Scale | $299 | 250,000 | $1.20 |
Built to be easy to start with, even if you've never scraped a website. Here's how to get Etsy data in a few minutes:
next_cursor; pass it back as cursor for the next page.queries to etsy-search-by-keyword or partial text to etsy-search-suggestions.X-API-Key header, or ask your AI agent over MCP.Two ways in. Use whichever matches what you already have.
You already have the links to the pages you want.
etsy.com/listing/1215970085/custom-air-fresheneretsy.com/shop/AceEleganceRosysPatterns1215970085You don't know the items yet: find them with a keyword.
// GET /api/v2/etsy-product-info-by-url/ { "urls": "https://www.etsy.com/listing/1215970085/custom-air-freshener", "country": "US", "currency": "USD", "language": "en-US", "render": "auto" }
// GET /api/v2/etsy-search-by-keyword/ { "queries": "handmade necklace", "enable_fallback": "true" }
// GET /api/v2/etsy-search-suggestions/ { "queries": "leather", "locale": "en-US", "country": "US", "expand": "true" }
// GET /api/v2/etsy-shop-products/ { "urls": "https://www.etsy.com/shop/AceElegance", "sort": "most_recent", "currency": "USD", "include_details": "true" }
// GET /api/v2/etsy-product-reviews/ { "urls": "RosysPatterns", "sort_option": "Recency", "enrich_buyer_profiles": "false", "include_subratings": "false" }
// GET /api/v2/etsy-similar-products/ { "urls": "1215970085", "country": "US", "currency": "USD", "locale": "en-US", "include_unavailable": "false", "expand_similar": "true" }
| Send this | Parameter | And you can get |
|---|---|---|
| Listing URL or ID | urls | Listing details, similar listings, listing reviews |
| Shop URL, name or ID | urls | The shop's listings, or reviews of the whole shop |
| Keyword | queries | Search results, or autocomplete suggestions for partial text |
| Country and currency | country · currency | Prices and shipping for that market |
Optional on list endpoints: cursor (pass back next_cursor for the next page). Auth is one header: X-API-Key. Send parameters in the query string (GET) or as a JSON body (POST).
The one thing to know: each data type has its own shape. Field names stay the same on every call, so code and agents read them directly. Samples below come from the live catalog.
// GET /api/v2/etsy-product-info-by-url/?urls=https://www.etsy.com/listing/1215970085/custom-air-freshener // one item of data.product · catalog sample { "input_url": "https://www.etsy.com/listing/1215970085/custom-air-freshener", "listing_id": "1215970085", "status": "active", "id": "1215970085", "url": "https://www.etsy.com/listing/1215970085/custom-air-freshener-picture-air", "title": "Custom Air Freshener, Picture Air Freshener, Cute Car Accessories, Photo Freshener, Car Freshies, Car Decor", "description": "NEW improved print quality! We're proud to offer the highest...", "seller": "TheFreshener", "brand": "TheFreshener", "price": { "current": 12.95, "original": 12.95, "currency": "USD", "discount_percent": 0, "min": 12.95, "max": 12.95 }, "rating": { "average": 5, "count": 14661 }, "image_urls": [ "https://i.etsystatic.com/35332887/r/il/e41fa0/5469863166/il_fullxfull.5469863166_6sgn.jpg" ], "availability": "in_stock", "reviews_count": 14661, "seller_id": "35332887", "available_quantity": 80840, "favorites": 55433, "is_bestseller": true, "is_top_rated": true, "materials": [ "Cotton" ], "taxonomy_path": "electronics_and_accessories.car_parts_and_accessories.car_accessories.car_air_fresheners", "when_made": "made_to_order", "user_id": "628346348", "is_star_seller": true, "is_etsys_pick": true, "state": "active", "tags": [ "car freshener funny", "cute car air fresh", "funny car freshener" ], "section_name": "Custom Car Fresheners", "listed_on": "Sep 24, 2026", "created_at": "2026-09-24T11:07:33Z", "shop_url": "https://www.etsy.com/shop/TheFreshener", "shop_reviews_count": 19906, "urgency_signal": "In 20+ carts", "shipping": { "ships_from": "Jacksonville, FL", "origin_country": "US", "origin_region": "FL", "cost": 6.07, "cost_currency": "USD", "free_shipping": false, "free_shipping_threshold": 35, "estimated_delivery": "Sep 29-Oct 1", "accepts_returns": false, "accepts_exchanges": false }, "country": "US", "currency": "USD", "language": "en-US", "scraped_at": "2026-09-24T13:31:17.054Z" }
// GET /api/v2/etsy-search-by-keyword/?queries=handmade necklace // one item of data.listings · catalog sample { "listing_id": "1772679468", "listing_url": "https://www.etsy.com/listing/1772679468/handmade-sterling-silver-byzantine-chain", "title": "Handmade Sterling Silver Byzantine Chain Necklace - Bali Silver", "image_url": "https://i.etsystatic.com/52961888/r/il/881c8e/6192875617/il_fullxfull.6192875617_g6jb.jpg", "price": 105.04, "currency": "USD", "rating": 4.7, "review_count": 927, "shop_name": "SilverChainArts", "shop_url": "https://www.etsy.com/shop/SilverChainArts", "is_on_sale": true, "has_free_shipping": true, "badges": [], "data_source": "etsySearchApi", "search_query": "handmade necklace", "search_url": "https://www.etsy.com/search?q=handmade+necklace", "page": 1, "position": 1, "scraped_at": "2026-09-26T11:00:24.260Z" }
// GET /api/v2/etsy-search-suggestions/?queries=leather // one item of data.suggestions · catalog sample { "keyword": "leather", "position": 1, "query": "leather journal", "search_types": [], "search_type_names": [], "categories": [], "source": "v3+legacy", "seed": "leather", "depth": 0, "locale": "en-US", "country": "US", "search_url": "https://www.etsy.com/search?q=leather+journal", "scraped_at": "2026-09-24T13:07:55.516Z" }
// GET /api/v2/etsy-shop-products/?urls=https://www.etsy.com/shop/AceElegance // one item of data.products · catalog sample { "input_url": "AceElegance", "shop_name": "AceElegance", "shop_id": "27808603", "shop_url": "https://www.etsy.com/shop/AceElegance", "shop_total_listings": 183, "position": 1, "page": 1, "id": "1301638116", "url": "https://www.etsy.com/listing/1301638116/14k-solid-gold-family-birthstone", "title": "14K Solid Gold Family Birthstone Necklace, Birthstone Gift, Christmas Gift, Bridesmaid Gift, Gift for Mom", "description": "Silver Birthstone Necklace, Personalized Gifts, 14k Solid Gold Birthstone Jewelry, Family Necklace...", "seller": "AceElegance", "brand": "AceElegance", "price": { "current": 14.67, "original": 26.67, "currency": "USD", "discount_percent": 45, "display": "$14.67" }, "image_urls": [ "https://i.etsystatic.com/27808603/r/il/17eff8/4476872409/il_fullxfull.4476872409_hru6.jpg" ], "availability": "in_stock", "free_shipping": true, "badges": [ "FREE shipping" ], "shipping": { "cost": null, "estimated_delivery": "Sep 26-Oct 6", "accepts_returns": true, "accepts_exchanges": true }, "urgency_signal": "In 20+ carts", "listing_id": "1301638116", "shop_position": 1, "canonical_url": "https://www.etsy.com/listing/1301638116", "thumbnail_url": "https://i.etsystatic.com/27808603/c/1802/1432/408/0/il/17eff8/4476872409/il_340x270.4476872409_hru6.jpg", "is_ad": false, "sort": "date_desc", "search_query": null, "scraped_at": "2026-09-24T13:18:28.883Z" }
// GET /api/v2/etsy-product-reviews/?urls=RosysPatterns // one item of data.reviews · catalog sample { "input_url": "RosysPatterns", "review_type": "shop", "receipt_id": 5218626147, "buyer_user_id": 66570233, "buyer_real_name": "Flop", "buyer_login_name": "dorisgt", "buyer_image": "https://i.etsystatic.com/iusa/c4ae13/31745354/iusa_75x75.31745354_97zs.jpg?version=0", "listing_title": "Whole Shop 113 Rosys Patterns Sewing Patterns, Beginner Sewing Patterns, XXS-XXL, Bundle Set, Sewing Instructions, US Letter-A4-A0 Format", "review": "The seller is really lovely and talented. I haven't had a chance to sew any patterns yet, but I have no doubt they'll be beautiful. I'm so happy that the photos aren't ai generated. Love supporting creative and hardworking creators 💙", "appreciation_image": null, "product_rating": 5, "response": null, "reviews_count": 30, "date": "2026-09-26 06:36:27", "recommends": false, "subratings": {}, "product_details": { "shop_average_rating": 4.56, "shop_total_rating_count": 2074, "product_url": "https://www.etsy.com/listing/1791096370/whole-shop-113-rosys-patterns-sewing", "seller_name": "RosysPatterns", "seller_url": "https://www.etsy.com/shop/RosysPatterns", "reviewer_image": "https://i.etsystatic.com/42510206/r/il/55843f/8248553529/il_fullxfull.8248553529_agtm.jpg", "image": [ "https://i.etsystatic.com/42510206/r/il/55843f/8248553529/il_fullxfull.8248553529_agtm.jpg", "https://i.etsystatic.com/42510206/r/il/55843f/8248553529/il_75x75.8248553529_agtm.jpg", "https://i.etsystatic.com/42510206/r/il/55843f/8248553529/il_170x135.8248553529_agtm.jpg" ] }, "listing_id": 1791096370, "shop_id": 42510206, "position": 1, "page": 1, "sort_option": "Recency", "scraped_at": "2026-09-26T11:02:37.564Z" }
// GET /api/v2/etsy-similar-products/?urls=1215970085 // one item of data.products · catalog sample { "input_url": "1215970085", "source_listing_id": "1215970085", "position": 1, "depth": 1, "similar_to_listing_id": "1215970085", "id": "4557154966", "url": "https://www.etsy.com/listing/4557154966/custom-air-freshener-picture-air", "title": "Custom Air Freshener, Picture Air Freshener, Cute Car Accessories, Photo Freshener, Car Freshies, Car Decor", "description": "Custom Face Cut Car Air Freshener. Versatile Scent Selection...", "seller": "DidiDecous", "brand": null, "price": { "current": 11.98, "original": 23.96, "currency": "USD" }, "rating": { "average": 4.66, "count": 47 }, "image_urls": [ "https://i.etsystatic.com/61480419/r/il/17ef7d/8372827043/il_fullxfull.8372827043_mdpo.jpg" ], "availability": "in_stock", "reviews_count": 47, "ext": { "seller_id": "61480419", "available_quantity": 2989, "etsy": { "is_handmade": true, "is_bestseller": false, "is_made_to_order": true, "when_made": "made_to_order", "discount_percent": 50, "free_shipping": false, "ships_from_country": "US", "favorites": 1, "tags": [ "car freshener funny", "cute car air fresh" ], "materials": [ "Paper" ], "category": { "id": 1895, "name": "Car Accessories", "path": "electronics_and_accessories.car_parts_and_accessories.car_accessories" }, "shop": { "shop_id": "61480419", "name": "DidiDecous", "url": "https://www.etsy.com/shop/DidiDecous", "rating_average": 4.66, "rating_count": 47, "sold_count": 356, "active_listing_count": 71, "country_code": "US", "is_open": true }, "language": "en-US", "created_at": "2026-08-17T09:50:20Z", "updated_at": "2026-09-01T01:22:41Z" } }, "source_listing": { "id": "1215970085", "url": "https://www.etsy.com/listing/1215970085/custom-air-freshener-picture-air", "title": "Custom Air Freshener, Picture Air Freshener, ...", "seller": "TheFreshener", "seller_id": "35332887" }, "scraped_at": "2026-09-24T13:17:36.454Z" }
Every response is {"success": true, "data": {…}}: your input echoed back, the result under its own key (profile, posts, comments…) and next_cursor for the next page.
Public Etsy data powers product research, competitor tracking, keyword research for sellers and review analysis. Here are five common jobs, and the Etsy scraper endpoints each one chains together.
Search a niche, then open the top listings for price, favorites, reviews, bestseller badges and tags. See what sells before you make it.
Pull a competitor shop's full catalog with prices and discounts, then read its latest reviews. Spot new listings, price changes and what buyers praise or complain about.
Expand a seed word into the suggestions Etsy offers shoppers, then search each one to see how many listings compete and at what price.
Collect reviews for your own shop or a listing, with rating, text and date, and feed them to an LLM to find recurring themes in buyer feedback.
Start from one listing and pull the listings Etsy shows as similar, with price, rating and shop. Map the price range for a product type in one pass.
Etsy Scraper fetches clean, structured Etsy data at low cost: built for product research, seller keyword research, competitor tracking and AI agents.
Each request reads Etsy at call time, and records say when in scraped_at.
Same field names on every call: prices as numbers with currency, ratings as numbers, flags as booleans.
List endpoints return next_cursor; run up to 3 requests in parallel per key.
Listings, shops, reviews, search and suggestions share the same envelope and auth.
The Scrapier MCP server reaches every endpoint from Claude Code, Cursor, Windsurf and VS Code with one command.
Plain REST: Python, Node.js, cURL, n8n, Make, Zapier or Google Sheets.
Set country and currency on listing and similar-item calls to see local prices and shipping.
When Etsy changes its pages, Scrapier updates the scraper; your field names stay the same.
1 or 2 credits per call, however many items the page holds. Failed calls are never billed.
The official Etsy Open API v3 needs a registered Etsy app and API key, and OAuth for shop data you manage. Scrapier reads public Etsy listings, shops, reviews and search with one API key, at a price you know before the call runs.
Any non-2xx response is free, so retries cost nothing.
At 2 credits a call, the top Etsy price. Listing, search, shop and similar calls cost half that.
No Etsy app to register, API key to request or OAuth flow to build.
The same key and JSON envelope cover Amazon, eBay, AliExpress, Pinterest and more.
| Feature | Scrapier Etsy Scraper | Etsy Open API v3 | DIY scraper |
|---|---|---|---|
| Whose data | Any public listing or shop | Public listings, plus shops you authorize | Any public listing or shop |
| Setup | One API key | Etsy app, API key, OAuth for shop data | Proxies, browsers, parsers |
| Maintenance | Handled by Scrapier | Token refresh, API changes | Breaks on layout changes |
| Cost | From $1.20 per 1,000 calls | Free, within Etsy's rate limits | Servers, proxies and engineering time |
| AI agents | MCP server included | Build your own | Build your own |
No. Each endpoint returns one data type. To get a shop's listings and its reviews, call etsy-shop-products then etsy-product-reviews, or let an AI agent chain the calls over MCP.
Yes. etsy-product-reviews takes a listing URL or ID for that listing's reviews, or a shop URL or shop name for the reviews of the whole shop. The response says which one in review_type.
One listing with title, description, price and discount, rating and review count, favorites, stock, bestseller and Star Seller flags, tags, materials, shipping details and the shop URL. It costs 1 credit per successful call.
As many as Etsy shows publicly. Search, shop, review, suggestion and similar-item endpoints return a page at a time with next_cursor; pass it back as cursor for the next page. Each page is one call at 1 or 2 credits.
Yes. Listing, shop and similar-item endpoints take currency, and listing and similar-item calls take country for the ship-to market. These settings are locked into the cursor, so every page of a list uses the same market.
When Etsy doesn't show a value, the field is null, so you can tell "not shown" from zero. A shop listing may have no shipping cost, and a review may have no seller response or photo.
It depends on what you collect, where you are and how you use it, so this is not legal advice. Scrapier returns publicly visible data only. Buyer names in reviews can be personal data under GDPR or CCPA, so collect only what you have a legitimate reason to use.
Yes. Any tool that can make an HTTP request works: n8n, Make, Zapier, Google Sheets, Airbyte or your own code. Send your key in the X-API-Key header and read the JSON response.
Yes. Run claude mcp add -t http scrapier https://mcp.scrapier.io/mcp with your key in an X-API-Key header. The agent finds the right Etsy endpoint with search_endpoints and calls it with run_scrape, in Claude Code, Cursor or Windsurf.
Check the status code first: 401 means the X-API-Key header is missing, 403 an invalid key, 402 no credits left, 429 too many requests (wait Retry-After seconds). If it's still wrong, report it with the request and the response.
Listing details, search, shop listings and similar listings cost 1 credit per successful call; reviews and search suggestions cost 2. Failed calls are free. Plans: Hobby $29 for 15,000 credits, Pro $79 for 50,000, Scale $299 for 250,000, Enterprise custom. A free tier lets you try it first.
Run up to 3 requests in parallel per API key. If you go faster, the API answers 429 with a Retry-After header: wait that many seconds and retry. 429 and 5xx responses are never billed, and long-running endpoints need a client timeout of 210 seconds or more.
Use the requests library: requests.get("https://proxy.scrapier.io/api/v2/etsy-product-info-by-url/", headers={"X-API-Key": key}, params={"urls": "1215970085"}, timeout=210). The response is JSON, so read r.json()["data"]["product"] directly; there is no HTML to parse or proxy to run.
Free API key. No sales call, no proxy setup, and failed calls are free.