Buy from Etsy via API

Automate purchases from Etsy's handmade and vintage marketplace. Buy unique, artisan products programmatically through Zinc.

How the Etsy integration works

Etsy is the leading online marketplace for handmade, vintage, and unique goods, connecting millions of buyers with independent sellers worldwide. Zinc's Etsy integration provides programmatic access to Etsy's distinctive catalog of artisan products, custom gifts, vintage finds, and craft supplies.

Perfect for gifting platforms that want to offer personalized and unique items, rewards programs looking for distinctive products, and any application that values craftsmanship and originality.

Retailer: etsy.com | US Rank: #9 | Free Shipping: $35+

What you can build with the Etsy API

Build with the Etsy integration API for search, ordering, tracking, and returns.

Etsy Order Placement API

Place orders with a product URL and shipping address. No checkout flows required — Zinc handles the retailer-side workflow and processes orders asynchronously.

POST/orders

{
  "products": [
    {
      "url": "https://etsy.com/...",
      "quantity": 1
    }
  ],
  "shipping_address": {
    "first_name": "Jane",
    "last_name": "Doe",
    "address_line1": "123 Main St",
    "city": "San Francisco",
    "state": "CA",
    "postal_code": "94105",
    "country": "US",
    "phone_number": "5551234567"
  },
  "max_price": 39900
}

Etsy Order Status API

Retrieve order details including item statuses, shipping address, and processing results. Poll to track progress from pending through to delivery.

GET/orders/{order_id}

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "order_placed",
  "max_price": 39900,
  "items": [
    {
      "url": "https://etsy.com/...",
      "quantity": 1,
      "status": "shipped"
    }
  ],
  "tracking_numbers": [
    {
      "carrier": "ups",
      "tracking_number": "1Z999AA10123456784",
      "created_at": "2026-01-15T14:30:00Z"
    }
  ],
  "created_at": "2026-01-15T10:00:00Z"
}

Etsy Shipment Tracking

Tracking numbers are automatically extracted from retailer shipping notifications and returned in the order response. Supports UPS, FedEx, USPS, Amazon Logistics, and DHL.

GET/orders/{order_id}

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "order_placed",
  "tracking_numbers": [
    {
      "carrier": "ups",
      "tracking_number": "1Z999AA10123456784",
      "created_at": "2026-01-15T14:30:00Z"
    },
    {
      "carrier": "amazon",
      "tracking_number": "TBA123456789000",
      "created_at": "2026-01-16T09:15:00Z"
    }
  ]
}

Etsy Managed Accounts

Use Zinc-managed checkout accounts or bring your own retailer credentials. Managed accounts handle login, 2FA, and payment automatically — no account setup required.

GET/managed-accounts

{
  "credentials": [
    {
      "short_id": "zn_acct_a1b2c3d4",
      "email": "orders@example.com",
      "retailer": "etsy",
      "has_totp": true,
      "has_forwarding": true
    }
  ],
  "total": 1
}

Etsy Integration FAQ

What can I do with the Etsy API integration?

You can search products, place orders, track shipments, and handle returns through a single Zinc API integration for Etsy.

Do I need to build a checkout flow for Etsy?

No. Zinc handles the retailer-side ordering workflow so your app can place orders directly via API calls.

What is the free shipping minimum for Etsy?

Etsy offers free standard shipping on orders of $35 or more before tax. Varies by seller; $35 is the recommended threshold for US orders. Orders below the minimum will incur a shipping fee. Note that shipping policies can change, so check Etsy's website for the most current thresholds.

Can I get shipment tracking updates for Etsy orders?

Yes. You can fetch tracking status through the API and subscribe to webhook events for shipping and delivery updates.

How do I start using the Etsy integration API?

Create an account, get your API key, and follow the Zinc API docs to send your first search or order request.