Get authenticated Etsy user info including user_id and shop_id. Use this first to find your ETSY_SHOP_ID.

Get full details of your Etsy shop (name, announcement, policies, stats).

Update shop info: title, announcement, sale message, or digital sale message.

List all listings in your shop. Filter by state: active, draft, inactive, expired, sold_out.

Get full details of a single listing by ID.

Create a new draft listing. For digital products (PDF, etc.) set type='download'. Returns the new listing_id.

Update an existing listing. Only provide fields you want to change.

Publish a draft listing (make it active/visible). Requires at least one image already uploaded.

Permanently delete a listing. This cannot be undone.

List all images attached to a listing.

Upload an image to a listing from a local file path. Supported formats: JPEG, PNG, GIF (max 10MB).

Remove an image from a listing.

List all digital files attached to a listing.

Upload a digital file (PDF, ZIP, etc.) to a listing. The listing type must be 'download'.

Remove a digital file from a listing.

Get inventory (products, offerings, prices, quantities) for a listing.

Update the full inventory for a listing. You must provide ALL products (replaces entire inventory). Get current state with get_inventory first, then modify only what you need.

List all sections in your shop (used to organize listings into categories).

Create a new section in your shop.

Rename an existing shop section.

Delete a shop section. Listings in this section will become unsectioned.

Get the full Etsy seller taxonomy tree. Use this to find the right taxonomy_id for create_listing. Search the results for your product category (e.g. 'art print', 'digital download', 'guide').

Get available properties (attributes) for a specific taxonomy node. Use this to know what attributes you can set when creating a listing.

Search taxonomy nodes by keyword to help build relevant SEO tags for a listing. Returns matching category names you can use as tags.

List shop orders (receipts). Filter by status: open, unshipped, unpaid, completed, processing.

Get full details of a single order (receipt) including buyer info, items, and totals.