# Etsy Open API

**Provider:** Etsy
**Category:** ecommerce
**Base URL:** `https://openapi.etsy.com/v3`
**Auth:** oauth2 — `x-api-key: YOUR_KEYSTRING
Authorization: Bearer OAUTH_TOKEN (for write ops)`
**Rate Limit:** 10,000 requests/day per app
**Free Tier:** Yes — [object Object]
**Pricing:** Free tier available (freemium)
**Docs:** https://developers.etsy.com/documentation

## Description

The Etsy Open API v3 provides access to the Etsy marketplace. Search active listings across millions of handmade and vintage products, retrieve shop information and seller profiles, manage shop listings (CRUD), handle order receipts and transactions, upload listing images, and access shipping profiles. Uses OAuth 2.0 for seller-scoped operations and an API key for public data.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://openapi.etsy.com/v3/application/listings/active` | Search active listings across the marketplace |
| GET | `https://openapi.etsy.com/v3/application/shops/{shop_id}` | Get shop details and seller info |
| GET | `https://openapi.etsy.com/v3/application/shops/{shop_id}/listings` | List all listings in a specific shop |
| POST | `https://openapi.etsy.com/v3/application/shops/{shop_id}/listings` | Create a new listing in your shop |
| GET | `https://openapi.etsy.com/v3/application/shops/{shop_id}/receipts` | List orders (receipts) for a shop |
| GET | `https://openapi.etsy.com/v3/application/listings/{listing_id}` | Get details for a specific listing |

## Authentication

Use OAuth 2.0 (PKCE) for seller-scoped endpoints. Pass your API key in the x-api-key header for public read operations.

```
x-api-key: YOUR_KEYSTRING
Authorization: Bearer OAUTH_TOKEN (for write ops)
```

## Sample Request

```bash
curl "https://openapi.etsy.com/v3/application/listings/active?keywords=handmade+ceramic+mug&limit=3" \
  -H "x-api-key: $ETSY_API_KEY"
```

## Sample Response

```json
{
  "count": 4821,
  "results": [{
    "listing_id": 1234567890,
    "title": "Handmade Ceramic Mug - Speckled Blue",
    "price": {"amount": 3500, "divisor": 100, "currency_code": "USD"},
    "quantity": 12,
    "shop_id": 9876543,
    "url": "https://www.etsy.com/listing/1234567890"
  }]
}
```

## Pricing Details

API access is free. Etsy charges sellers: $0.20 listing fee per item, 6.5% transaction fee on sales. No developer API subscription fee.

---

*Source: [API Map](https://apimap.dev/apis/etsy/) — CC BY 4.0*