Etsy Listing API
One listing with its price, pictures, shop, rating and newest reviews.
GET /v1/etsy/listing1 credit Failed requests are free A not-found answer is still charged
About this endpoint
GET /v1/etsy/listing reads one Etsy listing. listing is the listing id, the number in its address (1136507412 is Caitlyn Minimalist's opal huggie earrings), or the listing link itself, such as https://www.etsy.com/listing/1136507412/.
data.listing carries listingId, url, title, description, price (the sale price when on sale), originalPrice, currency, minPrice and maxPrice across the listing's options, availability, quantity, images, videoUrl, categoryPath, material, the shop (id, name, link and icon), rating, reviewCount, the newest reviews, shipsFrom, shippingPrice to the US and the shop's faqs. data.lookupStatus is not_found when no listing has the id, or it was removed.
Price
From $1.35 per 1,000 requests
1 credit per request. Failed requests are free.
- Scale pack
- $1.64 / 1,000
- Growth pack
- $2.36 / 1,000
The lowest rate is on annual plans; packs are pay as you go.
Example request
Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
Etsy Listing API FAQ
Which links does it take?
Any Etsy listing link, such as https://www.etsy.com/listing/1136507412/opal-inlay-huggie-earrings-set-by, with or without the words after the id. The id alone works too. Other input is refused with HTTP 400.
What are minPrice and maxPrice?
The lowest and highest price across the listing's options, such as sizes, colours or personalisation. price is the price the listing shows first, the sale price when it is on sale, with originalPrice the price before the sale.
How many reviews do I get?
The newest reviews the listing page shows, up to 4, each with the stars, date, text and the buyer's name as Etsy shows it. rating and reviewCount summarise all of the listing's reviews.
Does HTTP 200 mean the listing exists?
No. Check data.lookupStatus: found means the listing was read, not_found means no listing has the id, or it was removed.
How many credits does a call cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.