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

> Returns listings Etsy considers similar to a given product, typically around 12 rows, each with listing id, title, price, sale price where discounted, image, shop name, and the shop's aggregate rating. Pass the listing id or the listing URL. This is a single page: there is no cursor.

TL;DR: `GET /v1/etsy/product/similar` 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 displayed prices. Default USD. |
| `language` | no | Listing copy locale. Default en-US. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/etsy/product/similar" \
  -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