24 actions ready for your AI

Connect Etsy to your AI

Add your Etsy key once and every AI you use can get shipping carriers, find shops and get buyer taxonomies through it.

Needs your API keyWorks today: paste the key from this app and your AI can use it. One-click sign-in is not built yet.

Not verified by us yet. Its actions come from Etsy's own documented API, and we have not run them here yet.

Use your own Etsy account. Credentials stay encrypted in ahel.

Tell me when ahel has verified Etsy

What your AI can do with Etsy

Choose a task and ask your AI.

Listing

  • Find all listings activeGET

    General Release Report bug This endpoint is ready for production use. A list of all active listings on Etsy paginated by their creation date. Without sortorder listings will be returned newest-first by default.

    limit
    The maximum number of results to return.
    offset
    The number of records to skip before selecting the first result.
    keywords
    Search term or phrase that must appear in all results.
    sort_on
    The value to sort a search result of listings on.
  • Get listings by listing idsGET

    General Release Report bug This endpoint is ready for production use. Allows to query multiple listing ids at once. Limit 100 ids maximum per query.

    listing_idsrequired
    The list of numeric IDS for the listings in a specific Etsy shop.
    includes
    An enumerated string that attaches a valid association.
    legacy
    This parameter is needed to enable new parameters and response values related to processing profiles.
    currency
    The ISO 4217 alphabetic currency code (e.g., EUR, MXN) for price conversion.
  • Get listingGET

    General Release Report bug This endpoint is ready for production use. Retrieves a listing record by listing ID.

    listing_idrequired
    The numeric ID for the listing associated to this transaction.
    includes
    An enumerated string that attaches a valid association.
    language
    The IETF language tag for the language of this translation.
    allow_suggested_title
    This parameter will include in the response a suggested title for the listing, if one is available.
  • Get listings inventory by listing idsGET

    General Release Report bug This endpoint is ready for production use. Retrieves the inventory record for each listing referenced by listing ID. Requires the listingsr OAuth scope. Limit 100 listing IDs per request.

    listing_idsrequired
    The list of numeric IDS for the listings in a specific Etsy shop.
  • Get listings shipping by listing idsGET

    General Release Report bug This endpoint is ready for production use. Retrieves the shipping profile for each listing referenced by listing ID. Requires the shopsr OAuth scope. Limit 100 listing IDs per request.

    listing_idsrequired
    The list of numeric IDS for the listings in a specific Etsy shop.
  • Get listings by shopGET

    General Release Report bug This endpoint is ready for production use. Endpoint to list Listings that belong to a Shop. Listings can be filtered using the 'state' param.

    shop_idrequired
    The unique positive non-zero numeric ID for an Etsy Shop.
    state
    When updating a listing, this value can be either active or inactive.
    limit
    The maximum number of results to return.
    offset
    The number of records to skip before selecting the first result.
  • Get listing imagesGET

    General Release Report bug This endpoint is ready for production use. Retrieves all listing image resources for a listing with a specific listing ID.

    listing_idrequired
    The numeric ID for the listing associated to this transaction.
  • Get listing inventoryGET

    General Release Report bug This endpoint is ready for production use. Retrieves the inventory record for a listing. Listings you did not edit using the Etsy.com inventory tools have no inventory records.

    listing_idrequired
    The numeric ID for the listing associated to this transaction.
    show_deleted
    A boolean value for inventory whether to include deleted products and their offerings.
    includes
    An enumerated string that attaches a valid association.
  • Get listing personalizationGET

    General Release Report bug This endpoint is ready for production use. Retrieves a listing's personalization questions by listing ID.

    listing_idrequired
    The numeric ID for the listing associated to this transaction.
  • Get listing videosGET

    General Release Report bug This endpoint is ready for production use. Retrieves all listing video resources for a listing with a specific listing ID.

    listing_idrequired
    The numeric ID for the listing associated to this transaction.

Shop

  • Find shopsGET

    General Release Report bug This endpoint is ready for production use. Open API V3 endpoint for searching shops by name. Note: We make every effort to ensure that frozen or removed shops are not included in the search results.

    shop_namerequired
    The shop's name string.
    limit
    The maximum number of results to return.
    offset
    The number of records to skip before selecting the first result.
  • Get shopGET

    General Release Report bug This endpoint is ready for production use. Retrieves the shop identified by a specific shop ID.

    shop_idrequired
    The unique positive non-zero numeric ID for an Etsy Shop.
  • Get shop receiptsGET

    General Release Report bug This endpoint is ready for production use. Requests the Shop Receipts from a specific Shop, unfiltered or filtered by receipt id range or offset, date, paid, and/or shipped purchases.

    shop_idrequired
    The unique positive non-zero numeric ID for an Etsy Shop.
    min_created
    The earliest unix timestamp for when a record was created.
    max_created
    The latest unix timestamp for when a record was created.
    min_last_modified
    The earliest unix timestamp for when a record last changed.

User

  • Get user addressesGET

    General Release Report bug This endpoint is ready for production use. Open API V3 endpoint to retrieve UserAddresses for a User.

    limit
    The maximum number of results to return.
    offset
    The number of records to skip before selecting the first result.
  • Get userGET

    General Release Report bug This endpoint is ready for production use. Retrieves a user profile based on a unique user ID. Access is limited to profiles of the authenticated user or linked buyers.

    user_idrequired

Application

  • Get meGET

    General Release Report bug This endpoint is ready for production use. Returns basic info for the user making the request.

Show 8 more groups

Buyer

  • Get buyer taxonomy nodesGET

    General Release Report bug This endpoint is ready for production use. Retrieves the full hierarchy tree of buyer taxonomy nodes.

Draft

  • Create draft listingPOST

    General Release Report bug This endpoint is ready for production use. Creates a physical draft listing product in a shop on the Etsy channel.

    shop_idrequired
    The unique positive non-zero numeric ID for an Etsy Shop.
    quantityrequired
    The positive non-zero number of products available for purchase in the listing.
    titlerequired
    The listing's title string.
    descriptionrequired
    A description string of the product for sale in the listing.
    pricerequired
    The positive non-zero price of the product.
    who_maderequired
    An enumerated string indicating who made the product.

Payment

  • Get paymentsGET

    General Release Report bug This endpoint is ready for production use. Retrieves a list of payments from a shop identified by shopid. You can also filter results using a list of payment IDs.

    shop_idrequired
    The unique positive non-zero numeric ID for an Etsy Shop.
    payment_idsrequired
    A comma-separated array of Payment IDs numbers.

Ping

  • PingGET

    General Release Report bug This endpoint is ready for production use. Check to confirm connectivity to the Etsy API with an application

Review

  • Get reviews by listingGET

    General Release Report bug This endpoint is ready for production use. Open API V3 to retrieve the reviews for a listing given its ID.

    listing_idrequired
    The numeric ID for the listing associated to this transaction.
    limit
    The maximum number of results to return.
    offset
    The number of records to skip before selecting the first result.
    min_created
    The earliest unix timestamp for when a record was created.

Seller

  • Get seller taxonomy nodesGET

    General Release Report bug This endpoint is ready for production use. Retrieves the full hierarchy tree of seller taxonomy nodes.

Shipping

  • Get shipping carriersGET

    General Release Report bug This endpoint is ready for production use. Retrieves a list of available shipping carriers and the mail classes associated with them for a given country

    origin_country_isorequired
    The ISO code of the country from which the listing ships.

Token

  • Token scopesPOST

    General Release Report bug This endpoint is ready for production use. Check the scopes of the provided token

Ask your AI

Try one of these requests with a connected AI.

  • Show me the shipping carrier in Etsy
  • Find shops in Etsy
  • Show me the buyer taxonomy node in Etsy
  • Find listing actives in Etsy
  • Show me the listing listing in Etsy
  • Show me the seller taxonomy node in Etsy

Etsy MCP server, hosted by ahel

One hosted endpoint serves Etsy. There is nothing to install and no local server to run.

Connect Etsy to Claude, Claude Code, Cursor or Codex

  1. Add your Etsy key. ahel stores it encrypted.
  2. Paste one link into your AI: https://mcp.ahel.ai (once, for every app).
  3. Ask for the work. Your AI picks the action and ahel runs it with your key.

Documentation

About Etsy

Etsy is an ecommerce service. Connect your own key and your AI can get shipping carriers, find shops and get buyer taxonomies.

Etsy over MCP: ahel serves Etsy to Claude, Claude Code, Cursor and Codex as one hosted MCP endpoint. There is no local server to run. Add your Etsy key once, paste one link into your AI, and the actions above are there.

Ecommerce

Questions

Is my Etsy key safe?

Your Etsy key is sealed in ahel and added to the request server-side when your AI calls Etsy. It never crosses the MCP link, no tool can read it back, and you can turn the app off or remove the key at any time.

Which AIs can use Etsy through ahel?

Any MCP-capable AI: Claude, Claude Code, Codex, Cursor, VS Code and others. Paste one link, https://mcp.ahel.ai, into the AI once and everything in your gateway arrives through it.

What can my AI do with Etsy?

24 actions today, covering listings, shops and users. Ask in plain language; your AI picks the action and ahel runs it with your key.

Does connecting Etsy cost anything?

Connecting apps is free during ahel's early access. Free, Pro and Team all cost nothing today, and the pricing page lists what each one includes. Etsy may bill you for API use under its own terms.