API de detalles de productos de Shopee

Consulta los detalles públicos de un producto de Shopee a partir de una URL validada del marketplace, conservando los identificadores de tienda y producto como cadenas para el análisis de productos.

CosteAt least 10 credits / call

Probar en línea

POST · https://api.nexscope.ai/shopee/product/detailMCP · nexscope_shopee_product_detail

Qué hace esta API

Casos de uso de API de detalles de productos de Shopee

Investigar una tienda

Envía la URL de un producto en productUrl y revisa los identificadores de tienda y producto que devuelve la API.

Comparar fichas de productos

Consulta una ficha por solicitud. Compara los datos públicos que devuelve cada consulta, como parte de un análisis de tiendas o productos.

Seleccionar tiendas para un análisis posterior

Conserva los identificadores como cadenas al combinar los resultados con tus datos de investigación.

Preguntas frecuentes sobre API de detalles de productos de Shopee

¿Qué devuelve la API de detalles de productos de Shopee?

Devuelve los datos públicos disponibles del producto indicado en productUrl. Consulta el esquema para conocer los campos de la respuesta. Los valores de ejemplo son ilustrativos.

¿Cuántos créditos cuesta cada consulta?

El coste que se muestra en esta página es At least 10 credits / call. Consulta el registro de uso para comprobar el cargo aplicado.

¿Cómo hago una consulta por REST o MCP?

Para REST, envía una solicitud POST a /shopee/product/detail con tu clave API como token Bearer y productUrl en el cuerpo JSON. Para MCP, conecta Nexscope a tu cliente y llama a nexscope_shopee_product_detail con los argumentos indicados en la guía de MCP.

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

Prueba esta API

Endpoint

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

Método MCP

nexscope_shopee_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/shopee/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/shopee/product/detail' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "productUrl": "https://shopee.sg/%28LENECT-OFFICIAL-STORE%29-Flash-I-Aurora-Dual-Highlighter-7.2g-COCOMO-i.9641401.29691169956"
}'

Ejemplo de código

{
  "productUrl": "https://shopee.sg/%28LENECT-OFFICIAL-STORE%29-Flash-I-Aurora-Dual-Highlighter-7.2g-COCOMO-i.9641401.29691169956"
}

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 Shopee

POSThttps://api.nexscope.ai/shopee/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/shopee/product/detail`
Autenticación	`Bearer API key`
Content-Type	`application/json`

Parámetros de la solicitud

Nombre	Tipo	Obligatorio	Descripción
`productUrl`	`string`	obligatorio	URL HTTPS de un producto de Shopee. El dominio debe pertenecer a uno de los ocho sitios admitidos. Omite el puerto o utiliza el 443. La ruta debe terminar en `-i.<shopId numérico>.<itemId numérico>`.

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 (7 campos)

Nombre	Tipo	Obligatorio	Descripción
`errcode`	`integer`	opcional	Código de estado de la operación; `200` indica que se completó correctamente.
`errmsg`	`string`	opcional	Mensaje de estado de la operación; devuelve `ok` cuando se completa correctamente.
`data`	`array`	opcional	Lista de productos de Shopee; contiene exactamente un elemento si la operación se completa correctamente.
`total`	`integer`	opcional	Devuelve `1` cuando la operación se completa correctamente.
`costToken`	`integer`	opcional	Cantidad de tokens consumidos.
`type`	`string`	opcional	Valor fijo `tableListWorkbenches`.
`columns`	`array`	opcional	Columnas de presentación generadas a partir de los campos comunes del producto.

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_shopee_product_detail",
    "arguments": {
      "productUrl": "https://shopee.sg/example-i.9641401.29691169956"
    }
  }
}

Ejemplo de datos

Parámetros de solicitud

{
  "productUrl": "https://shopee.sg/product-i.120981896.43103076730"
}

Respuesta

{
  "code": 0,
  "msg": null,
  "data": {
    "total": 1,
    "data": [
      {
        "priceMax": 138,
        "rating": 4.8,
        "shopName": "Logitech Official Store",
        "description": "Key Product Description\n\nLogitech Flip Folio for iPad Pro & Air - Graphite\n\nRemovable Keyboard Keyboard can be stowed away when not needed, reducing weight for on-the-go use. One Size Fits Two One model fits both iPad Pro and iPad Air (13\" or 11\"), making it easier to choose and stock.\n\n\n\nProduct Information\n\nWeight: 1.02kg\n\nDimensions: 32cm x 23cm x 3cm\n\n\n\nAdditional Information\n\nPlease refer to the product packaging for full product information.",
        "priceMin": 138,
        "tierVariations": [
          {
            "images": [
              "sg-11134301-7rau3-mb6gmdd2iew9f5",
              "sg-11134301-7rasf-mb6cu58d5ieu55"
            ],
            "name": "Default",
            "options": [
              "13 inch",
              "11 inch"
            ]
          }
        ],
        "shopRating": 4.912435,
        "price": 138,
        "currency": "SGD",
        "shopId": "120981896",
        "categoryBreadcrumb": [
          "Computers & Accessories",
          "Keyboards & Mice",
          "Keyboards"
        ],
        "brand": "Logitech",
        "image": "https://down-sg.img.susercontent.com/file/sg-11134301-7ravc-majmq0zszs3728",
        "models": [
          {
            "name": "13 inch",
            "tier_index": [
              0
            ],
            "model_id": "248478921359",
            "is_pre_order": false,
            "status": 1
          },
          {
            "name": "11 inch",
            "tier_index": [
              1
            ],
            "model_id": "280434604246",
            "is_pre_order": false,
            "status": 1
          }
        ],
        "images": [
          "https://down-sg.img.susercontent.com/file/sg-11134301-7ravc-majmq0zszs3728",
          "https://down-sg.img.susercontent.com/file/sg-11134301-7ravo-majmqorse7361a",
          "https://down-sg.img.susercontent.com/file/sg-11134301-7ravj-majn87vymz4h2b",
          "https://down-sg.img.susercontent.com/file/sg-11134301-7rate-majmqzgclt1sd0",
          "https://down-sg.img.susercontent.com/file/sg-11134301-7rav9-majmqrz7i9gi5c",
          "https://down-sg.img.susercontent.com/file/sg-11134301-7rat5-majmqs0bgmwz32",
          "https://down-sg.img.susercontent.com/file/sg-11134301-7raun-majmqrz7jnyb4e",
          "https://down-sg.img.susercontent.com/file/sg-11134301-7rau3-majmqrzhngmra4",
          "https://down-sg.img.susercontent.com/file/sg-11134301-7rasp-majmqu9m5o1v83"
        ],
        "discountPercent": 46,
        "shopLocation": "SG",
        "url": "https://shopee.sg/product-i.120981896.43103076730",
        "isOfficialShop": true,
        "itemId": "43103076730",
        "name": "Logitech Flip Folio for iPad Pro & Air - Graphite",
        "attributes": [
          {
            "name": "Bundle Set",
            "value": "No"
          },
          {
            "name": "Gaming Focused",
            "value": "No"
          }
        ],
        "categoryId": "100644"
      }
    ],
    "columns": [
      {
        "filterable": true,
        "cellType": "text",
        "field": "itemId",
        "sortable": true,
        "title": "商品 ID"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "shopId",
        "sortable": true,
        "title": "店铺 ID"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "url",
        "sortable": true,
        "title": "商品链接"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "name",
        "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": "price",
        "sortable": true,
        "title": "当前价格"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "priceBeforeDiscount",
        "sortable": true,
        "title": "折前价格"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "priceMin",
        "sortable": true,
        "title": "最低价格"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "priceMax",
        "sortable": true,
        "title": "最高价格"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "discountPercent",
        "sortable": true,
        "title": "折扣百分比"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "currency",
        "sortable": true,
        "title": "货币代码"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "stock",
        "sortable": true,
        "title": "总库存"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "sold",
        "sortable": true,
        "title": "累计售出数量"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "soldDisplayed",
        "sortable": true,
        "title": "页面展示售出数量"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "rating",
        "sortable": true,
        "title": "商品评分"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "ratingCount",
        "sortable": true,
        "title": "评分数量"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "likedCount",
        "sortable": true,
        "title": "点赞数量"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "commentCount",
        "sortable": true,
        "title": "评论数量"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "reviewsFetched",
        "sortable": true,
        "title": "本次抓取评论数量"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "reviewSummary",
        "sortable": true,
        "title": "评论统计摘要"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "shopName",
        "sortable": true,
        "title": "店铺名称"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "shopRating",
        "sortable": true,
        "title": "店铺评分"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "shopLocation",
        "sortable": true,
        "title": "店铺所在地"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "isOfficialShop",
        "sortable": true,
        "title": "是否官方店铺"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "isCrossBorder",
        "sortable": true,
        "title": "是否跨境商品"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "categoryId",
        "sortable": true,
        "title": "类目 ID"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "brand",
        "sortable": true,
        "title": "品牌"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "tierVariations",
        "sortable": true,
        "title": "销售属性"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "models",
        "sortable": true,
        "title": "SKU 变体及库存"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "categoryBreadcrumb",
        "sortable": true,
        "title": "类目路径"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "videos",
        "sortable": true,
        "title": "商品视频"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "description",
        "sortable": true,
        "title": "商品描述"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "attributes",
        "sortable": true,
        "title": "商品规格属性"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "estimatedShippingDays",
        "sortable": true,
        "title": "预计发货天数"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "isFreeShipping",
        "sortable": true,
        "title": "是否免运费"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "scrapedAt",
        "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

/shopee/product/detail

Método de MCP

nexscope_shopee_product_detail

Clave de API*

Contenido JSON*

cURL

curl -X POST \
  https://api.nexscope.ai/shopee/product/detail \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "productUrl": "https://shopee.sg/%28LENECT-OFFICIAL-STORE%29-Flash-I-Aurora-Dual-Highlighter-7.2g-COCOMO-i.9641401.29691169956" }'

Respuesta

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

API relacionadas

Shopee Product Search

Search and filter products across supported Shopee markets in Asia and Latin America for product selection and marketplace.