https://api.nexscope.ai/sr/ozon/keywordBackSearchEjecutar 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/sr/ozon/keywordBackSearch |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
skuIds | integer[] | obligatorio | Compruebe la casilla SKU lista, hasta 20. |
hasVariant | integer | obligatorio | Si se deben eliminar variantes: `0` no se elimina, `1` se elimina. |
page | object | obligatorio | Llamado y clasificación: `{page, pageSize, orders[]}`. |
page.page | integer | opcional | Número de página, a partir de la 1. Ejemplo: 1 |
page.pageSize | integer | opcional | Número de artículos por página. Ejemplo: 20 |
page.orders | array | opcional | Regla de clasificación, el elemento es `{field, direction}`; `direction` toma `DESC` o `ASC`. |
matchType | integer | opcional | Modo de coincidencia de palabras clave: `0` precisa, `1` Fuzzy. |
type | string[] | opcional | Tipo de término de búsqueda: `0` término de búsqueda natural, `1` término de búsqueda de publicidad. |
historyDate | string | opcional | Mes histórico, formato `yyyy-MM`, como `2026-02`. |
includeKeywords | string[] | opcional | Contiene una variedad de palabras clave, hasta 1000. |
excludeKeywords | string[] | opcional | Array de palabras clave excluidas, hasta 1000. |
searchVolume | object | opcional | Rango de popularidad de búsqueda mensual. |
searchChange30 | object | opcional | Rango de búsqueda de 30 días. |
wordCount | object | opcional | Palabra clave rango de palabras. |
productViews | object | opcional | Gama de vistas del producto. |
products | object | opcional | Número de producto. |
sellers | object | opcional | Número de vendedores gama. |
marketSpace | object | opcional | Ámbito de aplicación del mercado. |
conversionSharing | object | opcional | Rango de concentración de conversión. |
uniqQueriesWCa | object | opcional | La gama de compras adicionales. |
ca | object | opcional | Rango de tasa de conversión adicional. |
conversion | object | opcional | Rango de tasa de conversión. |
titleDensity | object | opcional | Rango de densidad del título. |
adRivalCount | object | opcional | La gama del número de productos publicitarios que compiten. |
adRank | object | opcional | Rango de rango de anuncios. |
naturalRank | object | opcional | Rango natural de clasificación. |
exposure | object | opcional | rango de exposición. |
uId | string | opcional | Identificación del usuario. |
memberId | string | opcional | ID de miembro; los datos se atribuyen a este miembro. |
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 (50 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
code | string | opcional | Código de retorno, `"200"` indica éxito; devuelto cuando tiene éxito. |
errcode | integer | opcional | Código de error, `200` indica éxito; sólo este campo puede ser devuelto cuando hay un error de negocio. |
msg | string | opcional | Mensaje; éxito fue `ok`. |
errmsg | string | opcional | Mensaje de error; el éxito es `ok`, error de negocio es una descripción de la razón. |
total | integer | opcional | Número total de registros. |
data | array | opcional | Datos de la consulta inversa de palabras clave, campos de elementos se muestran en la tabla de abajo. |
columns | array | opcional | Definición de la columna, elementos que contienen `field`, `title`, `cellType`, `sortable`, `filterable`. |
costTime | integer | opcional | La interfaz consume tiempo en milisegundos. |
costToken | integer | opcional | El número de fichas consumidas. |
type | string | opcional | Tipo de pantalla de respuesta, como `tableListWorkbenches`. |
query | string | opcional | Palabras clave, texto original en ruso. |
queryCn | string | opcional | Palabras clave Traducción al chino. |
platform | integer | opcional | Plataforma: `0` Ozon, `1` Bayas silvestres. |
searchVolume | integer | opcional | Popularidad de búsqueda mensual. |
count30GrowthRate | number | opcional | El crecimiento de la búsqueda mensual, porcentaje, puede ser negativo. |
productCount | integer | opcional | Número de artículos, algunas filas pueden faltar. |
competingProducts | integer | opcional | Número de productos competidores. |
sellers | integer | opcional | Número de vendedores. |
avgPrice | number | opcional | Precio medio. |
itemsViews | number | opcional | Visibilidad del producto. |
viewSharing | number | opcional | Buscar concentración, porcentaje. |
conversionSharing | number | opcional | Concentración de conversión, porcentaje. |
marketSpace | number | opcional | espacio de mercado. |
returnCancellationRate | number | opcional | Tasa de cancelación de devolución, porcentaje. |
uniqQueriesWCa | integer | opcional | Número de compras adicionales. |
ca | number | opcional | Tasa de conversión de la adición a la compra, porcentaje. |
titleDensity | number | opcional | Título Densidad. |
wordCount | integer | opcional | Conteo de palabras. |
categories | array | opcional | Conjunto de documentos de identidad de categoría. |
dimension | object | opcional | Compruebe de nuevo los indicadores de dimensión exclusiva. La estructura se muestra en la tabla a continuación. |
products | array | opcional | Los datos de productos superiores, los campos de elementos se muestran en la tabla siguiente. |
id | string | opcional | Identificación de la grabación. |
type | integer | opcional | Canales de términos de búsqueda: `0` término de búsqueda natural, `1` término de búsqueda de publicidad. |
naturalRank | integer | opcional | Compruebe el ranking natural de la SKU bajo este término. |
exposure | number | opcional | Exposición, rango 0–1. |
conversion | number | opcional | Tasa de conversión, rango 0–1. |
x | array | opcional | Indicación de posición/paginación, semánticamente opaca. |
ozonId | integer | opcional | Identificación del producto Ozon. |
sku | integer | opcional | SKU ID. |
title | string | opcional | Título del producto, ruso. |
imageUrl | string | opcional | Imagen principal URL. |
advert | integer | opcional | Publicidad logo: `0` / `1`. |
titleCn | string | opcional | Categoría Nombre chino. |
titleEn | string | opcional | Categoría Nombre inglés. |
titleRu | string | opcional | Categoría Nombre ruso. |
cnTitlePath | string | opcional | Ruta de categoría china. |
enTitlePath | string | opcional | Ruta de la categoría inglesa. |
titlePath | string | opcional | Ruta de categoría rusa. |
id | string | opcional | Identificación de categoría. |
crossBorderSellable | boolean | opcional | Si puede venderse a través de las fronteras. |
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.