Nexscope

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.

CosteRecent 11 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 Recent 11 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éditosConecta esta API con MCP

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ódigoDescripción
200Respuesta 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.
429Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente.
503La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente.
OpcionalX-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 una clave API ausente o no válida (code 11209, incluida una copia incompleta o dañada) o una sesión web caducada (code 12001), 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.
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.

Endpoint

MétodoPOST
Rutahttps://api.nexscope.ai/etsy/product/detail
AutenticaciónBearer API key
Content-Typeapplication/json

Parámetros de la solicitud

NombreTipoObligatorioDescripción
productUrlstringobligatorio
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)

NombreTipoObligatorioDescripción
errcodeintegeropcional
Business status code; `200` indicates success
errmsgstringopcional
Business status message; `ok` on success
dataarrayopcional
Array of product objects; fixed to 1 item when successful
totalintegeropcional
Fixed to `1` when successful
costTokenintegeropcional
Consume token
typestringopcional
Fixed to `tableListWorkbenches`
columnsarrayopcional
Rendering column definition generated based on product top-level fields
productIdstringopcional
Etsy listing ID
shopIdstringopcional
Store ID
shopUrlstringopcional
Store URL; it may be empty or misidentified when the page is abnormal.
shopSalesstringopcional
Store public sales text
shopNamestringopcional
Store name; it may be empty or misidentified when the page is abnormal.
productUrlstringopcional
Product URL
searchPositionstringopcional
Source search location; usually empty for direct queries
imagestringopcional
Main image URL
imagesarrayopcional
Image URL list
maxQuantityintegeropcional
Maximum available quantity reported on the page
variantsarrayopcional
Product variations; empty array if no variations
titlestringopcional
Título del producto
descriptionarrayopcional
list of description paragraphs
shopReviewsintegeropcional
Number of store reviews
reviewsintegeropcional
Current number of listing comments
starstringopcional
Current rating, may be an empty string
highlightsTagsarrayopcional
Buyer Feedback Highlights Tag
reviewsTagsarrayopcional
Comment tags and frequency objects
yearsOnEtsystringopcional
How long your store has been public on Etsy
hasRatingsBadgebooleanopcional
Is there a rating badge?
hasConvosBadgebooleanopcional
Is there a communication badge?
hasShippingBadgebooleanopcional
Is there a delivery badge?
reviewsScoresobjectopcional
Dynamic review itemization; keys and values change from page to page
categorystringopcional
Category breadcrumbs
countryShippingFromstringopcional
Shipping country/region
currencystringopcional
currency code
moreLikeUrlstringopcional
Similar recommendation link, may be empty

Respuestas

CódigoDescripción
200Respuesta 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.
429Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente.
503La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente.
OpcionalX-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 una clave API ausente o no válida (code 11209, incluida una copia incompleta o dañada) o una sesión web caducada (code 12001), 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"
    }
  }
}

¿Qué puedes hacer con esta API?

Datos explicados y casos de uso prácticos

AI Guide

Question

What data can Etsy Product Detail provide, and how might I use it?

AI answer

Give this API an Etsy listing URL to retrieve documented listing, shop, image, review, and shipping details. Successful results are described as containing one product; the example also shows price, although the listed response fields do not define it.

Data categoryDocumented fieldsWhat the values mean
Listing identity and contentproductId, productUrl, title, description, categoryThe listing ID and link, title, description paragraphs, and category breadcrumbs.
Images and choicesimage, images, variants, maxQuantityThe main image, image list, available variations, and quantity reported on the page.
Shop contextshopId, shopName, shopUrl, shopSales, yearsOnEtsyShop identifiers and links, public sales text, and reported time on Etsy. Shop name and URL can be empty or misidentified on abnormal pages.
Buyer feedbackreviews, star, highlightsTags, reviewsTags, reviewsScores, shopReviewsListing and shop review information, rating, and feedback breakdowns; the rating may be empty and breakdown keys vary.
Fulfilment and currencycountryShippingFrom, currencyReported shipping origin and currency code.
Shop badgeshasRatingsBadge, hasConvosBadge, hasShippingBadgeWhether rating, communication, and delivery badges appear.
  • Review a listing’s title, description, images, and variations before planning a comparable product.
    • Prompt example: “I am researching products on Etsy. Could you review a listing’s title, description, images, and variations before planning a comparable product? Show the relevant returned evidence and tell me what input you need from me.”
  • Examine review counts, ratings, and feedback tags to identify aspects buyers discuss.
    • Prompt example: “I am researching products on Etsy. Could you examine review counts, ratings, and feedback tags to identify aspects buyers discuss? Show matching records and source links where the API provides them; ask me for any required identifier or filter.”
  • Check the reported shipping origin and currency when comparing listings across markets.
    • Prompt example: “I am researching products on Etsy. Could you check the reported shipping origin and currency when comparing listings across markets? Show the relevant returned evidence and tell me what input you need from me.”
  • Connect a listing to its shop and inspect its public shop context, while checking uncertain shop details against the source page.
    • Prompt example: “I am researching products on Etsy. Could you connect a listing to its shop and inspect its public shop context, while checking uncertain shop details against the source page? Show the relevant returned evidence and tell me what input you need from me.”

Ejemplo de datos

Ejemplo de solicitud y respuesta

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"
  }
}

API relacionadas