Etsy Open API v3

Name: Etsy Open API v3 API
Brand: Etsy Open API v3
Availability: InStock

★ Only Publicly Available OpenAPI DocumentE CommerceStorefrontapiKey, oauth2103 EndpointsREST

For Agents

Manage Etsy shops, listings, orders, and payments across the handmade and vintage marketplace. Provides 103 endpoints for the complete seller lifecycle from product creation to fulfillment.

Install Jentic One Beta

Connect the Etsy Open API v3 to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Etsy Open API v3, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Etsy Open API v3 API.

Create and update product listings with images, videos, inventory tracking, and personalization options

Retrieve order receipts with line-item transactions and shipping tracking details

Configure shipping profiles with destinations, rates, and carrier-specific upgrade options

GET STARTED

Start building with Etsy Open API v3 API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Etsy Open API v3 API for, with concrete tasks.

★ AI Agent Listing Management

AI agents use the Etsy Open API through Jentic to automate listing creation and updates for handmade sellers. An agent can create listings with proper taxonomy classification, upload product images, set inventory quantities per variation, configure personalization options, and manage pricing — all without manual interaction with Etsy's seller tools. The 103-endpoint surface covers the complete listing lifecycle.

Create a new listing in shop ID 12345 with title 'Handmade Silver Ring', taxonomy ID 6648, price 45.00 USD, quantity 10, and upload a product image

Order Fulfillment and Tracking

Process Etsy orders and provide shipping updates through the receipts and tracking endpoints. Retrieve pending orders with buyer shipping addresses, mark orders as shipped with carrier and tracking number, and access transaction-level details for each line item. Supports multi-item orders with individual fulfillment tracking per receipt.

Retrieve all receipts with status 'open' for shop ID 12345, then add tracking with carrier 'usps' and tracking code '9400111899223100012345' to receipt ID 2345678

Shop Financial Reconciliation

Reconcile Etsy shop finances using the payment ledger and transaction endpoints. Access individual ledger entries showing listing fees, transaction fees, shipping label costs, and deposit amounts. Match payment entries to specific order receipts for accurate bookkeeping and tax preparation across reporting periods.

Retrieve all payment ledger entries for shop ID 12345 for the month of April 2026 and calculate total fees versus gross revenue

Multi-Channel Inventory Sync

Synchronize Etsy inventory with other sales channels by reading and updating listing quantities through the inventory endpoints. Each listing supports multiple product variations (size, color) with independent stock tracking. Pull current quantities, push updates after external sales, and monitor stock levels to prevent overselling across platforms.

Get the current inventory for listing ID 9876543 across all variations, then update the 'Small/Blue' variation to quantity 5

Key Endpoints

103 endpoints — jentic publishes the only available openapi specification for etsy open api v3, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/v3/application/shops/{shop_id}/listings

Create a new listing in a shop

GET

/v3/application/shops/{shop_id}/receipts

List order receipts for a shop

GET

/v3/application/listings/{listing_id}/inventory

Get inventory for a listing

POST

/v3/application/shops/{shop_id}/listings/{listing_id}/images

Upload an image to a listing

POST

/v3/application/shops/{shop_id}/receipts/{receipt_id}/tracking

Add shipping tracking to a receipt

GET

/v3/application/shops/{shop_id}/payment-account/ledger-entries

List payment ledger entries

GET

/v3/application/listings/active

Search active listings across Etsy

GET

/v3/application/buyer-taxonomy/nodes

Get buyer taxonomy categories

POST

/v3/application/shops/{shop_id}/listings

Create a new listing in a shop

GET

/v3/application/shops/{shop_id}/receipts

List order receipts for a shop

GET

/v3/application/listings/{listing_id}/inventory

Get inventory for a listing

POST

/v3/application/shops/{shop_id}/listings/{listing_id}/images

Upload an image to a listing

POST

/v3/application/shops/{shop_id}/receipts/{receipt_id}/tracking

Add shipping tracking to a receipt

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Etsy API keys and OAuth 2.0 PKCE tokens are stored encrypted in the Jentic vault (MAXsystem). Agents receive pre-authenticated requests — the PKCE flow, token refresh, and x-api-key injection are handled automatically.

Intent-based discovery

Agents search by intent (e.g., 'create an Etsy listing with images') and Jentic returns matching Etsy operations with full request schemas and required parameters, so the agent constructs the correct API call without navigating Etsy's developer documentation.

Time to first call

Direct Etsy API integration: 3-5 days for OAuth PKCE setup, taxonomy lookup, and inventory modeling. Through Jentic: under 1 hour — search, load schema, execute.

FAQs

Specific to using Etsy Open API v3 API through Jentic.

Why is there no official OpenAPI spec for Etsy Open API v3?

Etsy does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Etsy Open API v3 via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the Etsy Open API v3 use?

Etsy uses a two-tier auth model: an x-api-key header for public read operations and OAuth 2.0 with PKCE for shop-specific write operations. Through Jentic, both credentials are stored encrypted in the MAXsystem vault — agents receive pre-authenticated requests without managing the OAuth PKCE flow or key rotation.

Can I create listings with multiple variations and inventory tracking?

Yes. POST to /v3/application/shops/{shop_id}/listings to create a listing, then use the inventory endpoints to set up product variations (e.g., size and color combinations) with independent pricing and quantity per offering. Each variation gets its own SKU and stock count.

What are the rate limits for the Etsy Open API?

Etsy enforces a rate limit of 10 requests per second per API key for most endpoints. Some endpoints like search have lower limits. Exceeding limits returns a 429 response. The API returns X-RateLimit-Remaining and X-RateLimit-Limit headers with each response for proactive throttling.

How do I process orders and add tracking through Jentic?

Search Jentic for 'get Etsy order receipts' to discover GET /v3/application/shops/{shop_id}/receipts. Filter by was_shipped=false for unfulfilled orders. Then search for 'add tracking to Etsy order' to find the POST tracking endpoint. Pass carrier_name and tracking_code to mark the receipt as shipped.

Does the API support uploading listing images?

Yes. POST to /v3/application/shops/{shop_id}/listings/{listing_id}/images with a multipart form containing the image file. You can upload up to 10 images per listing and control display order via the rank parameter. Supported formats include JPEG, PNG, and GIF up to 10MB.

Can I browse Etsy's category taxonomy programmatically?

Yes. GET /v3/application/buyer-taxonomy/nodes returns the full category tree. Use /v3/application/buyer-taxonomy/nodes/{taxonomy_id}/properties to get required and optional attributes for a specific category. This ensures listings are created with correct classification and item specifics.

Etsy Open API v3

Connect the Etsy Open API v3 to your agent

Capabilities

Start building with Etsy Open API v3 API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs