# 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 -G "https://www.socialcrawl.dev/v1/etsy/product/similar" \
  --data-urlencode "product_id=1215970085" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What does the Etsy Product Similar API return?

Returns listings Etsy considers similar to a given product, typically around 12 rows, with price, image, shop name, and shop rating. 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 Similar endpoint?

Use it when you have a listing id and want nearby alternatives. This is a single page; there is no cursor.

### How much does the Etsy Product Similar 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 Similar 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 Similar API?

Send a GET request to https://www.socialcrawl.dev/v1/etsy/product/similar?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 Similar API return?
- How do I get Etsy Product Similar data with the SocialCrawl API?