Etsy Similar Listings API
The listings from other shops that Etsy recommends beside a listing.
GET /v1/etsy/listing/similar1 credit Failed requests are free A not-found answer is still charged
About this endpoint
GET /v1/etsy/listing/similar lists the listings Etsy shows as "You may also like" beside a listing, about 12, best first. listing is the listing id, such as 1136507412, or the listing link.
Each row carries listingId, title, url, imageUrl, price (the sale price when on sale), originalPrice, currency, shopId, isAd and freeShipping. Pass a row's listingId to GET /v1/etsy/listing for the whole listing. data.lookupStatus is not_found when no listing has the id.
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 Similar Listings API FAQ
Are ads included?
Yes. Ads in the row are kept in their place and marked with isAd: true, so you can drop them if you only want Etsy's own picks.
Why is shopName null?
The recommendations row doesn't show the shop's name, only its id in shopId. Read the listing with GET /v1/etsy/listing for its shop's name and link.
Can I page through more?
No. The list is the one row Etsy shows beside the listing, with no further pages. Call it on each of the results to go further.
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.