API de mercado de categorías de Walmart

Encuentra categorías de Walmart y revisa informes del mercado de categorías. Invoca la API mediante REST o MCP en tu aplicación o agente de IA.

CosteAt least 10 credits / call

Probar en línea

POST · https://api.nexscope.ai/st/walmart/categoryMarketMCP · nexscope_walmart_category_market

Qué hace esta API

Encuentra categorías de Walmart y revisa los informes de mercado de la categoría.

Casos de uso de API de mercado de categorías de Walmart

Listar un segmento del mercado

Para seleccionar un segmento de mercado, un analista de mercado presenta las entradas específicas de la operación al Walmart Category Market. requestConsumed ayudar a identificar categorías o productos que merezcan una mayor investigación de mercado.

Comparar productos o categorías clasificados

Un analista de mercado utiliza Walmart Category Market con las entradas específicas de la operación para comparar productos clasificados o categorías. requestConsumed ayudar a comparar candidatos dentro del alcance de clasificación solicitado.

Investigar a los candidatos antes de buscar

Para este flujo de trabajo, un analista de mercado llama a Walmart Category Market con las entradas específicas de la operación para investigar a los candidatos antes de buscar. El resultado ayuda a elegir productos para investigar antes de contactar con proveedores.

Preguntas frecuentes sobre API de mercado de categorías de Walmart

¿Qué hace el mercado de categorías Walmart? API ¿Volver?

Encuentre las categorías de Walmart y revise los informes de mercado de la categoría. `errcode`, `errmsg`, `requestConsumed`, `costCredit`, `sourceType`, `tree`, `searchByName`, `marketReport`. 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 Walmart Category Market? 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 mercado de categoría Walmart? API desde mi aplicación o un MCP ¿Cliente?

Enviar a POST solicitud a /st/walmart/categoryMarket 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_walmart_category_market. 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/st/walmart/categoryMarket

Método MCP

nexscope_walmart_category_market

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/st/walmart/categoryMarket

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/st/walmart/categoryMarket' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "operation": "tree"
}'

Ejemplo de código

{
  "operation": "tree"
}

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/ Inteligencia de Walmart ST

POSThttps://api.nexscope.ai/st/walmart/categoryMarket

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/st/walmart/categoryMarket`
Autenticación	`Bearer API key`
Content-Type	`application/json`

Parámetros de la solicitud

No se han definido campos obligatorios de solicitud para esta API.

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

Nombre	Tipo	Obligatorio	Descripción
`errcode`	`integer`	opcional	Código de estado de la capa de la capa de la puerta de enlace; `200` indica que la solicitud entró con éxito en la respuesta empresarial
`errmsg`	`string`	opcional	Mensaje de estado de la capa de framework de pasarela; típicamente `ok` sobre el éxito
`code`	`integer`	opcional	`200` indica éxito
`msg`	`string`	opcional	Mensaje de respuesta; cuando no hay datos, puede ser "consultar con éxito, pero no hay datos"
`data`	`object`	opcional	Contenedor de respuesta fija; `data.value` conserva el arreglo primitivo ST, objeto, escalar o `null` por operación
`operation`	`string`	opcional	`tree`, `searchByName` o `marketReport` ejecutada esta vez
`requestConsumed`	`integer`	opcional	Este consumo previo; cuando el anterior no está o devuelve 0, se completa según el consumo de documento de la operación; cuando ST explícitamente devuelve `Code=11` (sin datos), permanece 0
`costTime`	`integer`	opcional	Tiempo tomado, la unidad es milisegundos
`costToken`	`integer / absent`	opcional	Cabeza de respuesta de puerta de entrada de producción `X-Cost-Token`; el script de entrada será copiado a este campo, y este campo está faltando actualmente al analizar el JSON cuerpo directamente.
`costCredit`	`integer / absent`	opcional	Cabeza de respuesta de puerta de entrada de producción `X-Cost-Credit`, que es la potencia de cálculo real deducido esta vez; el script de entrada será copiado a este campo
`sourceType`	`string`	opcional	`st`
`tree`	`array<object>`	opcional	Árbol de categorías completo; los elementos de array son nodos de categoría
`searchByName`	`array<object>`	opcional	Categorías relacionadas; máximo 3 elementos
`marketReport`	`array<object>`	opcional	Categoría producto resumen de la matriz; devolver la matriz directamente sin cubrir la `Products` capa
`Id`	`integer`	opcional	ID de categoría
`ParentId`	`integer`	opcional	Identificación de la categoría de padres; `0` representa el nivel superior
`NodeId`	`string`	opcional	ID del nodo de categoría de Walmart
`Name`	`string`	opcional	Nombre de la categoría inglesa
`CNName`	`string`	opcional	Nombre de la categoría china
`URL`	`string`	opcional	Categoría URL
`NodeId`	`string`	opcional	La ruta completa de categoría separada por subrayados puede ser utilizada directamente como `marketReport.nodePath`
`CategoryName`	`string`	opcional	Categoría de visualización
`Title`	`string`	opcional	Título del producto
`Photo`	`array<string>`	opcional	Imagen del producto URL matriz
`ListingSalesVolumeOfMonth`	`integer`	opcional	Volumen de ventas estimado en los últimos 30 días en la dimensión de la Lista, sin distinguir entre variantes
`ListingSalesOfMonth`	`integer`	opcional	Ventas estimadas en los últimos 30 días en la dimensión de la Lista; la unidad para el sitio de EE.UU. es de centavos
`ProductId`	`string`	opcional	Walmart ProductId
`ParentProductId`	`string`	opcional	Producto principal
`Price`	`integer`	opcional	Precio de venta; la unidad de sitio de EE.UU. es centavos, como `1999` significa `$19.99`
`Brand`	`string`	opcional	marca
`Seller`	`string`	opcional	Nombre del vendedor en el momento de la recogida
`Shipedby`	`string`	opcional	El método de entrega en el momento de la recogida; el nombre del campo es la ortografía original de la corriente
`WFSFee`	`integer`	opcional	Tasa WFS; unidad de sitio de EE.UU. es centavos
`Attribute`	`array<string> / null`	opcional	Atributos del producto, codificación interdejada según `[attribute name, attribute value, ...]`
`FirstReviewsDate`	`string / null`	opcional	Fecha del primer comentario en el formato `yyyy-MM-dd`
`ReviewsCount`	`integer`	opcional	Número de comentarios
`Ratings`	`number`	opcional	Calificación, como `4.8`
`NodePath`	`array<string\\|null>`	opcional	Los registros de categorías y rankings se agrupan y codifican de acuerdo con `[category name, NodeId, ranking date, ranking, ...]`; cuando falta el ranking en un determinado día, la posición correspondiente es `null`
`Label`	`array<string>`	opcional	Etiquetas de productos, como `pickup`, `savewith`, `bestsell`
`PopularPick`	`integer`	opcional	Etiqueta popular de selección; `1` indica existencia
`Clearance`	`integer`	opcional	Marca de limpieza; `1` indica existencia
`ReducedPrice`	`integer`	opcional	Precio reducido; `1` indica existencia
`Rollback`	`integer`	opcional	Token de retorno; `1` indica existencia
`FlashDeal`	`integer`	opcional	Etiqueta de acuerdo Flash; `1` indica existencia
`Size`	`array<string> / null`	opcional	Tamaño del envase exterior `[longest side, second longest side, shortest side]`, unidad es cm
`Weight`	`number`	opcional	Peso del producto en gramos
`Variants`	`array<object> / null`	opcional	Lista de variaciones, los campos se muestran en la tabla siguiente
`NumberOfStar`	`array<number\\|string> / null`	opcional	El número de comentarios para cada clasificación de estrellas, según `[star rating, number of reviews, ...]` codificación escalonada
`VariantId`	`string`	opcional	ID de producto de la variante (ProductId)
`Url`	`string`	opcional	Producto variante URL
`Property`	`array<string>`	opcional	Atributos variantes, codificados por `[attribute name, attribute value, ...]`
`PriceUpdate`	`string / null`	opcional	Tiempo de actualización del precio, generalmente `yyyy-MM-dd`
`DetailUpdate`	`string / null`	opcional	Tiempo de actualización de detalles, generalmente `yyyy-MM-dd`; cuando no hay fecha válida, los marcadores de posición ascendentes como `--` puede utilizarse

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_walmart_category_market",
    "arguments": {
      "operation": "tree"
    }
  }
}

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

/st/walmart/categoryMarket

Método de MCP

nexscope_walmart_category_market

Clave de API*

Contenido JSON*

cURL

curl -X POST \
  https://api.nexscope.ai/st/walmart/categoryMarket \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "operation": "tree" }'

Respuesta

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

API relacionadas

Walmart Keyword Research

Research Walmart keywords and the products associated with them.

Walmart Product Analysis

Analyze Walmart products, detail records, performance trends, and dated sales volume. Results come back as structured JSON.