https://api.nexscope.ai/etsy/product/detailEjecutar esta API
Envía una solicitud JSON para ejecutar esta API y recibir los datos de respuesta documentados.
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 | Business status code; `200` indicates success |
errmsg | string | opcional | Business status message; `ok` on success |
data | array | opcional | Array of product objects; fixed to 1 item when successful |
total | integer | opcional | Fixed to `1` when successful |
costToken | integer | opcional | Consume token |
type | string | opcional | Fixed to `tableListWorkbenches` |
columns | array | opcional | Rendering column definition generated based on product top-level fields |
productId | string | opcional | Etsy listing ID |
shopId | string | opcional | Store ID |
shopUrl | string | opcional | Store URL; it may be empty or misidentified when the page is abnormal. |
shopSales | string | opcional | Store public sales text |
shopName | string | opcional | Store name; it may be empty or misidentified when the page is abnormal. |
productUrl | string | opcional | Product URL |
searchPosition | string | opcional | Source search location; usually empty for direct queries |
image | string | opcional | Main image URL |
images | array | opcional | Image URL list |
maxQuantity | integer | opcional | Maximum available quantity reported on the page |
variants | array | opcional | Product variations; empty array if no variations |
title | string | opcional | Título del producto |
description | array | opcional | list of description paragraphs |
shopReviews | integer | opcional | Number of store reviews |
reviews | integer | opcional | Current number of listing comments |
star | string | opcional | Current rating, may be an empty string |
highlightsTags | array | opcional | Buyer Feedback Highlights Tag |
reviewsTags | array | opcional | Comment tags and frequency objects |
yearsOnEtsy | string | opcional | How long your store has been public on Etsy |
hasRatingsBadge | boolean | opcional | Is there a rating badge? |
hasConvosBadge | boolean | opcional | Is there a communication badge? |
hasShippingBadge | boolean | opcional | Is there a delivery badge? |
reviewsScores | object | opcional | Dynamic review itemization; keys and values change from page to page |
category | string | opcional | Category breadcrumbs |
countryShippingFrom | string | opcional | Shipping country/region |
currency | string | opcional | currency code |
moreLikeUrl | string | opcional | Similar recommendation link, may be empty |
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 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.