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

> Access Etsy data through 4 API endpoints. Profiles, posts, comments, search, and more. Unified schema, AI-enriched. Free trial.

TL;DR: SocialCrawl's Etsy API exposes 4 endpoints, 5 credits per call, all returning one unified JSON schema with AI-enriched fields. 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 "https://www.socialcrawl.dev/v1/etsy/product" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

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

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