Etsy hub

Etsy Shop Listings API

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

GET /v1/etsy/shop/listings

1 credit Failed requests are free A not-found answer is still charged

About this endpoint

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.

Price

From $1.35 per 1,000 requests

1 credit per request. Failed requests are free.

Scale pack
$1.64 / 1,000
Growth pack
$2.36 / 1,000

The lowest rate is on annual plans; packs are pay as you go.

Example request

Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON

Etsy Shop Listings API 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.