openapi.etsy.com

•

One-click Login

About Etsy

Etsy's Open API v3 is a REST API enabling developers and software vendors to integrate with the Etsy marketplace, which had 86.6 million active buyers and 5.6 million active sellers as of early 2026. The API supports listing management, order fulfillment, and shop management across approximately 70 endpoints. It uses OAuth 2.0 for authentication. V2 is being retired in late 2026, making V3 migration mandatory. Common use cases include multi-channel inventory sync, automated order processing, and analytics dashboards built on top of shop data.

AI Agent Use Cases

- Listing management: create, update, and delete product listings via API

- Order management: retrieve and update post-purchase order status

- Shop management: access shop metadata, sections, and receipts

- OAuth 2.0 authentication with granular permission scopes

- Rate limit of 10 calls per second per application

- OpenAPI specification available for AI coding assistant integration

Available Actions

These are the specific actions that AI agents can perform with this tool

Create Draft Listing Product

10 inputs

Creates a physical product draft listing in an Etsy shop to prepare items for sale.

Inputs

quantity

The positive non-zero number of products available for purchase in the listing. Note: The listing quantity is the sum of available offering quantities.

title

The listing

description

A description string of the product for sale in the listing.

price

The positive non-zero price of the product. (Sold product listings are private) Note: The price is the minimum possible price.

whoMade

An enumerated string indicating who made the product. Helps buyers locate the listing under the Handmade heading. Requires **Is Supply** and **Who Made** properties.

whenMade

An enumerated string for the era in which the maker made the product in this listing. Helps buyers locate the listing under the Vintage heading. Requires **Is Supply** and **Who Made** properties.

taxonomyType

The type of taxonomy.

taxonomyId

The numerical taxonomy ID of the listing.

isSupply

When true, tags the listing as a supply product, else indicates that it

listingType

An enumerated type string that indicates whether the listing is `physical` or a digital `download`.

Delete Listing

3 inputs

Deletes a ShopListing from an Etsy shop if it meets specific state and seller flag conditions.

Inputs

shopId

The ID of the shop.

state

An enumerated type string that indicates whether the listing is `active`, `inactive`, `sold_out`, `draft` or `expired`.

listingId

The ID of the listing.

Get Listing

3 inputs

Retrieves detailed information about an Etsy listing using its unique listing ID

Inputs

shopId

The ID of the shop.

state

An enumerated type string that indicates whether the listing is `active`, `inactive`, `sold_out`, `draft` or `expired`.

listingId

The ID of the listing.

Get Listing Inventory

2 inputs

Retrieves detailed inventory information for a specific Etsy listing by its listing ID.

Inputs

state

An enumerated type string that indicates whether the listing is `active`, `inactive`, `sold_out`, `draft` or `expired`.

listingId

The ID of the listing.

Update Listing Inventory

2 inputs

Updates the inventory details for a specific Etsy listing using its listing ID.

Inputs

state

An enumerated type string that indicates whether the listing is `active`, `inactive`, `sold_out`, `draft` or `expired`.

listingId

The ID of the listing.

Update Listing Property

5 inputs

Updates or adds product properties and their values for a specific Etsy listing to define its available offerings.

Inputs

shopId

The ID of the shop.

state

An enumerated type string that indicates whether the listing is `active`, `inactive`, `sold_out`, `draft` or `expired`.

listingId

The ID of the listing.

propertyId

The ID of the property.

valueId

The value of the property. If you don

About Etsy

AI Agent Use Cases

- Listing management: create, update, and delete product listings via API

- Order management: retrieve and update post-purchase order status

- Shop management: access shop metadata, sections, and receipts

- OAuth 2.0 authentication with granular permission scopes

- Rate limit of 10 calls per second per application

- OpenAPI specification available for AI coding assistant integration

Available Actions

These are the specific actions that AI agents can perform with this tool

Create Draft Listing Product

10 inputs

Creates a physical product draft listing in an Etsy shop to prepare items for sale.

Inputs

quantity

The positive non-zero number of products available for purchase in the listing. Note: The listing quantity is the sum of available offering quantities.

title

The listing

description

A description string of the product for sale in the listing.

price

The positive non-zero price of the product. (Sold product listings are private) Note: The price is the minimum possible price.

whoMade

An enumerated string indicating who made the product. Helps buyers locate the listing under the Handmade heading. Requires **Is Supply** and **Who Made** properties.

whenMade

An enumerated string for the era in which the maker made the product in this listing. Helps buyers locate the listing under the Vintage heading. Requires **Is Supply** and **Who Made** properties.

taxonomyType

The type of taxonomy.

taxonomyId

The numerical taxonomy ID of the listing.

isSupply

When true, tags the listing as a supply product, else indicates that it

listingType

An enumerated type string that indicates whether the listing is `physical` or a digital `download`.

Delete Listing

3 inputs

Deletes a ShopListing from an Etsy shop if it meets specific state and seller flag conditions.

Inputs

shopId

The ID of the shop.

state

An enumerated type string that indicates whether the listing is `active`, `inactive`, `sold_out`, `draft` or `expired`.

listingId

The ID of the listing.

Get Listing

3 inputs

Retrieves detailed information about an Etsy listing using its unique listing ID

Inputs

shopId

The ID of the shop.

state

An enumerated type string that indicates whether the listing is `active`, `inactive`, `sold_out`, `draft` or `expired`.

listingId

The ID of the listing.

Get Listing Inventory

2 inputs

Retrieves detailed inventory information for a specific Etsy listing by its listing ID.

Inputs

state

An enumerated type string that indicates whether the listing is `active`, `inactive`, `sold_out`, `draft` or `expired`.

listingId

The ID of the listing.

Update Listing Inventory

2 inputs

Updates the inventory details for a specific Etsy listing using its listing ID.

Inputs

state

An enumerated type string that indicates whether the listing is `active`, `inactive`, `sold_out`, `draft` or `expired`.

listingId

The ID of the listing.

Update Listing Property

5 inputs

Updates or adds product properties and their values for a specific Etsy listing to define its available offerings.

Inputs

shopId

The ID of the shop.

state

An enumerated type string that indicates whether the listing is `active`, `inactive`, `sold_out`, `draft` or `expired`.

listingId

The ID of the listing.

propertyId

The ID of the property.

valueId

The value of the property. If you don