Etsy

List Etsy similar listings

List the listings from other shops that Etsy recommends beside a listing, with prices, sale prices and pictures.

GET/v1/etsy/listing/similar
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
listingstringrequiredquery

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.

Response fields
21

Endpoint-specific response payload.

datalookupStatus
string

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

datalistingId
string

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.

datalistings[]listingId
string

Listing id: pass it to the listing endpoints.

datalistings[]title
string

Listing title.

datalistings[]url
string

The listing's Etsy address, without tracking parameters, e.g. `https://www.etsy.com/listing/1136507412/opal-inlay-huggie-earrings-set-by`.

datalistings[]imageUrl
stringnullable

Main picture, full size.

datalistings[]price
numbernullable

Price as shown, in `currency`, e.g. `26.25`: the sale price when the listing is on sale.

≥ 0

datalistings[]originalPrice
numbernullable

Price before the sale, when the listing is on sale; otherwise null.

≥ 0

datalistings[]currency
stringnullable

ISO 4217 currency code of the prices, e.g. `USD`.

datalistings[]shopId
stringnullable

Numeric id of the shop selling it, e.g. `10204022`.

datalistings[]shopName
stringnullable

Name of the shop selling it, e.g. `CaitlynMinimalist`; null where the list doesn't show it (similar listings).

datalistings[]isAd
boolean

Whether Etsy shows the listing as an ad (a seller paid for the spot). Always false in a shop's own listings.

datalistings[]freeShipping
boolean

Whether the list shows free shipping to the US for it.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

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

metafetchedAt
stringoptional

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`.