GET/etsy/listing/{id}apiKey2 credits/request
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.
Required: id.
Sampled 14 Oct 2026: 19 fields returned with a value. In the sample: create_date: 2026-10-11; price: 101.66; currency: “USD”; url: etsy.com; title: 124 characters; materials: 1 entry; description: 595 characters; price_int: 10,166.
Open in Playground
GET/etsy/listing/{id}/reviewsapiKey1 credit/request
Returns 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.
Required: id. Optional: offset, sort (5 allowed values: newest, oldest, highest_rating, lowest_rating, most_relevant).
Sampled 14 Oct 2026: 24 items. Filled in every item: rating, text, language. In the sample: rating: 2 to 5, median 5.
Open in Playground
GET/etsy/searchapiKey3 credits/request
Searches 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.
Required: q. Optional: offset, limit.
Sampled 14 Oct 2026: 28 items. Filled in every item: listing_id, title, url, image, price, price_int, currency, shop_id and 3 more. In the sample: price: 22.53 to 80.78, median 40; title: “Personalized ceramic mug, Handmade heart thumb rest coffee…” and 27 other values; url: etsy.com; image: i.etsystatic.com; price_int: 2,253 to 8,078, median 4,000; shop_name: “MargieGrodskyPottery” and 23 other values; shop_rating: 4.8 to 5, median 4.95; quantity: 1 to 9,289, median 49.
Open in Playground
GET/etsy/shop/{id}apiKey2 credits/request
Returns an Etsy shop profile: seller, headline, rating, and sold count. Accepts a numeric shop id or a shop name.
Required: id.
Sampled 14 Oct 2026: 11 fields returned with a value. In the sample: open_date: 2021-04-03; sold_count: 1,481; shop_name: “gaguatelier”; seller_avatar: i.etsystatic.com; headline: “Funny, Joyous, Unique and Handcrafted Ceramics”; icon: i.etsystatic.com; average_rating: 4.94; reviews_count: 464.
Open in Playground
GET/etsy/shop/{id}/listingsapiKey2 credits/request
Lists 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.
Required: id. Optional: q, offset, limit.
Sampled 14 Oct 2026: 24 items. Filled in every item: listing_id, title, url, image, price, price_int, currency, shop_id and 3 more. In the sample: price: 51.25 to 462.76, median 105.05; url: etsy.com; title: median 138 characters; image: i.etsystatic.com; price_int: 5,125 to 46,276, median 10,505; quantity: 1 to 14, median 1.
Open in Playground
GET/etsy/shop/{id}/reviewsapiKey1 credit/request
Returns 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.
Required: id. Optional: offset, limit.
Sampled 14 Oct 2026: 14 items. Filled in every item: rating, text, language. In the sample: rating: 4 to 5, median 5.
Open in Playground
GET/etsy/shop/searchapiKey2 credits/request
Searches 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.
Required: q. Optional: limit.
Sampled 14 Oct 2026: 10 items. Filled in every item: shop_id, shop_name, seller_avatar, location, active_listing_count, open_date. In the sample: open_date: 2008-02-11 to 2016-04-14; active_listing_count: 18 to 902, median 159; shop_name: “TheMajorHouse” and 9 other values; seller_avatar: i.etsystatic.com; location: “Kansas City, Missouri” and 9 other values.
Open in Playground