Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Etsy: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Ищите карточки товаров Etsy по keyword. | $1.39 за 1 000 запросов | Норма |
Данные товараprofile | Получите полную запись о товаре Etsy по url его карточки: описание, материалы, диапазон цен, варианты, основные моменты из отзывов и сведения о магазине, который его продаёт. | $1.39 за 1 000 запросов | Норма |
Отзывыreviews | Читайте отзывы о магазине Etsy в целом. | $1.39 за 1 000 запросов | Норма |
Магазинshop | Найдите магазин Etsy по названию или URL в shop и получите его ID, местоположение, дату открытия, число активных карточек товаров и значок Star Seller. | $1.39 за 1 000 запросов | Норма |
Сведения о товареproduct_detail | Получите товар Etsy по url карточки. | $1.39 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Etsy?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Ищите карточки товаров Etsy по | keyword | currency, exclude_keywords, min_price, sort | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | listing_id · title · url · price · list_price · currency · rating · rating_scale · shop_id · shop_name · shop_rating · shop_review_count · on_sale · free_shipping · is_digital · image_url · platform |
profileДанные товара Получите полную запись о товаре Etsy по | url | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | listing_id · title · url · description · materials · category · price · price_min · price_max · currency · review_count · shop_id · shop_name · shop_review_count · shop_years · ships_from_country · image_url · platform · images · review_highlights · review_tags · variants |
reviewsОтзывы Читайте отзывы о магазине Etsy в целом. Передайте его короткое имя или URL магазина в | shop | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | review_id · text · rating · rating_scale · author_name · author_username · posted_at · listing_title · seller_response · product_url · shop_name · shop_url · shop_rating · shop_review_count · platform |
shopМагазин Найдите магазин Etsy по названию или URL в | shop | shop_name, username | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | shop_id · shop_name · shop_url · is_star_seller · active_listing_count · on_etsy_since · location · platform |
product_detailСведения о товаре Получите товар Etsy по | url | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | id · url · name · text · price · original_price · currency · in_stock_quantity · rating · rating_scale · review_count · shop_id · variants · tags · image_url · platform |
Что означают параметры действия search в API Etsy?
Ищите карточки товаров Etsy по keyword. Получайте цену, базовую цену, валюту, рейтинг и магазин каждого товара. Необязательные фильтры позволяют задать валюту, исключаемые слова в названии, минимальную цену и сортировку. Данные карточки не гарантируют ручное изготовление, наличие или доставку.
keywordОбязательный- Поисковый запрос для поиска товаров на Etsy (например, ceramic mug) по названиям и карточкам товаров. Это не поиск магазина по точному совпадению; для получения профилей магазинов или отзывов используйте shop.
currencyНеобязательный- Задаёт валюту цен карточек товаров в результатах поиска: один из поддерживаемых кодов валют в нижнем регистре, по умолчанию usd. Параметр min_price интерпретируется в этой валюте. Настройка влияет только на отображаемые значения в ответе и не меняет валюту оплаты API платформы.Допустимые значения:
audbrlcadchfdkkeurgbphkdinrjpymxnnoknzdseksgdusd exclude_keywordsНеобязательный- Исключает товары, в названиях которых есть любая из строк этого массива (например, ["digital", "download"]). Сравнение выполняется без учёта регистра. Фильтр проверяет только названия товаров, не исключает конкретных продавцов и не гарантирует проверку полных описаний.
min_priceНеобязательный- Фильтрует результаты поиска товаров Etsy по минимальной цене: неотрицательное число в указанной валюте. Это не минимальное количество для заказа, не максимальная стоимость доставки и не лимит бюджета на запросы.
sortНеобязательный- Задаёт порядок результатов поиска товаров для действия search в Etsy. Поддерживаемые значения: relevance (по умолчанию), price_asc, price_desc и newest. Также поддерживаются устаревшие псевдонимы для совместимости: most_relevant, lowest_price, highest_price и recently_listed. Параметр не сортирует отзывы о магазине.Допустимые значения:
newestprice_ascprice_descrelevance
Что означают параметры действия profile в API Etsy?
Получите полную запись о товаре Etsy по url его карточки: описание, материалы, диапазон цен, варианты, основные моменты из отзывов и сведения о магазине, который его продаёт. Несмотря на название действия, profile относится к товару, а не к аккаунту покупателя или полной странице магазина.
urlОбязательный- Принимает полный URL карточки товара Etsy в формате /listing/<ID>/ для действий profile и product_detail, чтобы получить данные одного товара. Обратите внимание: profile возвращает данные товара, а не профиль пользователя. Не заменяет обязательный параметр shop при запросах к эндпоинтам магазина.
Что означают параметры действия reviews в API Etsy?
Читайте отзывы о магазине Etsy в целом. Передайте его короткое имя или URL магазина в shop. Получайте оценку, автора, название связанной карточки товара и ответ продавца, если он есть. Отзывы относятся ко всему магазину, а не к одной карточке. Выборка не охватывает все продажи.
shopОбязательный- Определяет магазин по короткому имени или полному URL вида https://www.etsy.com/shop/<shop_name>. Для действия reviews возвращает отзывы о магазине в целом, а не об отдельных товарах; для действия shop возвращает общие метаданные магазина.Etsy: формат ссылок на магазины — В официальной документации Etsy указано, что ссылки на магазины содержат короткое имя магазина, например www.etsy.com/shop/shopname. Указывайте короткое имя магазина или ссылку с /shop/ так, как требует этот параметр, и не подставляйте ссылки на карточки товаров вместо ссылок на магазины. · Проверено
Что означают параметры действия shop в API Etsy?
Найдите магазин Etsy по названию или URL в shop и получите его ID, местоположение, дату открытия, число активных карточек товаров и значок Star Seller. is_star_seller отражает наличие значка на момент запроса, а не обещание будущего качества обслуживания.
shopОбязательный- Определяет магазин по короткому имени или полному URL вида https://www.etsy.com/shop/<shop_name>. Для действия reviews возвращает отзывы о магазине в целом, а не об отдельных товарах; для действия shop возвращает общие метаданные магазина.Etsy: формат ссылок на магазины — В официальной документации Etsy указано, что ссылки на магазины содержат короткое имя магазина, например www.etsy.com/shop/shopname. Указывайте короткое имя магазина или ссылку с /shop/ так, как требует этот параметр, и не подставляйте ссылки на карточки товаров вместо ссылок на магазины. · Проверено
shop_nameНеобязательный- Параметр совместимости с коротким именем магазина Etsy. Основной обязательный параметр shop всё равно нужно передавать в вызовах действий reviews и shop.
usernameНеобязательный- Резервный параметр совместимости для короткого имени магазина с более низким приоритетом, чем shop и shop_name. Не обозначает имя пользователя покупателя; обязательный параметр shop всё равно нужно передать.
Что означают параметры действия product_detail в API Etsy?
Получите товар Etsy по url карточки. В ответе есть описание, текущая и исходная цена, видимый остаток, рейтинг, варианты и теги. in_stock_quantity — число, показанное на странице, а не проверенные складские данные. Ничего не резервируется.
urlОбязательный- Принимает полный URL карточки товара Etsy в формате /listing/<ID>/ для действий profile и product_detail, чтобы получить данные одного товара. Обратите внимание: profile возвращает данные товара, а не профиль пользователя. Не заменяет обязательный параметр shop при запросах к эндпоинтам магазина.
Как использовать API Etsy
- 01Выберите действие платформы в публичном каталоге.
- 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
- 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
- 04Сохраните поля ответа, которые нужны вашему приложению.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"etsy","action":"search","params":{"keyword":"<keyword>"}}'
Вопросы об API Etsy
Какие данные можно получить через API Etsy?
Укажите в platform значение etsy. В текущем каталоге: поиск, данные товара, отзывы, магазин и сведения о товаре. Эти названия действий соответствуют разным объектам или представлениям Etsy; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе Etsy?
Поисковый запрос для поиска товаров на Etsy (например, ceramic mug) по названиям и карточкам товаров. Это не поиск магазина по точному совпадению; для получения профилей магазинов или отзывов используйте shop. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе Etsy?
Объявленная схема включает listing_id, title, price и list_price. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Etsy возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.