# Etsy Data API (https://www.socialcrawl.dev/platforms/etsy)

> The SocialCrawl Etsy API returns public Etsy listing data as JSON across 4 endpoints. Look up one listing by id or URL for its title, description, price, images, shop name and stock, walk a shop's catalogue 36 listings per page, pull around 12 similar listings with shop ratings, and expand keywords with Etsy's search autocomplete.

TL;DR: SocialCrawl's Etsy API exposes 4 endpoints, 5 credits per call, all returning one unified JSON schema with computed fields such as engagement rate, language and content category. Single x-api-key auth, 100 free credits on signup.

## Endpoints

| Endpoint | Method | Path | Credits | Description |
| --- | --- | --- | --- | --- |
| Product | GET | `/v1/etsy/product` | 5 | Get an Etsy listing by id or URL |
| Shop Products | GET | `/v1/etsy/shop/products` | 5 | List products in an Etsy shop |
| Product Similar | GET | `/v1/etsy/product/similar` | 5 | Get listings similar to an Etsy product |
| Search Suggestions | GET | `/v1/etsy/search/suggestions` | 5 | Get Etsy search suggestions |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/etsy/product" \
  --data-urlencode "product_id=1215970085" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

Every response shares one JSON envelope: `{ success, platform, endpoint, data, credits_used, credits_remaining }`.

## FAQ

### What data does the SocialCrawl Etsy API return?

It returns one listing's title, description, price and currency, images, shop name, in-stock flag and quantity, looked up by listing id or URL. The other endpoints cover a shop's listings, similar listings and search autocomplete, all as JSON. Credits for failed or empty calls are refunded automatically.

### How do I find an Etsy listing id?

It is the number in the listing URL: etsy.com/listing/1215970085 has the listing id 1215970085. You can also pass the full URL as url and the id is read from the path. Every row from shop/products and product/similar carries a listing id too.

### Can I search all Etsy listings by keyword?

Full listing search is not on this API yet. search/suggestions returns Etsy's autocomplete suggestions for a partial query, which helps you expand a keyword. Start from a shop name with shop/products, or from a listing id you already have.

### How do I get every listing in an Etsy shop?

Call shop/products with the shop name, which is the path in etsy.com/shop/AceElegance, or with the shop URL. Each page holds up to 36 listings, sorted by most_recent, price_low or price_high. Keep paging until a page comes back short.

### Can I get Etsy listings in another currency or language?

Yes, the product endpoint takes country (a two-letter ship-to code, default US), currency (default USD) and language (default en-US). When the listing supports it, the country changes the currency and the copy language as well.

### Does the Etsy API return reviews or seller profiles?

Reviews, shop profiles and seller data are not on this API today. Each listing still carries its shop name, and every similar-listing row includes the shop rating.

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

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How do I get Etsy listing data as JSON with the SocialCrawl API?
- Can SocialCrawl return every listing in an Etsy shop?
- Which API returns similar Etsy listings with shop ratings? Does SocialCrawl?