# Etsy Shop Products API (https://www.socialcrawl.dev/platforms/etsy/shop-products)

> Returns one page of listings from an Etsy shop, 36 per page, each with listing id, title, price, original price where discounted, image, shop name, and listing URL. Pass the shop name (AceElegance) or the shop URL. Sort by most_recent (default), price_low, or price_high. The result total Etsy reports equals the page size, so it is not returned: paginate until a page comes back short. Feed a returned listing id into GET /v1/etsy/product for the full listing.

TL;DR: `GET /v1/etsy/shop/products` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | no | Etsy shop name, the path in etsy.com/shop/AceElegance. Shop names also come back on every product as product.seller. |
| `url` | no | Full Etsy shop URL, for example https://www.etsy.com/shop/AceElegance or https://aceelegance.etsy.com. |
| `page` | no | Page number, starting at 1. Prefer the universal cursor parameter. |
| `limit` | no | Listings per page, 1 to 36. Default 36. |
| `sort_by` | no | Result ordering: most_recent (default), price_low, or price_high. (most_recent \| price_low \| price_high) |
| `currency` | no | ISO 4217 currency code for displayed prices. Default USD. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/etsy/shop/products" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

See the full Etsy API: https://www.socialcrawl.dev/platforms/etsy

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing