Nexscope

Detalles de productos de Google Shopping

Obtén detalles de productos de Google Shopping, incluidas especificaciones y ofertas. Llama a la API de Detalles de productos de Google Shopping mediante REST o MCP para automatizar la investigación SEO.

CosteEstimación: 10 créditos / llamada
Probar en línea
POST · https://api.nexscope.ai/seo/shoppingProductDetailsMCP · nexscope_seo_shopping_product_details
Resultados de búsqueda (SERP)

Qué hace esta API

Obtén detalles de productos de Google Shopping, incluidas especificaciones y ofertas. La generación se ejecuta como una tarea: conserva el ID de la tarea y recupera el resultado completado antes de utilizarlo.

Casos de uso de la API de Detalles de productos de Google Shopping

Investigar un vendedor o una tienda

Para investigar un vendedor o una tienda, un especialista en marketing de búsqueda envía las entradas específicas de la operación a Detalles de productos de Google Shopping. Los resultados específicos de la operación permiten identificar la tienda asociada a un producto candidato.

Comparar pruebas de productos entre tiendas

Un especialista en marketing de búsqueda utiliza Detalles de productos de Google Shopping con las entradas específicas de la operación para comparar pruebas de productos entre tiendas. Los resultados específicos de la operación permiten comparar productos o fichas de productos entre las tiendas seleccionadas.

Seleccionar tiendas para continuar la investigación

En este flujo de trabajo, un especialista en marketing de búsqueda llama a Detalles de productos de Google Shopping con las entradas específicas de la operación para seleccionar tiendas para continuar la investigación. El resultado permite seleccionar tiendas para revisar proveedores o competidores.

Preguntas frecuentes sobre la API de Detalles de productos de Google Shopping

¿Qué devuelve la API de Detalles de productos de Google Shopping?

Obtén detalles de productos de Google Shopping, incluidas especificaciones y ofertas. La respuesta inicial puede incluir un ID de tarea y su estado; el resultado de la tarea completada contiene la salida generada. Los valores de ejemplo ilustran la estructura de la respuesta, no resultados reales de la cuenta.

¿Cuántos créditos cuesta la API de Detalles de productos de Google Shopping?

El coste documentado actualmente es Estimación: 10 créditos / llamada. Es el mismo coste que se muestra en la parte superior de esta página. Si se muestra un intervalo o una estimación, el cargo final depende de la solicitud. Revisa tus créditos disponibles y la página de precios antes de llamar a la API, y consulta los registros de uso de la API para conocer el cargo real.

¿Cómo llamo a la API de Detalles de productos de Google Shopping desde mi aplicación o un cliente MCP?

Envía una solicitud POST a /api/skill-api/v1/skills/seo-shopping-product-details/run con tu clave de API como token Bearer y las entradas JSON mostradas en Integración de API. En un cliente MCP compatible, como Claude o Cursor, conecta Nexscope y llama a nexscope_seo_shopping_product_details. Se aplican los mismos parámetros de solicitud documentados; utiliza Prueba en línea para revisar una solicitud antes de incorporarla a tu aplicación.

Ver planes y créditosConectar esta API mediante MCP (en inglés)

Prueba esta API
Endpoint
https://api.nexscope.ai/seo/shoppingProductDetails
Método MCP
nexscope_seo_shopping_product_details

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/seo/shoppingProductDetails

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/seo/shoppingProductDetails' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "productRef": "",
  "task_id": ""
}'

Ejemplo de código

{
  "productRef": "",
  "task_id": ""
}

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 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.
Todas las categorías/ Search Results (SERP)
POSThttps://api.nexscope.ai/seo/shoppingProductDetails

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/seo/shoppingProductDetails
AutenticaciónBearer API key
Content-Typeapplication/json

Parámetros de la solicitud

NombreTipoObligatorioDescripción
productRefstringobligatorio
Valor de Product ref usado por esta operación de API.
Patrón: ^[0-9a-f]{64}$
task_idstringobligatorio
Valor de Task id usado por esta operación de API.
Formato: uuid

Respuesta de ejemplo

Estructura de respuesta de ejemplo del contrato documentado de la API de SEO.

{
  "code": 0,
  "cost": "-1",
  "data": {
    "callId": "synthetic-call",
    "completedAt": null,
    "coverage": {
      "missing": [
        {
          "field": "synthetic",
          "reason": "UPSTREAM_FIELD_MISSING"
        }
      ],
      "status": "PARTIAL"
    },
    "requestedAt": "123",
    "result": {
      "details": [
        {
          "description": "synthetic",
          "features": [
            "synthetic"
          ],
          "images": [
            "synthetic"
          ],
          "specifications": [
            {
              "blockName": "synthetic",
              "name": "synthetic",
              "value": "synthetic"
            }
          ],
          "title": "synthetic",
          "url": "synthetic"
        }
      ],
      "meta": {
        "market": {
          "country": "synthetic",
          "language": "synthetic",
          "locationCode": 1
        },
        "missing": [
          {
            "path": "synthetic",
            "reason": "synthetic"
          }
        ],
        "missingOverflow": false,
        "retrievedAt": 9007199254740992,
        "sampledAt": 9007199254740992,
        "source": "synthetic",
        "truncated": false
      },
      "productRef": "synthetic",
      "sourceCallId": "synthetic"
    },
    "schemaVersion": "synthetic",
    "source": "synthetic",
    "status": "PARTIAL",
    "usage": {
      "billingStatus": "UNAPPROVED",
      "chargedCredits": "0"
    }
  },
  "msg": null,
  "time": "2026-01-01 00:00:00",
  "traceId": "synthetic-trace",
  "ts": "9007199254740993"
}

Campos de respuesta

NombreTipoObligatorioDescripción
codeintegerobligatorio
0 indica un sobre de respuesta satisfactorio; comprueba data.status por separado.
Permitidos: 0, 42008, 42009
coststringobligatorio
Milisegundos transcurridos de procesamiento; no es el precio. -1 en un contexto no web.
dataobjectobligatorio
Valor de Data usado por esta operación de API.
data.callIdstring | nullopcional
Valor de Call id usado por esta operación de API.
data.completedAtstring | integer | nullopcional
Valor de Completed at usado por esta operación de API.
data.coverageobjectopcional
Valor de Coverage usado por esta operación de API.
data.coverage.missingarrayopcional
Valor de Missing usado por esta operación de API.
data.coverage.missing[]objectobligatorio
Elemento de data coverage missing.
data.coverage.missing[].fieldstringopcional
Valor de Field usado por esta operación de API.
data.coverage.missing[].reasonstringopcional
Valor de Reason usado por esta operación de API.
data.coverage.statusstringopcional
Valor de Status usado por esta operación de API.
data.requestedAtstring | integer | nullopcional
Valor de Requested at usado por esta operación de API.
data.resultobject | nullobligatorio
Valor de Result usado por esta operación de API.
data.result.detailsarrayobligatorio
Valor de Details usado por esta operación de API.
Cantidad máxima de elementos: 10
data.result.details[]objectobligatorio
Elemento de data result details.
data.result.details[].descriptionanyobligatorio
Valor de Description usado por esta operación de API.
data.result.details[].featuresarrayobligatorio
Valor de Features usado por esta operación de API.
Cantidad máxima de elementos: 30
data.result.details[].features[]stringobligatorio
Elemento de data result details[] features.
Longitud máxima: 1024
data.result.details[].imagesarrayobligatorio
Valor de Images usado por esta operación de API.
Cantidad máxima de elementos: 20
data.result.details[].images[]stringobligatorio
Elemento de data result details[] images.
Longitud máxima: 4096
data.result.details[].specificationsarrayobligatorio
Valor de Specifications usado por esta operación de API.
Cantidad máxima de elementos: 50
data.result.details[].specifications[]objectobligatorio
Elemento de data result details[] specifications.
data.result.details[].specifications[].blockNameanyobligatorio
Valor de Block name usado por esta operación de API.
data.result.details[].specifications[].nameanyobligatorio
Valor de Name usado por esta operación de API.
data.result.details[].specifications[].valueanyobligatorio
Valor de Value usado por esta operación de API.
data.result.details[].titleanyobligatorio
Valor de Title usado por esta operación de API.
data.result.details[].urlanyobligatorio
Valor de Url usado por esta operación de API.
data.result.metaobjectobligatorio
Valor de Meta usado por esta operación de API.
data.result.meta.marketobjectobligatorio
Valor de Market usado por esta operación de API.
data.result.meta.market.countrystringobligatorio
Valor de Country usado por esta operación de API.
Constante: US
data.result.meta.market.languagestringobligatorio
Valor de Language usado por esta operación de API.
Constante: en
data.result.meta.market.locationCodeintegerobligatorio
Valor de Location code usado por esta operación de API.
Constante: 2840
data.result.meta.missingarrayobligatorio
Valor de Missing usado por esta operación de API.
Cantidad máxima de elementos: 100
data.result.meta.missing[]objectobligatorio
Elemento de data result meta missing.
data.result.meta.missing[].pathstringobligatorio
Valor de Path usado por esta operación de API.
Longitud máxima: 256
data.result.meta.missing[].reasonstringobligatorio
Valor de Reason usado por esta operación de API.
Permitidos: MISSING, NULL, INVALID, UNSUPPORTED, TRUNCATED
data.result.meta.missingOverflowbooleanobligatorio
Valor de Missing overflow usado por esta operación de API.
data.result.meta.retrievedAtanyobligatorio
Valor de Retrieved at usado por esta operación de API.
data.result.meta.sampledAtanyobligatorio
Valor de Sampled at usado por esta operación de API.
data.result.meta.sourcestringobligatorio
Valor de Source usado por esta operación de API.
Constante: DATAFORSEO_GOOGLE_SHOPPING_PRODUCT_INFO
data.result.meta.truncatedbooleanobligatorio
Valor de Truncated usado por esta operación de API.
data.result.productRefstringobligatorio
Valor de Product ref usado por esta operación de API.
Patrón: ^[0-9a-f]{64}$
data.result.sourceCallIdstringobligatorio
Valor de Source call id usado por esta operación de API.
Formato: uuid
data.schemaVersionstring | nullopcional
Valor de Schema version usado por esta operación de API.
data.sourcestring | nullopcional
Valor de Source usado por esta operación de API.
data.statusstringopcional
Valor de Status usado por esta operación de API.
Permitidos: SUCCESS, PARTIAL, EMPTY, PROCESSING, UNKNOWN, FAILED
data.usageobject | nullopcional
Valor de Usage usado por esta operación de API.
data.usage.billingStatusstring | nullopcional
Valor de Billing status usado por esta operación de API.
data.usage.chargedCreditsstring | integer | nullopcional
Valor de Charged credits usado por esta operación de API.
msgstring | nullobligatorio
Para los casos satisfactorios y los fallos se prefiere el valor disponible de msg/errmsg/message del proveedor; el chino se traduce al inglés. Si falta el mensaje de éxito, su valor es null. Los errores propios de la plataforma y los estados de las tareas utilizan el inglés de la plataforma. El texto del mensaje nunca determina el éxito ni el reintento.
timestringobligatorio
yyyy-MM-dd HH:mm:ss
traceIdstring | nullobligatorio
Valor de Trace id usado por esta operación de API.
tsstringobligatorio
Milisegundos desde el inicio de la época; serializador global de enteros long.

Opción 1 de cualquier alternativa

NombreTipoObligatorioDescripción
data.result.details[].descriptionstringobligatorio
Valor de Description usado por esta operación de API.
Longitud máxima: 8192

Opción 2 de cualquier alternativa

NombreTipoObligatorioDescripción
data.result.details[].descriptionnullobligatorio
Valor de Description usado por esta operación de API.

Opción 1 de cualquier alternativa

NombreTipoObligatorioDescripción
data.result.details[].specifications[].blockNamestringobligatorio
Valor de Block name usado por esta operación de API.
Longitud máxima: 1024

Opción 2 de cualquier alternativa

NombreTipoObligatorioDescripción
data.result.details[].specifications[].blockNamenullobligatorio
Valor de Block name usado por esta operación de API.

Opción 1 de cualquier alternativa

NombreTipoObligatorioDescripción
data.result.details[].specifications[].namestringobligatorio
Valor de Name usado por esta operación de API.
Longitud máxima: 1024

Opción 2 de cualquier alternativa

NombreTipoObligatorioDescripción
data.result.details[].specifications[].namenullobligatorio
Valor de Name usado por esta operación de API.

Opción 1 de cualquier alternativa

NombreTipoObligatorioDescripción
data.result.details[].specifications[].valuestringobligatorio
Valor de Value usado por esta operación de API.
Longitud máxima: 8192

Opción 2 de cualquier alternativa

NombreTipoObligatorioDescripción
data.result.details[].specifications[].valuenullobligatorio
Valor de Value usado por esta operación de API.

Opción 1 de cualquier alternativa

NombreTipoObligatorioDescripción
data.result.details[].titlestringobligatorio
Valor de Title usado por esta operación de API.
Longitud máxima: 1024

Opción 2 de cualquier alternativa

NombreTipoObligatorioDescripción
data.result.details[].titlenullobligatorio
Valor de Title usado por esta operación de API.

Opción 1 de cualquier alternativa

NombreTipoObligatorioDescripción
data.result.details[].urlstringobligatorio
Valor de Url usado por esta operación de API.
Longitud máxima: 4096

Opción 2 de cualquier alternativa

NombreTipoObligatorioDescripción
data.result.details[].urlnullobligatorio
Valor de Url usado por esta operación de API.

Opción 1 de cualquier alternativa

NombreTipoObligatorioDescripción
data.result.meta.retrievedAtintegerobligatorio
Valor de Retrieved at usado por esta operación de API.
Mínimo: 0
Máximo: 9007199254740991

Opción 2 de cualquier alternativa

NombreTipoObligatorioDescripción
data.result.meta.retrievedAtnullobligatorio
Valor de Retrieved at usado por esta operación de API.

Opción 1 de cualquier alternativa

NombreTipoObligatorioDescripción
data.result.meta.sampledAtintegerobligatorio
Valor de Sampled at usado por esta operación de API.
Mínimo: 0
Máximo: 9007199254740991

Opción 2 de cualquier alternativa

NombreTipoObligatorioDescripción
data.result.meta.sampledAtnullobligatorio
Valor de Sampled at usado por esta operación de API.

Respuesta de procesamiento aceptado

code 0 confirma la aceptación. Usa data.callId para consultar la misma solicitud; el procesamiento no implica finalización.

NombreTipoObligatorioDescripción
codeintegerobligatorio
0 indica un sobre de respuesta satisfactorio; comprueba data.status por separado.
Constante: 0
coststringobligatorio
Milisegundos transcurridos de procesamiento; no es el precio. -1 en un contexto no web.
dataobjectobligatorio
Valor de Data usado por esta operación de API.
data.callIdstring | nullobligatorio
Valor de Call id usado por esta operación de API.
data.reasonstringobligatorio
Valor de Reason usado por esta operación de API.
Constante: IN_PROGRESS
data.retryablebooleanopcional
Valor de Retryable usado por esta operación de API.
data.statusstringobligatorio
Valor de Status usado por esta operación de API.
Constante: PROCESSING
data.taskIdstring | nullopcional
Valor de Task id usado por esta operación de API.
msgstring | nullobligatorio
Para los casos satisfactorios y los fallos se prefiere el valor disponible de msg/errmsg/message del proveedor; el chino se traduce al inglés. Si falta el mensaje de éxito, su valor es null. Los errores propios de la plataforma y los estados de las tareas utilizan el inglés de la plataforma. El texto del mensaje nunca determina el éxito ni el reintento.
timestringobligatorio
yyyy-MM-dd HH:mm:ss
traceIdstring | nullobligatorio
Valor de Trace id usado por esta operación de API.
tsstringobligatorio
Milisegundos desde el inicio de la época; serializador global de enteros long.

Respuesta de error

NombreTipoObligatorioDescripción
codeintegerobligatorio
0 indica un sobre de respuesta satisfactorio; comprueba data.status por separado.
coststringobligatorio
Milisegundos transcurridos de procesamiento; no es el precio. -1 en un contexto no web.
dataobjectobligatorio
Valor de Data usado por esta operación de API.
data.callIdstring | nullobligatorio
Valor de Call id usado por esta operación de API.
data.reasonstring | nullobligatorio
Valor de Reason usado por esta operación de API.
data.retryablebooleanopcional
Valor de Retryable usado por esta operación de API.
data.statusstring | nullobligatorio
Valor de Status usado por esta operación de API.
data.taskIdstring | nullopcional
Valor de Task id usado por esta operación de API.
msgstring | nullobligatorio
Para los casos satisfactorios y los fallos se prefiere el valor disponible de msg/errmsg/message del proveedor; el chino se traduce al inglés. Si falta el mensaje de éxito, su valor es null. Los errores propios de la plataforma y los estados de las tareas utilizan el inglés de la plataforma. El texto del mensaje nunca determina el éxito ni el reintento.
timestringobligatorio
yyyy-MM-dd HH:mm:ss
traceIdstring | nullobligatorio
Valor de Trace id usado por esta operación de API.
tsstringobligatorio
Milisegundos desde el inicio de la época; serializador global de enteros long.

Obtener un resultado en procesamiento

Una respuesta conPROCESSING y un callIdsignifica que el resultado aún se está preparando. Usa la consulta de resultado siguiente con el identificador devuelto. Esta consulta lee el resultado guardado y no consume créditos.

curl -X GET https://api.nexscope.ai/seo/shoppingProductDetails/calls/{callId} \
  -H "Authorization: Bearer nk-xxxxxxxxxxxxxxxxx"

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 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_seo_shopping_product_details",
    "arguments": {
      "productRef": "",
      "task_id": ""
    }
  }
}

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.

Usa tu sesión iniciada en Nexscope
Laboratorio de API SEO

Detalles de productos de Google Shopping

Obtén detalles de productos de Google Shopping, incluidas especificaciones y ofertas. Llama a la API de Detalles de productos de Google Shopping mediante REST o MCP para automatizar la investigación SEO.

Solicitud en tiempo real
Estimación: 10 créditos / llamadaRegistros de uso de la API

Ejecuta primero Shopping Search y utiliza una referencia de producto devuelta. El ID de tarea y la referencia se completan automáticamente cuando están disponibles.

*
Valor enviado como parámetro «productRef» de la solicitud.
*
Valor enviado como parámetro «task_id» de la solicitud.

Las llamadas en tiempo real pueden consumir créditos de datos.

Resultado del procesamiento

Si una solicitud sigue procesándose, usa el identificador devuelto para recuperar su resultado guardado. El probador reconoce el identificador automáticamente y las consultas de resultados no consumen créditos.

Respuesta en tiempo real

Resultados

Aquí aparecerá el resultado en tiempo real.

Completa los campos de la solicitud anteriores y ejecuta la API. No se sustituye el resultado por una respuesta de ejemplo.

Probar con una clave API o MCP
Estimación: 10 créditos / llamadaRegistros de uso de la API

Pruébalo

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

Endpoint
/seo/shoppingProductDetails
Processing result endpoint
https://api.nexscope.ai/seo/shoppingProductDetails/calls/{resultId}
Método de MCP
nexscope_seo_shopping_product_details
cURL
curl -X POST \
  https://api.nexscope.ai/seo/shoppingProductDetails \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "productRef": "", "task_id": "" }'
Respuesta
Todavía no hay respuesta. Ejecuta la solicitud para ver la respuesta aquí.
Resultado del procesamiento

Usa el identificador recibido al ejecutar la solicitud. La herramienta de pruebas selecciona automáticamente la consulta de resultados correcta y estas consultas no consumen créditos.

Respuesta del resultado
No task result yet. Query the task to see the generated output here.

API relacionadas