POST
https://api.nexscope.ai/st/walmart/keywordResearchEjecutar 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/st/walmart/keywordResearch |
| 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 (73 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; los resultados reales de las actividades se encuentran en `data.value` |
operation | string | opcional | La operación real realizada 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`, 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` |
marketQuery | array<object> | opcional | Lista resumida de palabras clave |
searchByName | array<object> | opcional | Lista resumida de palabras clave relacionadas con el nombre del producto o de la categoría |
searchProducts | array<object> | opcional | Resumen de productos en los resultados de búsqueda de la palabra clave en los últimos 15 días |
detail | object | opcional | Objeto de resumen de una sola palabra clave |
productKeywords | array<object> | opcional | Registros de las palabras clave que el producto ha sido expuesto en las primeras tres páginas de resultados de búsqueda en los últimos 30 días |
relatedKeywords | array<object> | opcional | Palabras clave relacionadas matriz de resumen |
favoriteAdd | integer | opcional | Código de resultado favorito |
favoriteChange | integer | opcional | Eliminar o mover códigos de resultado |
favoriteList | array<string> | opcional | Array de palabras clave o nombres de directorio, el contenido específico está determinado por `command` |
Keyword | string | opcional | palabras clave |
KeywordCNName | string | opcional | Palabra clave Nombre chino |
Images | array<string> | opcional | Palabras clave resultados de la búsqueda Top 10 imagen del producto URL |
Update | string | opcional | Palabra clave última actualización de tiempo, por lo general `yyyyMMdd` |
Rank | integer | opcional | Clasificación de búsquedas semanales |
SearchVolume | number | opcional | Últimos 30 días volumen de búsqueda; puede ser transmitido por aguas arriba como un JSON número con decimales |
ProductCount | integer | opcional | Número de productos competidores que se muestran en la página de búsqueda de Walmart |
SearchFirstPageAvgPrice | integer | opcional | El precio medio de los productos naturales en la primera página de los resultados de búsqueda; la unidad en el sitio de EE.UU. es de centavos |
SearchFirstPageAvgReviews | number | opcional | Número medio de comentarios para productos naturales en la primera página de resultados de búsqueda |
SearchFirstPageAvgStar | number | opcional | Calificación media de productos naturales en la primera página de los resultados de la búsqueda |
ShowShare | number | opcional | La proporción de tráfico de exposición esta palabra clave trae al producto |
RecentlyPosition | string | opcional | La posición más reciente expuesta, como `1,2/18` significa página 1, posición 2, 18 puestos en total |
OrganicPosition | string | opcional | La posición natural de exposición más reciente, la codificación es la misma que `RecentlyPosition` |
AdPosition | string | opcional | La posición de exposición más reciente, codificada como `RecentlyPosition` |
Keyword | object | opcional | Objeto resumen de palabras clave completa; vea "Campo resumen de palabras clave" para campos |
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 |
operation | `data.value` | opcional | Descripción |
favoriteAdd | `0` | opcional | Colección exitosa |
favoriteAdd | `1` | opcional | Palabra clave ya existe |
favoriteAdd | `9` | opcional | Falló la recogida |
favoriteChange | `0` | opcional | Eliminar o mover correctamente |
favoriteChange | `9` | opcional | La palabra clave no existe |
favoriteList | array<string> | opcional | `dict` devuelve el nombre del directorio; `all` o `dict=<directory>` devuelve la palabra clave |
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.