Etsy

List an Etsy shop's items

Read one page of a shop's public item grid: 36 listing cards with canonical URLs, prices, discounts, images and badges, plus the shop section, sort, page and total pages. Each successful request costs 1 account credit, including partial results. Failed requests cost 0 credits.

get/v1/etsy/shop/listings

Request

  • Base URL: https://api.scrapeatlas.com
  • URL: https://api.scrapeatlas.com/v1/etsy/shop/listings
  • Auth: API key in header x-api-key

Query parameters

handlestring

Etsy shop name as it appears in etsy.com/shop/{handle} (letters and digits); provide either handle or url.

urlstring

Full shop URL: https://www.etsy.com/shop/{handle}, a regional prefix such as /uk/shop/{handle}, or https://{handle}.etsy.com.

pageinteger

Page number starting at 1 (36 items per page, at most 250 pages).

sort'most_recent' | 'price_low' | 'price_high' | 'custom'

most_recent (default, Etsy date_desc), price_low, price_high or custom (the shop owner's arrangement).

section_idstring

Numeric shop section ID from the shop endpoint; omit for all items.

currency'AUD' | 'BRL' | 'CAD' | 'CHF' | 'CNY' | 'CZK' | 'DKK' | 'EUR' | 'GBP' | 'HKD' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'JPY' | 'MAD' | 'MXN' | 'MYR' | 'NOK' | 'NZD' | 'PHP' | 'PLN' | 'SEK' | 'SGD' | 'THB' | 'TRY' | 'TWD' | 'USD' | 'VND' | 'ZAR'

Display currency pinned through Etsy's own locale override (default USD). One of the 30 currencies Etsy offers; language and region stay en-US / US.

Response

Inspect the response status and failure or coverage fields.

OR

Changes

No recorded changes to this operation across all 1 revision of this API.