API de detalles de productos de Etsy

Obtén información pública de anuncios de Etsy a partir de una URL validada del mercado para investigar productos, precios, tiendas y competidores. Invoca la API mediante REST o MCP.

CosteAt least 10 credits / call

Probar en línea

POST · https://api.nexscope.ai/etsy/product/detailMCP · nexscope_etsy_product_detail

Qué hace esta API

Recuperar datos de la lista pública de Etsy de un mercado validado URL para productos, precios, tiendas e investigación competitiva.

Casos de uso de API de detalles de productos de Etsy

Inspeccione un producto candidato

Para inspeccionar un producto candidato, un analista de mercado presenta productUrl El código de error, errmsg, productId ayudar a inspeccionar los atributos documentados del producto candidato.

Comparar detalles de la lista

Un analista de mercado utiliza Etsy Detalle de producto con productUrl Para comparar los detalles de la lista. El errcode devuelto, errmsg, productId ayudar a comparar los detalles del producto con otra lista preseleccionada.

Preparar pruebas de producto para una revisión de abastecimiento

Para este flujo de trabajo, un analista de mercado llama a Etsy Product Detail con productUrl El resultado ayuda a registrar los hechos del producto antes de una discusión sobre el abastecimiento.

Preguntas frecuentes sobre API de detalles de productos de Etsy

¿Qué hace el detalle de productos Etsy API ¿Volver?

Recuperar datos de la lista pública de Etsy de un mercado validado URL para productos, precios, tiendas y la investigación competitiva. `errcode`, `errmsg`, `productId`, `shopId`, `shopUrl`, `shopSales`, `shopName`, `productUrl`. Corresponde a los parámetros proporcionados productUrl. Los campos opcionales pueden estar ausentes; un valor que falta no debe interpretarse como un cero medido. Los valores de ejemplo ilustran la forma de respuesta, en lugar de los resultados reales de la cuenta.

¿Cuántos créditos tiene el detalle de productos Etsy API ¿costo?

El coste documentado actualmente es At least 10 credits / call. Es el mismo que figura en la parte superior de esta página. Si se muestra un intervalo o una estimación, el cargo final depende de la solicitud. Antes de llamar a la API, revisa los créditos disponibles y la página de precios. Consulta el registro de uso de la API para comprobar el cargo aplicado.

¿Cómo llamo al detalle de productos Etsy API desde mi aplicación o un MCP ¿Cliente?

Enviar a POST solicitud a /etsy/product/detail con tu API como un símbolo de portador y la JSON datos de entrada API En una MCP cliente como Claude o Cursor, conectar Nexscope y llamar nexscope_etsy_product_detail. Utilice el MCP argumentos mostrados en el MCP guía, o cambiar la prueba en línea a MCP para revisar su solicitud antes de añadirla a tu aplicación.

Ver planes y créditos Conecta esta API con MCP (en inglés)

Prueba esta API

Endpoint

https://api.nexscope.ai/etsy/product/detail

Método MCP

nexscope_etsy_product_detail

Paso 1 de 3 · Autenticarse

Autenticación

Todos los endpoints de ejecución requieren una clave de API de usuario. Envíala como token bearer en la cabecera Authorization .

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

Las claves de API ausentes o no válidas devuelven un error de autenticación. Gestiona las claves desde .

Paso 2 de 3 · Enviar una solicitud

POSThttps://api.nexscope.ai/etsy/product/detail

Ejecutar una API

Envía un cuerpo de solicitud JSON usando los parámetros descritos abajo.

Solicitud de ejemplo

Sustituye YOUR_API_KEY y ejecuta este comando en tu terminal.

curl -X POST 'https://api.nexscope.ai/etsy/product/detail' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "productUrl": "https://www.etsy.com/listing/1710567856/its-okay-to-make-some-mistakes-shirt"
}'

Ejemplo de código

{
  "productUrl": "https://www.etsy.com/listing/1710567856/its-okay-to-make-some-mistakes-shirt"
}

Paso 3 de 3 · Inspeccionar el resultado

Comprueba la respuesta

Consulta code para ver el estado de la solicitud y data para ver el resultado. Abre la referencia de parámetros y respuestas para consultar las definiciones completas de los campos.

Códigos de estado HTTP

Código	Descripción
200	Respuesta HTTP predeterminada tanto para el éxito como para muchos errores de negocio. Solo el código JSON externo 0 indica éxito o aceptación asíncrona; consulta data para obtener el resultado.
429	Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente.
503	La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente.
Opcional	X-Nexscope-Http-Status: semantic asigna estados HTTP a los errores de negocio gestionados por el controlador en las rutas de ejecución y tareas. Los fallos previos a la autenticación, como la ausencia de una clave API (code 11209), pueden seguir devolviendo HTTP 200 antes de esta asignación. Comprueba siempre el código JSON externo; las solicitudes malformadas y los fallos de infraestructura también pueden devolver respuestas HTTP distintas de 200.

Ver parámetros y respuesta Probar en línea

Todas las categorías/ Investigación de productos de Etsy

POSThttps://api.nexscope.ai/etsy/product/detail

Ejecutar esta API

Envía una solicitud JSON para ejecutar esta API y recibir los datos de respuesta documentados.

Abrir área de pruebas

Endpoint

Método	`POST`
Ruta	`https://api.nexscope.ai/etsy/product/detail`
Autenticación	`Bearer API key`
Content-Type	`application/json`

Parámetros de la solicitud

Nombre	Tipo	Obligatorio	Descripción
`productUrl`	`string`	obligatorio	Productos Etsy HTTPS enlace directo. No debe incluirse información de usuario; Host debe ser `etsy.com` o su subdominio, el puerto debe ser omitido o `443`; el camino debe ser `/listing/<numeric ID>`, con como máximo una babosa no vacía, y puede tener barandillas y parámetros de consulta

Respuesta de ejemplo

Estructura de respuesta de la plataforma. code 0 indica éxito o aceptación; data contiene el resultado de negocio.

No hay un ejemplo de respuesta publicado para esta API. Consulta los campos de respuesta siguientes.

Campos de respuesta

Referencia de campos de respuesta (34 campos)

Nombre	Tipo	Obligatorio	Descripción
`errcode`	`integer`	opcional	Código de la situación empresarial; `200` indica éxito
`errmsg`	`string`	opcional	Mensaje sobre el estado de las empresas; `ok` sobre el éxito
`data`	`array`	opcional	Conjunto de objetos del producto; fijado a 1 elemento cuando se ha logrado
`total`	`integer`	opcional	Fijo a `1` cuando tenga éxito
`costToken`	`integer`	opcional	Consumir token
`type`	`string`	opcional	Fijo a `tableListWorkbenches`
`columns`	`array`	opcional	Definición de columna de renderizado generada basada en los campos de nivel superior del producto
`productId`	`string`	opcional	Id. de lista de Etsy
`shopId`	`string`	opcional	ID de almacenamiento
`shopUrl`	`string`	opcional	Almacenar URL; puede estar vacío o mal identificado cuando la página es anormal.
`shopSales`	`string`	opcional	Almacenar texto de venta pública
`shopName`	`string`	opcional	Almacenar el nombre; puede estar vacío o identificado erróneamente cuando la página es anormal.
`productUrl`	`string`	opcional	Producto URL
`searchPosition`	`string`	opcional	Ubicación de búsqueda de origen; normalmente vacía para consultas directas
`image`	`string`	opcional	Imagen principal URL
`images`	`array`	opcional	Imagen URL lista
`maxQuantity`	`integer`	opcional	Cantidad máxima disponible reportada en la página
`variants`	`array`	opcional	Variaciones de productos; matriz vacía si no hay variaciones
`title`	`string`	opcional	Título del producto
`description`	`array`	opcional	Lista de los párrafos de descripción
`shopReviews`	`integer`	opcional	Número de revisiones de los almacenes
`reviews`	`integer`	opcional	Número actual de comentarios de la lista
`star`	`string`	opcional	La calificación actual puede ser una cadena vacía
`highlightsTags`	`array`	opcional	Etiqueta de los puntos destacados de la retroalimentación del comprador
`reviewsTags`	`array`	opcional	Etiquetas de comentarios y objetos de frecuencia
`yearsOnEtsy`	`string`	opcional	Cuánto tiempo ha estado su tienda en Etsy
`hasRatingsBadge`	`boolean`	opcional	¿Hay una placa de calificación?
`hasConvosBadge`	`boolean`	opcional	¿Hay alguna placa de comunicación?
`hasShippingBadge`	`boolean`	opcional	¿Hay una placa de entrega?
`reviewsScores`	`object`	opcional	La enumeración dinámica de la revisión; las claves y los valores cambian de página a página
`category`	`string`	opcional	Migajas de pan de categoría
`countryShippingFrom`	`string`	opcional	País/región de transporte
`currency`	`string`	opcional	código de moneda
`moreLikeUrl`	`string`	opcional	Enlace de recomendación similar, puede estar vacío

Respuestas

Código	Descripción
200	Respuesta HTTP predeterminada tanto para el éxito como para muchos errores de negocio. Solo el código JSON externo 0 indica éxito o aceptación asíncrona; consulta data para obtener el resultado.
429	Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente.
503	La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente.
Opcional	X-Nexscope-Http-Status: semantic asigna estados HTTP a los errores de negocio gestionados por el controlador en las rutas de ejecución y tareas. Los fallos previos a la autenticación, como la ausencia de una clave API (code 11209), pueden seguir devolviendo HTTP 200 antes de esta asignación. Comprueba siempre el código JSON externo; las solicitudes malformadas y los fallos de infraestructura también pueden devolver respuestas HTTP distintas de 200.

Fuente de datos, vigencia y limitaciones

La fuente, la vigencia, la cobertura, los límites de frecuencia y las notas de estimación no se especifican en esta definición de API salvo que aparezcan en la documentación de campos de solicitud o respuesta anterior. No supongas datos oficiales del mercado ni actualización en tiempo real cuando no estén documentados explícitamente.

Paso 1 de 2 · Conectar tu cliente MCP

MCP

Usa el endpoint MCP cuando un agente necesite descubrir y llamar a herramientas de API con JSON-RPC.

GET /mcp/legacy

POST /mcp/legacy
Authorization: Bearer nk-xxxxxxxxxxxxxxxxx
Content-Type: application/json

Paso 2 de 2 · Llamar a la herramienta

Llamar a una herramienta

{
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_etsy_product_detail",
    "arguments": {
      "productUrl": "https://www.etsy.com/listing/1710567856/its-okay-to-make-some-mistakes-shirt"
    }
  }
}

Ejemplo de datos

Parámetros de solicitud

{
  "productUrl": "https://www.etsy.com/listing/4309946455/black-skull-lace-trim-35mm-gothic"
}

Respuesta

{
  "code": 0,
  "msg": null,
  "data": {
    "total": 1,
    "data": [
      {
        "maxQuantity": 10,
        "reviewsScores": {
          "love_it": "5.0",
          "helpful_seller": "100%",
          "fast_delivery": "5.0",
          "great_quality": "5.0",
          "as_described": "What buyers say, summarised by AI:"
        },
        "deliveryDaysMax": 12,
        "shopName": "shadow.bc8764b664a75d.css",
        "description": [
          "Highlights",
          ":host(:not(:defined)) {opacity: 1 !important;}*, *::before, *::after {box-sizing: inherit;}svg {display: block;fill: var(--clg-icon-fill-color, currentColor);height: var(--clg-icon-size, var(--clg-dimension-sem-icon-core-base));width: var(--clg-icon-size, var(--clg-dimension-sem-icon-core-base));aspect-ratio: 1;}",
          "Sourced by",
          "Lindacustom",
          ":host(:not(:defined)) {opacity: 1 !important;}*, *::before, *::after {box-sizing: inherit;}svg {display: block;fill: var(--clg-icon-fill-color, currentColor);height: var(--clg-icon-size, var(--clg-dimension-sem-icon-core-base));width: var(--clg-icon-size, var(--clg-dimension-sem-icon-core-base));aspect-ratio: 1;}",
          "Supplies for making crafts",
          ":host(:not(:defined)) {opacity: 1 !important;}*, *::before, *::after {box-sizing: inherit;}svg {display: block;fill: var(--clg-icon-fill-color, currentColor);height: var(--clg-icon-size, var(--clg-dimension-sem-icon-core-base));width: var(--clg-icon-size, var(--clg-dimension-sem-icon-core-base));aspect-ratio: 1;}",
          "Read the full description",
          "Materials: polyester",
          "This good quality skull lace can be use for Halloween design, decor and other project. When order 2 yares or more you will get it at one piece, over 14 yards you will get 2 pieces.",
          "Width:  about 35mm wide",
          "Length: 1yard,5 yard,14.5 yard"
        ],
        "variants": [],
        "title": "Black Skull Lace Trim: 35mm Gothic Halloween Decor by the yard or wholesale",
        "reviewsTags": [
          {},
          {},
          {},
          {},
          {}
        ],
        "shopReviews": 1261,
        "reviews": 37,
        "lowPrice": "",
        "deliveryDaysMin": 11,
        "price": "",
        "highPrice": "",
        "currency": "USD",
        "shopId": "19023055",
        "shopSales": "",
        "image": "https://i.etsystatic.com/19023055/r/il/866080/6932975567/il_fullxfull.6932975567_58r3.jpg",
        "images": [
          "https://i.etsystatic.com/19023055/r/il/866080/6932975567/il_fullxfull.6932975567_58r3.jpg",
          "https://i.etsystatic.com/19023055/r/il/4ad67a/6884997320/il_fullxfull.6884997320_q6bj.jpg",
          "https://i.etsystatic.com/19023055/r/il/ccd71a/6932975369/il_fullxfull.6932975369_4skb.jpg",
          "https://i.etsystatic.com/19023055/r/il/8d56af/6932975425/il_fullxfull.6932975425_f3kt.jpg",
          "https://i.etsystatic.com/19023055/r/il/f2aea1/6932974989/il_fullxfull.6932974989_48yj.jpg",
          "https://i.etsystatic.com/19023055/r/il/f860c7/6932975535/il_fullxfull.6932975535_gfs4.jpg",
          "https://i.etsystatic.com/19023055/r/il/9aa87f/6932975363/il_fullxfull.6932975363_odxu.jpg",
          "https://i.etsystatic.com/19023055/r/il/7667f2/6884997800/il_fullxfull.6884997800_1de2.jpg",
          "https://i.etsystatic.com/19023055/r/il/68d0fb/6884997838/il_fullxfull.6884997838_ly95.jpg",
          "https://i.etsystatic.com/19023055/r/il/1a3b34/6884997852/il_fullxfull.6884997852_k2sf.jpg"
        ],
        "moreLikeUrl": "",
        "hasConvosBadge": true,
        "productId": "4309946455",
        "star": "",
        "oldPrice": "",
        "hasRatingsBadge": true,
        "searchPosition": "",
        "shopUrl": "https://www.etsy.com/ac/sasquatch/css/collage/shadow.bc8764b664a75d.css",
        "highlightsTags": [
          "Looks great",
          "As described",
          "Love it",
          "Fast shipping",
          "Great quality",
          "Helpful seller",
          "Well packaged"
        ],
        "hasShippingBadge": true,
        "countryShippingFrom": "CN",
        "yearsOnEtsy": "7 years",
        "productUrl": "https://www.etsy.com/listing/4309946455/black-skull-lace-trim-35mm-gothic",
        "category": "Craft Supplies & Tools < Fabric & Notions < Lace & Trims"
      }
    ],
    "columns": [
      {
        "filterable": true,
        "cellType": "text",
        "field": "productId",
        "sortable": true,
        "title": "商品 ID"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "shopId",
        "sortable": true,
        "title": "店铺 ID"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "shopUrl",
        "sortable": true,
        "title": "店铺链接"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "shopSales",
        "sortable": true,
        "title": "店铺销量文本"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "shopName",
        "sortable": true,
        "title": "店铺名称"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "productUrl",
        "sortable": true,
        "title": "商品链接"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "searchPosition",
        "sortable": true,
        "title": "搜索位置"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "image",
        "sortable": true,
        "title": "主图链接"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "images",
        "sortable": true,
        "title": "商品图片列表"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "maxQuantity",
        "sortable": true,
        "title": "最大可购数量"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "variants",
        "sortable": true,
        "title": "商品变体"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "title",
        "sortable": true,
        "title": "商品标题"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "description",
        "sortable": true,
        "title": "商品描述段落"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "deliveryDaysMin",
        "sortable": true,
        "title": "最短配送天数"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "deliveryDaysMax",
        "sortable": true,
        "title": "最长配送天数"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "shopReviews",
        "sortable": true,
        "title": "店铺评论数"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "reviews",
        "sortable": true,
        "title": "商品评论数"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "star",
        "sortable": true,
        "title": "商品评分"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "highlightsTags",
        "sortable": true,
        "title": "评论亮点标签"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "reviewsTags",
        "sortable": true,
        "title": "评论主题统计"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "yearsOnEtsy",
        "sortable": true,
        "title": "入驻 Etsy 年限"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "hasRatingsBadge",
        "sortable": true,
        "title": "是否有评分徽章"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "hasConvosBadge",
        "sortable": true,
        "title": "是否有沟通徽章"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "hasShippingBadge",
        "sortable": true,
        "title": "是否有配送徽章"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "reviewsScores",
        "sortable": true,
        "title": "动态评论评分摘要"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "category",
        "sortable": true,
        "title": "商品分类路径"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "price",
        "sortable": true,
        "title": "商品价格"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "lowPrice",
        "sortable": true,
        "title": "最低价格"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "highPrice",
        "sortable": true,
        "title": "最高价格"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "countryShippingFrom",
        "sortable": true,
        "title": "发货国家或地区"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "currency",
        "sortable": true,
        "title": "货币代码"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "oldPrice",
        "sortable": true,
        "title": "原价"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "moreLikeUrl",
        "sortable": true,
        "title": "相似商品链接"
      }
    ],
    "type": "tableListWorkbenches"
  }
}

Prueba en línea

Ejecuta la API actual con tu clave de API y la carga JSON. Las pruebas en línea usan el entorno de API configurado de este sitio; el Endpoint y los ejemplos que puedes copiar usan la dirección de integración pública.

At least 10 credits / callRegistros de uso de la API

Pruébalo

Envía una solicitud real con el mismo contrato que se muestra en la referencia.

Endpoint

/etsy/product/detail

Método de MCP

nexscope_etsy_product_detail

Clave de API*

Contenido JSON*

cURL

curl -X POST \
  https://api.nexscope.ai/etsy/product/detail \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "productUrl": "https://www.etsy.com/listing/1710567856/its-okay-to-make-some-mistakes-shirt" }'

Respuesta

Todavía no hay respuesta. Ejecuta la solicitud para ver la respuesta aquí.

API relacionadas

Etsy Category Search

Find Etsy category IDs by category name, ID, or parent ID for product and store filtering.

Etsy Product Query

Filter Etsy products by keyword, URL, price, sales, favorites, reviews, listing date, category, product type, and marketplace.

Etsy Store Query

Search Etsy stores by keyword, category, country, status, ratings, sales, favorites, reviews, and opening date with pagination.