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.
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.
{
"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.
{
"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.
{
"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.
{
"credentials": [
{
"short_id": "zn_acct_a1b2c3d4",
"email": "orders@example.com",
"retailer": "etsy",
"has_totp": true,
"has_forwarding": true
}
],
"total": 1
}Etsy Integration FAQ
You can search products, place orders, track shipments, and handle returns through a single Zinc API integration for Etsy.
No. Zinc handles the retailer-side ordering workflow so your app can place orders directly via API calls.
Yes. You can fetch tracking status through the API and subscribe to webhook events for shipping and delivery updates.
Create an account, get your API key, and follow the Zinc API docs to send your first search or order request.