List Etsy similar listings
List the listings from other shops that Etsy recommends beside a listing, with prices, sale prices and pictures.
Headers
Get your API keyAPI key (`sfk_...`)
Etsy listing id, e.g. `1136507412`: the number in a listing's address. A listing URL such as https://www.etsy.com/listing/1136507412/ is also accepted.
Endpoint-specific response payload.
Whether the item was found. `not_found` covers an id or name that doesn't exist and a listing or shop that was removed or closed (Etsy doesn't tell those apart).
one of: found, not_found
The listing asked for.
Listings Etsy recommends beside this one (its "You may also like" row), in its order: mostly other shops' listings, some of them ads (`isAd`). Empty when Etsy shows none.
Listing id: pass it to the listing endpoints.
Listing title.
The listing's Etsy address, without tracking parameters, e.g. `https://www.etsy.com/listing/1136507412/opal-inlay-huggie-earrings-set-by`.
Main picture, full size.
Price as shown, in `currency`, e.g. `26.25`: the sale price when the listing is on sale.
≥ 0
Price before the sale, when the listing is on sale; otherwise null.
≥ 0
ISO 4217 currency code of the prices, e.g. `USD`.
Numeric id of the shop selling it, e.g. `10204022`.
Name of the shop selling it, e.g. `CaitlynMinimalist`; null where the list doesn't show it (similar listings).
Whether Etsy shows the listing as an ad (a seller paid for the spot). Always false in a shop's own listings.
Whether the list shows free shipping to the US for it.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
one of: true
When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.
Code example
curl "https://api.socialfetch.dev/v1/etsy/listing/similar?listing=1136507412" \
-H "x-api-key: YOUR_API_KEY"Responses
Listings Etsy recommends beside the listing, or `not_found`.