> **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>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/etsy/listing.mdx>

---

# Etsy Listing API

One listing with its price, pictures, shop, rating and newest reviews.

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

## Request

- **Endpoint:** `GET /v1/etsy/listing`
- **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/get)
- **Platform page:** [/platforms/etsy](https://www.socialfetch.dev/platforms/etsy)

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