API de plataforma de EveryData
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.
- Endpoint
- POST /api/v1/social
- Funciones
- 5
- Por 1.000
- 1,389 US$
Funciones disponibles
Compara las acciones de Etsy por sus entradas obligatorias, datos devueltos y precio. Usa el identificador de la acción exactamente como aparece.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
searchBuscar productos en Etsy Busca listings de Etsy mediante | keyword | category, 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 · tag · count |
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 Resuelve una tienda mediante | shop | shop_name, url, 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é 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.
¿Qué significan los parámetros de Etsy search?
Busca listings de Etsy mediante keyword, con categoría, moneda, exclusiones, precio y orden opcionales. Devuelve tienda, valoración y precio publicado; no garantiza fabricación artesanal, stock o 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. categoryOpcional- Categoría del producto:
any(cualquiera),jewelry-and-accessories,clothing-and-shoes,home-and-living,wedding-and-party,toys-and-entertainment,art-and-collectibles,craft-supplies-and-tools,vintage,gifts,electronics-and-accessories,bags-and-pursesobath-and-beauty. 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.
¿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 tiendaEtsy 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?
Resuelve 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 tiendaEtsy 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. urlOpcional- 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. 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 devuelto si la acción es 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 de origen contengan 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.