API Etsy

Etsy Shop listings API

List one Etsy shop's active listings by shop name, a page at a time, and get title, price, original price and image for each listing in one normalized response.

POST/v1/run/etsy.shop_listings
Запросы
-
30d

Цены и поставщики

Цена API Etsy Shop listings: один API, поставщиков 2, и любой может заменить другого

Первым обслуживает самый дешёвый поставщик. Если он не отвечает, его заменяет следующий в том же вызове.

Поставщик
1BadgerОбслуживает первым0,85 USD/1 тыс. запросовflat2ChameleonРезерв 11,07 USD/1 тыс. запросовflat
Вы платите
8,50 USD
0,85 USD/1 тыс. запросов, только за то, чем пользуетесь. Без ежемесячного тарифа.
Ваши первые запросы (117) бесплатны за счёт стартового баланса 0,10 USD.

Попробовать

Получите Etsy Shop listings одним запросом

Открыть в
Пример ответа
Бесплатные запуски возвращают только первые результаты: 3. Пополните ключ, чтобы получить полный ответ.
{
  "data": {
    "items": [
      {
        "currency": "USD",
        "image": "https://example.com/image.jpg",
        "listingId": "a1b2c3d4",
        "originalPrice": 19.99,
        "price": 19.99,
        "title": "Example title",
        "url": "https://example.com/page"
      }
    ],
    "totalResults": 12500
  },
  "found": true,
  "reason": "not_found"
}

Полный справочник по параметрам и ответу: каждое поле, тип и пример для этого эндпоинта.

Справочник

Один запрос, один формат ответа.

Каждое поле, которое вы отправляете, и каждое поле, которое получаете, с реальным примером.

Проверено 2026-10-23 · доступность и задержка измерены за 30d

Тело запроса

JSON, отправляется на этот эндпоинт.

  • shopNamestring

    StudioStelleHD

    Etsy shop name, as in the shop URL (https://www.etsy.com/shop/<name>), e.g. StudioStelleHD. The Etsy Search and Etsy Product SKUs return it as shopName.

  • pageinteger

    1-based results page of the shop's listings. Each page is billed as one request.

Вы отправляете. Небольшое тело JSON. Показанные значения это примеры, замените их своими.

Ответ

JSON, по одному примеру значения на поле.

each itemdata.items[]

The shop's active listings for the requested page, in the shop's own order. Populated whenever the provider has data for the entity.

  • currencystring

    Price currency code, e.g. "USD", or null when no price is shown. Populated whenever the provider has data for the entity.

  • imagestring

    Primary listing image URL, or null when the listing has none. Populated whenever the provider has data for the entity.

  • listingIdstring

    Etsy listing id, the number in the listing URL (https://www.etsy.com/listing/<id>/...); pass it to the Etsy Product SKU. Populated whenever the provider has data for the entity.

  • originalPricenumber

    Price before the current sale, or null when the listing is not on sale.

  • pricenumber

    Current price in the listing currency, or null when not shown. Populated whenever the provider has data for the entity.

  • titlestring

    Listing title. Populated whenever the provider has data for the entity.

  • urlstring

    Etsy listing page URL with tracking query parameters removed. Populated whenever the provider has data for the entity.

datadata

Listings wrapper, or null when the shop has none.

  • totalResultsinteger

    Total listings the shop has for sale, or null when not reported.

top level
  • foundboolean

    True when the shop has at least one active listing on the requested page.

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

Вы получаете. Именованные типизированные поля в одном формате, какой бы источник ни ответил.

Вопросы и ответы

Об API Etsy Shop listings

AnyAPI Etsy Shop listings API возвращает данные Etsy в виде нормализованного JSON одним вызовом POST к /v1/run/etsy.shop_listings. List one Etsy shop's active listings by shop name, a page at a time, and get title, price, original price and image for each listing in one normalized response. AnyAPI направляет каждый запрос по источникам (их 2) и автоматически переключается, если один из них отказывает. Это стоит от 0,85 USD за 1000 запросов, в долларах США, без подписки и без ежемесячного минимума.

Это стоит от 0,85 USD за 1000 запросов, в долларах США, без подписки и без ежемесячного минимума. Вы пополняете один кошелёк в долларах США, и каждый вызов списывает с него. По некоторым неудавшимся запросам, оплаченным из кошелька, возникают расходы на обработку; мы передаём их по себестоимости, без наценки, а сумма списания указана в ответе с ошибкой.

List one Etsy shop's active listings by shop name, a page at a time, and get title, price, original price and image for each listing in one normalized response. Ответ это нормализованный JSON с тем же конвертом, что возвращает каждый эндпоинт AnyAPI, поэтому разбор второго эндпоинта это смена URL и ничего больше.

Да. Новый аккаунт AnyAPI стартует с бесплатным балансом 0,10 USD, карта не нужна. Этого хватает на 117 вызовов Etsy Shop listings по 0,00085 USD за каждый.

AnyAPI в том же запросе обращается к следующему из источников (их 2), начиная с самого дешёвого, поэтому отказ одного источника не ломает ваш вызов.

Отправьте запрос POST на https://api.getanyapi.com/v1/run/etsy.shop_listings с вашим ключом AnyAPI в заголовке "Authorization: Bearer" и входными данными в теле JSON. Один и тот же ключ и один и тот же кошелёк работают на каждом эндпоинте AnyAPI.

Нет. Вы пополняете один предоплаченный баланс AnyAPI в долларах США, и каждый запрос списывает с него. Ежемесячного тарифа и минимума нет, а один и тот же баланс оплачивает каждый эндпоинт AnyAPI.

Да. Установите @getanyapi/sdk из npm для TypeScript или getanyapi из pip для Python. Оба вызывают любой эндпоинт AnyAPI с одним и тем же ключом, а ещё подойдёт любой HTTP-клиент.

Да. Агент может подключиться к MCP-серверу AnyAPI по адресу https://api.getanyapi.com/mcp или создать собственный бесплатный пробный ключ одним POST без аутентификации на https://api.getanyapi.com/agent/signup и вызывать этот эндпоинт по HTTP.