Marketplace and pricing research
Use Etsy endpoints to turn marketplace and pricing research into repeatable API requests with documented inputs and JSON responses.
Turn public Etsy listing and shop pages into structured marketplace data — keyword listing search, listing detail with pricing and quantity, listing and shop reviews, and shop profiles and catalogs, all as normalized JSON. Credential-free.
Search Etsy listings and shops, and get listing detail, shop profiles, and reviews back as structured JSON.
Endpoint families
3
Documented params
24
Examples
7
Live catalog snapshot
Active endpoints
7
Methods
GET
Required params
14
Schema refs
7
{
"platform": "Etsy",
"endpoint": "etsy-search",
"method": "GET",
"path": "/etsy/search",
"auth": "apiKey"
}Use cases
Search Etsy listings and shops, and get listing detail, shop profiles, and reviews back as structured JSON.
Use Etsy endpoints to turn marketplace and pricing research into repeatable API requests with documented inputs and JSON responses.
Use Etsy endpoints to turn seller and shop monitoring into repeatable API requests with documented inputs and JSON responses.
Use Etsy endpoints to turn review and rating analytics into repeatable API requests with documented inputs and JSON responses.
Managed execution
Every figure below is read from the live Etsy endpoint catalog — 7 endpoints, 24 documented request parameters, and 7 published response schemas — the same catalog Docs and Playground run against.
7 documented Etsy endpoints, grouped into 3 request families — Shop, Listing and Search.
24 request parameters are documented across those Etsy endpoints, 14 of them required — the full input contract is public before you write any integration code.
7 of the 7 Etsy endpoints ship a recorded example response, and 7 carry a documented response schema — you can code against the real JSON before the first request.
Etsy endpoints document their error responses (400, 404, 429, 500 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
7 hosted MCP tools back the Etsy endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Coverage map
/etsy/shop/search
/etsy/listing/{id}
/etsy/search
Endpoint catalog
/etsy/searchSearches Etsy listings across shops for the required keywords `q`, in Etsy's default relevance order. Page with `offset` (default 0) and `limit` (default 36, max 100). The response gives the total match `count`, and each result has listing id, title, URL, image, price, shop name and rating, quantity and sold-out flag. Read `currency`, since it is not fixed to USD.
Sampled 14 Oct 2026: 28 items, 11 fields filled in every item. price: 22.53 to 80.78, median 40; title: “Personalized ceramic mug, Handmade heart thumb rest coffee…” and 27 other values.
MCP tool etsy_search
/etsy/listing/{id}Returns the details of one Etsy listing by its numeric `id`: title, description, URL, price and currency, quantity, favorites, views, materials, tags, images and category. It also has the shop id and name, listing state, sold-out, customizable and digital flags, when it was made, shipping origin country, and create and update dates.
Sampled 14 Oct 2026: 19 of 19 fields returned with a value. create_date: 2026-10-11; price: 101.66.
MCP tool etsy_listing
/etsy/listing/{id}/reviewsReturns buyer reviews for an Etsy listing, identified by the numeric `id`. Start from `offset` (0-based, default 0) and order with `sort` (`newest`, `oldest`, `highest_rating`, `lowest_rating` or `most_relevant`). The response has the average rating and total rating count; each review has buyer, date, rating, text, language and whether the seller replied.
Sampled 14 Oct 2026: 24 items, 3 fields filled in every item. rating: 2 to 5, median 5.
MCP tool etsy_listing_reviews
/etsy/shop/searchSearches Etsy shops by the required keyword `q`, returning up to `limit` shops (default 10). Each shop has its id, name, avatar, location, active listing count, open date and a vacation-mode flag.
Sampled 14 Oct 2026: 10 items, 6 fields filled in every item. open_date: 2008-02-11 to 2016-04-14; active_listing_count: 18 to 902, median 159.
MCP tool etsy_shop_search
/etsy/shop/{id}Returns an Etsy shop profile: seller, headline, rating, and sold count. Accepts a numeric shop id or a shop name.
Sampled 14 Oct 2026: 11 of 11 fields returned with a value. open_date: 2021-04-03; sold_count: 1,481.
MCP tool etsy_shop
/etsy/shop/{id}/listingsLists the listings in an Etsy shop, identified by the required `id` (a numeric shop id or a shop name). Narrow with `q` to filter within the shop's own catalogue, and page with `offset` (default 0) and `limit` (default 24). Each listing has its id, title, URL, image, price, currency, quantity, shop rating and sold-out flag.
Sampled 14 Oct 2026: 24 items, 11 fields filled in every item. price: 51.25 to 462.76, median 105.05; url: etsy.com.
MCP tool etsy_shop_listings
/etsy/shop/{id}/reviewsReturns buyer reviews for an Etsy shop, identified by the required `id` (a numeric shop id or a shop name). Page with `offset` (default 0) and `limit` (default 14). The response has the average rating and total rating count. Each review has buyer, date, rating, text, language, the reviewed listing, and whether the seller replied.
Sampled 14 Oct 2026: 14 items, 3 fields filled in every item. rating: 4 to 5, median 5.
MCP tool etsy_shop_reviews
Related APIs
Marketplaces & Retail
Research new, used, and vintage instruments across Reverb listings, seller shops, and the Price Guide. Keep current asking prices separate from historical sales, and preserve model, finish, year, condition, and currency when comparing gear.
Marketplaces & Retail
Collect marketplace product signals from Amazon without building brittle storefront scrapers.
Marketplaces & Retail
Build resale, pricing, and marketplace workflows from structured eBay data.
Company coverage
Etsy, Inc. · ETSY
Etsy is operated by Etsy, Inc. (ETSY). Crawlora's SEC endpoints take the same company's CIK, so filings, financials, insider transactions and 13F holdings come from the same API key as the Etsy endpoints above.
Other Etsy, Inc. platforms in the catalog
How to scrape Etsy
Crawlora's Etsy endpoints return listing search, listing detail, shop profiles, shop catalogs, and reviews as normalized JSON with one API key — no HTML parsing or account required. A pull on 2026-10-27 for ceramic mug reported 1,583,626 matches and returned 28 results on the first page.
/etsy/search requires q and returns listings across shops in Etsy's relevance order; page with offset (default 0) and limit. /etsy/shop/search takes q and limit (default 10) and returns shops with their id, name, avatar and location.
/etsy/listing/{id} returns title, description, URL, price and currency, quantity, favorites, views, materials and tags for one numeric listing id. /etsy/listing/{id}/reviews pages buyer reviews with offset and a sort order such as newest.
/etsy/shop/{id} accepts a numeric shop id or a shop name and returns the seller, headline, rating and sold count. /etsy/shop/{id}/listings lists the shop's catalog, narrowed with q, and /etsy/shop/{id}/reviews pages shop-level reviews with offset and limit.
search returned count 1,583,626 and 28 results at offset 0, the first Solstice Mug: Handmade Pottery Mug with Sun Design (listing id 1702915637). Page with offset and limit rather than reading the count as a page size.
Listing, shop and review routes take the numeric listing or shop id, so keep ids as strings.
Agent skills
Install a Crawlora agent skill and your agent can pull Etsy data as JSON through the documented API, without writing a scraper. These skills cover Etsy:
Researches secondhand, resale, handmade, and musical-instrument marketplaces via the Crawlora API. Use to compare live listings and sellers, check…
npx skills add github.com/Crawlora-org/crawlora-skills --skill resale-secondhand-researchFAQ
Send a keyword to Crawlora's /etsy/search endpoint and get normalized listing cards back as structured JSON — no HTML parsing or proxy setup required.
No Etsy account, login, or API key is required from the caller — only your Crawlora API key. Etsy's own currency and price fields reflect the request's render locale, so read the returned `currency` field rather than assuming USD.
Yes — /etsy/shop/{id}/listings returns a shop's listing catalog and /etsy/shop/search finds shops by name, both in the same normalized listing-card shape as search results. Note the {id} segment: the shop id belongs in the path, so /etsy/shop/listings without it is a different route.
Yes, but it's gated and rate-limited. Etsy's Open API v3 requires an app-review approval — typically 24-48 hours — before your API key activates, and the default free tier caps usage at 10,000 requests per day, with higher limits only available by requesting them directly from Etsy. Crawlora's Etsy endpoints return listing, shop, and review data as structured JSON with a single API key, active immediately with no review wait or daily-request ceiling.
28 on the first ceramic mug page on 2026-10-27, out of 1,583,626 matches.