API de Etsy
Busca productos de Etsy y consulta fichas, tiendas, reseñas y detalles por sus identificadores públicos. Un listing y una tienda son objetos diferentes aunque compartan nombre o URL relacionada.
Materiales, distintivo Star Seller, stock y valoraciones proceden de la información visible y no certifican autenticidad. La disponibilidad puede variar por variante y momento.
Disponibilidad de la plataforma
- Salud 24 h
- Normal
Últimos 30 días
Funciones disponibles
Cada acción de Etsy, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Buscar productos en Etsysearch | Busca listings de Etsy mediante keyword, con moneda, términos excluidos del título, precio mínimo y orden opcionales. | $1.39 por 1.000 solicitudes | Normal |
Consultar una ficha de Etsyprofile | Abre la url de un listing y recoge descripción, materiales, categoría, precios y disponibilidad visibles. | $1.39 por 1.000 solicitudes | Normal |
Leer reseñas de una tiendareviews | Consulta reseñas de la shop, con autor, valoración, listing relacionado y respuesta del vendedor cuando existe. | $1.39 por 1.000 solicitudes | Normal |
Consultar una tienda de Etsyshop | Busca una tienda mediante shop, con alias compatibles de nombre, URL o usuario, y devuelve antigüedad, ubicación y señales públicas. | $1.39 por 1.000 solicitudes | Normal |
Obtener el detalle de un productoproduct_detail | Lee por url el detalle de un producto, incluidos texto, precio, cantidad visible y valoración. | $1.39 por 1.000 solicitudes | Normal |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿Qué acepta cada acción de Etsy?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
searchBuscar productos en Etsy Busca listings de Etsy mediante | keyword | currency, exclude_keywords, min_price, sort | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 50 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | 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 |
profileConsultar una ficha de Etsy Abre la | url | — | Entrega síncrona | — | $1.39 por 1.000 solicitudes | 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 |
reviewsLeer reseñas de una tienda Consulta reseñas de la | shop | — | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 100 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | 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 |
shopConsultar una tienda de Etsy Busca una tienda mediante | shop | shop_name, username | Entrega síncrona | — | $1.39 por 1.000 solicitudes | shop_id · shop_name · shop_url · is_star_seller · active_listing_count · on_etsy_since · location · platform |
product_detailObtener el detalle de un producto Lee por | url | — | Entrega síncrona | — | $1.39 por 1.000 solicitudes | id · url · name · text · price · original_price · currency · in_stock_quantity · rating · rating_scale · review_count · shop_id · variants · tags · image_url · platform |
¿Qué significan los parámetros de Etsy search?
Busca listings de Etsy mediante keyword, con moneda, términos excluidos del título, precio mínimo y orden opcionales. Devuelve tienda, valoración, precio y precio de lista; no garantiza fabricación artesanal, stock ni entrega.
keywordObligatorio- Término de búsqueda para productos de Etsy, como
ceramic mug. Se usa para buscar en títulos y anuncios de productos, no es una búsqueda exacta del nombre de la tienda. Para obtener los datos o las reseñas de una tienda, usashop. currencyOpcional- Moneda del precio del producto en los resultados de búsqueda. El valor por defecto es
USD. Admite los códigos de moneda listados en esta API.min_pricese interpreta según esta moneda y no cambia la moneda de facturación de la llamada a esta API.Valores permitidos:audbrlcadchfdkkeurgbphkdinrjpymxnnoknzdseksgdusd exclude_keywordsOpcional- Palabras clave a excluir del título del producto. Envía un array de cadenas, como
["digital", "download"]. Se excluyen los productos cuyo título contenga alguna de las palabras, sin distinguir mayúsculas y minúsculas. No garantiza que se excluyan vendedores ni que se analice la descripción completa del producto. min_priceOpcional- Precio mínimo para la búsqueda de productos. Es un valor numérico no negativo en la moneda seleccionada en
currency. No es la cantidad mínima de pedido, el límite del coste de envío ni el presupuesto de la llamada a esta API. sortOpcional- Orden de los resultados de búsqueda de productos:
relevance(relevancia, por defecto),price_asc(precio ascendente),price_desc(precio descendente) onewest(más recientes). Compatible con los valores antiguosmost_relevant,lowest_price,highest_priceyrecently_listed. No ordena las reseñas de la tienda por fecha.Valores permitidos:newestprice_ascprice_descrelevance
¿Qué significan los parámetros de Etsy profile?
Abre la url de un listing y recoge descripción, materiales, categoría, precios y disponibilidad visibles. Aquí profile describe un producto, no la cuenta del comprador ni la ficha completa de la tienda.
urlObligatorio- Para
profileoproduct_detail, usa el enlace completo de un artículo de Etsy con el formato/listing/<ID>/. En este caso,profilese refiere a los datos del producto, no a una cuenta de usuario. Para obtener datos de la tienda, debes proporcionar el parámetroshop; no puedes enviar solo laurlen lugar de los parámetros obligatorios.
¿Qué significan los parámetros de Etsy reviews?
Consulta reseñas de la shop, con autor, valoración, listing relacionado y respuesta del vendedor cuando existe. El lote no equivale a todas las ventas ni permite responder o moderar opiniones.
shopObligatorio- Nombre corto de la tienda de Etsy o el enlace completo
https://www.etsy.com/shop/<nombre_tienda>.reviewsdevuelve las reseñas de la tienda, no las de un producto (listing) concreto, mientras que la acciónshopdevuelve los datos de la tienda.Etsy: formato de la URL de una tienda — Etsy muestra que una tienda usa un nombre corto en una ruta como `/shop/nombre`. La referencia permite distinguir una tienda de un listing concreto; no garantiza acceso a datos no públicos del panel del vendedor. · Consultada
¿Qué significan los parámetros de Etsy shop?
Busca una tienda mediante shop, con alias compatibles de nombre, URL o usuario, y devuelve antigüedad, ubicación y señales públicas. is_star_seller es un distintivo observado, no una garantía de calidad futura.
shopObligatorio- Nombre corto de la tienda de Etsy o el enlace completo
https://www.etsy.com/shop/<nombre_tienda>.reviewsdevuelve las reseñas de la tienda, no las de un producto (listing) concreto, mientras que la acciónshopdevuelve los datos de la tienda.Etsy: formato de la URL de una tienda — Etsy muestra que una tienda usa un nombre corto en una ruta como `/shop/nombre`. La referencia permite distinguir una tienda de un listing concreto; no garantiza acceso a datos no públicos del panel del vendedor. · Consultada shop_nameOpcional- Parámetro compatible con
shop. Representa el nombre corto de la tienda de Etsy. Las peticiones areviewsoshopdeben incluir igualmente el parámetro obligatorioshop. usernameOpcional- Parámetro compatible con el nombre corto de la tienda en
shop. Tiene menor prioridad queshopyshop_name. No es un nombre de usuario de comprador; debes proporcionar igualmente el parámetro obligatorioshop.
¿Qué significan los parámetros de Etsy product_detail?
Lee por url el detalle de un producto, incluidos texto, precio, cantidad visible y valoración. No reserva unidades, no selecciona variantes omitidas y no convierte in_stock_quantity en inventario auditado.
urlObligatorio- Para
profileoproduct_detail, usa el enlace completo de un artículo de Etsy con el formato/listing/<ID>/. En este caso,profilese refiere a los datos del producto, no a una cuenta de usuario. Para obtener datos de la tienda, debes proporcionar el parámetroshop; no puedes enviar solo laurlen lugar de los parámetros obligatorios.
Cómo usar la API de Etsy
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
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>"}}'
Preguntas sobre la API de Etsy
¿Cómo llamo a la API de Etsy?
Envía POST /api/v1/social con platform igual a etsy, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Etsy?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye listing_id, title, price y list_price. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de Etsy?
Etsy muestra que una tienda usa un nombre corto en una ruta como /shop/nombre. La referencia permite distinguir una tienda de un listing concreto; no garantiza acceso a datos no públicos del panel del vendedor.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword; profile requiere url; reviews requiere shop; consulta las demás acciones en la lista de funciones.
¿Las acciones de Etsy responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.