What is the Etsy Open API base URL?

The Etsy Open API base URL is https://openapi.etsy.com/v3

Etsy Open API — Base URL, Auth & Endpoints

Q: Does Etsy Open API have a free tier?

Yes. Unlimited API calls; Etsy charges sellers listing/transaction fees

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.

Quick Reference

Base URL https://openapi.etsy.com/v3 Auth type OAuth 2.0 Auth header

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

Rate limit 10,000 requests/day per app Pricing Free tier available Free quota Unlimited API calls; Etsy charges sellers listing/transaction fees Documentation https://developers.etsy.com/documentation Endpoint status Server online — HTTP 404 — server is online but path returned an error (may require auth)2.14s (checked Mar 29, 2026) Builder score B 65% builder-friendly

Pricing

Latency

Depth

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)

Pricing

Model freemium Starting price Free tier available Free quota Unlimited API calls; Etsy charges sellers listing/transaction fees

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

Key Endpoints

Method	Path	Description
GET	`/application/listings/active`	Search active listings across the marketplace
GET	`/application/shops/{shop_id}`	Get shop details and seller info
GET	`/application/shops/{shop_id}/listings`	List all listings in a specific shop
POST	`/application/shops/{shop_id}/listings`	Create a new listing in your shop
GET	`/application/shops/{shop_id}/receipts`	List orders (receipts) for a shop
GET	`/application/listings/{listing_id}`	Get details for a specific listing

Sample Request

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

Sample Response

{
  "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"
  }]
}