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

> Returns one Etsy listing: title, description, price, currency, images, shop name, in-stock flag, and quantity. Pass the numeric listing id or the full etsy.com/listing/{id} URL. Search is not available on this surface yet; start from a known listing id or from GET /v1/etsy/shop/products. Similar listings for the same product: GET /v1/etsy/product/similar.

TL;DR: `GET /v1/etsy/product` 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 |
| --- | --- | --- |
| `product_id` | no | Etsy listing id, the numeric id in a listing URL: etsy.com/listing/1215970085 is listing id 1215970085. Listing ids also come back on every row of GET /v1/etsy/shop/products and GET /v1/etsy/product/similar. |
| `url` | no | Full Etsy listing URL, for example https://www.etsy.com/listing/1215970085/custom-air-freshener. The listing id is extracted from the path. |
| `country` | no | Ship-to country as a two-letter code. Default US. Changes currency and copy language when the listing supports it. |
| `currency` | no | ISO 4217 currency code for the displayed price. Default USD. |
| `language` | no | Listing copy locale, for example en-US, en-GB, fr, de. Default en-US. |

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

## FAQ

### What does the Etsy Product API return?

Returns one Etsy listing by id or URL: title, description, price, images, shop name, and whether it is in stock. The response uses the same JSON envelope as every SocialCrawl endpoint, with the data, credits_used and request_id fields.

### When should I use the Etsy Product endpoint?

Use it when you already have a listing id or etsy.com/listing URL. For listings in a shop, start at shop/products.

### How much does the Etsy Product API cost?

Each call costs 5 credits, so the 100 free credits every new account gets cover 20 calls. Credits for failed or empty calls are refunded automatically, and there is no subscription.

### What parameters does the Etsy Product API need?

Identify the target with one of product_id, url. It also accepts 5 optional parameters, all listed on this page.

### How do I call the Etsy Product API?

Send a GET request to https://www.socialcrawl.dev/v1/etsy/product?product_id=1215970085 with your API key in the x-api-key header. An Authorization: Bearer header works too.

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

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- What does the SocialCrawl Etsy Product API return?
- How do I get Etsy Product data with the SocialCrawl API?