Etsy

Manage Etsy shops and listings with a personal access token.

Create a new draft listing in an Etsy shop.

Parameters

Parameter	Type	Required	Description
`shop_id`	string	Yes	The Etsy shop ID.
`title`	string	Yes	The listing title.
`description`	string	Yes	The listing description.
`price`	number	Yes	The listing price.
`quantity`	number	Yes	The quantity available.

Response

{
  "listing_id": "222222222",
  "state": "draft",
  "title": "New Handmade Item"
}

Retrieve details about an Etsy shop by its ID.

Parameters

Parameter	Type	Required	Description
`shop_id`	string	Yes	The Etsy shop ID.

Response

{
  "currency_code": "USD",
  "shop_id": "12345678",
  "shop_name": "MyEtsyShop",
  "title": "Handmade Crafts"
}

List active listings from an Etsy shop.

Parameters

Parameter	Type	Required	Description
`shop_id`	string	Yes	The Etsy shop ID.
`limit`	number	No	Maximum number of listings to return (default 10).

Response

[
  {
    "listing_id": "111111111",
    "price": {
      "amount": 2500,
      "currency_code": "USD"
    },
    "title": "Handmade Scarf"
  }
]

Update the description of an existing Etsy listing.

Parameters

Parameter	Type	Required	Description
`shop_id`	string	Yes	The Etsy shop ID.
`listing_id`	string	Yes	The listing ID to update.
`description`	string	Yes	The new description text.

Response

{
  "description": "Updated description text",
  "listing_id": "111111111"
}