> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/etsy/listing-similar>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/etsy/listing-similar.mdx>

---

# Etsy Similar Listings API

The listings from other shops that Etsy recommends beside a listing.

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

## Request

- **Endpoint:** `GET /v1/etsy/listing/similar`
- **Credits:** 1 credit
Failed requests are free
A not-found answer is still charged
- **Input:** by listing id or URL
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/etsy/listing/similar/get)
- **Platform page:** [/platforms/etsy](https://www.socialfetch.dev/platforms/etsy)

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