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

---

# Etsy Shop Listings API

A shop and every active listing in it, in the order you choose.

`GET /v1/etsy/shop/listings` reads an Etsy shop and one page of its active listings, 36 a page. `shop` is the shop's name, the last part of its address (`PlanetJune`), or the shop link, such as `https://www.etsy.com/shop/PlanetJune`. `sort` is `custom` (the shop's own order), `newest`, `price_asc` or `price_desc`; omit it for the shop's default order.

`data.shop` carries `shopId`, `name`, `url`, `headline`, `location`, `logoUrl`, `bannerUrl`, `owners`, `rating`, `reviewCount` and `salesCount`. Each listing row carries `listingId`, `title`, `url`, `imageUrl`, `price`, `originalPrice`, `currency`, `shopId`, `shopName` and `freeShipping`. Pass `page.nextCursor` back as `cursor` while `page.hasMore` is true; `page.totalListings` counts the whole catalogue. `data.lookupStatus` is `not_found` when no shop has the name, or it closed.

## Request

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

## FAQ

### How far can I page?

Up to page 100, 3,600 listings. On page 100 of a longer catalogue truncated is true, and page.totalListings still gives the full count. Sorting by price the other way reaches listings from the other end of the catalogue.

### Is the shop name case-sensitive?

No. PlanetJune and planetjune read the same shop. A shop link on etsy.com, or the shop's own name.etsy.com address, works too.

### Which listings are included?

The shop's active listings: the ones on sale, as a visitor sees them on the shop's page.

### Does HTTP 200 mean the shop exists?

No. Check data.lookupStatus: found means the shop was read, not_found means no shop has the name, or it closed.

### 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. Each paginated page is a separate billed request.
