Nexscope

API de productos por vendedor de Ozon

Enumera los SKU de un vendedor de Ozon con métricas de ventas, ingresos, precio, valoración, existencias, rotación e ingresos perdidos para analizar competidores. Invoca la API mediante REST o MCP.

Coste17 créditos / llamada
Probar en línea
POST · https://api.nexscope.ai/mp/ozon/sellerProductsMCP · nexscope_ozon_seller_products

Qué hace esta API

Listar un SKU del vendedor de Ozon con ventas, ingresos, precio, calificación, stock, volumen de negocios, y pérdidas de ingresos métricas para el análisis de la competencia.

Casos de uso de API de productos por vendedor de Ozon

Investigar a un vendedor o tienda

Para investigar un vendedor o tienda, un analista de mercado presenta sellerId y startDate a Ozon Seller Products. Los productos devueltos, productId, el título ayuda a identificar la tienda asociada con un producto candidato.

Comparar evidencia de producto de la tienda

Un analista de mercado utiliza productos vendedores de Ozon con sellerId y startDate comparar las pruebas de los productos de la tienda. productId, el título ayuda a comparar productos o listados en los escaparates preseleccionados.

Tiendas de listas cortas para investigaciones ulteriores

Para este flujo de trabajo, un analista de mercado llama a los productos vendedores de Ozon con sellerId y startDate El resultado ayuda a elegir tiendas para un proveedor o un competidor.

Preguntas frecuentes sobre API de productos por vendedor de Ozon

¿Qué hacen los productos vendedores de Ozon API ¿Volver?

Listar un SKU del vendedor de Ozon con ventas, ingresos, precio, calificación, stock, volumen de negocios, y pérdidas de ingresos métricas para el análisis de la competencia. `products`, `productId`, `title`, `brand`, `brandId`, `sellerName`, `sellerId`, `category`. Corresponde a los parámetros proporcionados `sellerId`, `startDate`, `endDate`, `page`, `pageSize`. 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 los Productos Vendedores Ozon API ¿costo?

El coste documentado actualmente es 17 créditos / llamada. 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 a los productos vendedores de Ozon API desde mi aplicación o un MCP ¿Cliente?

Enviar a POST solicitud a /mp/ozon/sellerProducts 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_ozon_seller_products. 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éditosConecta esta API con MCP (en inglés)

Prueba esta API
Endpoint
https://api.nexscope.ai/mp/ozon/sellerProducts
Método MCP
nexscope_ozon_seller_products

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/mp/ozon/sellerProducts

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/mp/ozon/sellerProducts' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "pageSize": 100,
  "sellerId": "3628678",
  "sortDirection": "desc",
  "sortField": "revenue"
}'

Ejemplo de código

{
  "pageSize": 100,
  "sellerId": "3628678",
  "sortDirection": "desc",
  "sortField": "revenue"
}

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/ Inteligencia de Ozon MP
POSThttps://api.nexscope.ai/mp/ozon/sellerProducts

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/mp/ozon/sellerProducts
AutenticaciónBearer API key
Content-Typeapplication/json

Parámetros de la solicitud

NombreTipoObligatorioDescripción
sellerIdstringobligatorio
ID del vendedor de Ozon (cadena numérica), consistente con el ID del vendedor en la lista de productos/lista de vendedores
startDatestringopcional
Fecha de inicio de las estadísticas `YYYY-MM-DD`; último ayer
endDatestringopcional
Fecha de finalización de las estadísticas `YYYY-MM-DD`; último ayer
pageintegeropcional
Número de página, a partir de 1
pageSizeintegeropcional
Número de líneas por página, 1-100
Ejemplo: 100
sortFieldstringopcional
Nombre de la columna de clasificación (snake_case), como por ejemplo `sales`, `revenue`, `final_price`, `balance`, `rating`
sortDirectionstringopcional
`asc` / `desc`
currencystringopcional
Código de moneda, como `USD`
Ejemplo: RUB
currencyRateintegeropcional
Tipo de cambio personalizado (con moneda no predeterminada)
includeFbsbooleanopcional
Indica si se deben incluir datos de FBS
filtersarrayopcional
Lista numérica de filtros, cada elemento es `{field, op, value, value2?}`, multicondición Y

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

NombreTipoObligatorioDescripción
codestringopcional
Código de retorno, `"200"` éxito
msgstringopcional
Mensaje; el éxito es `ok`
totalintegeropcional
Número total de visitas del vendedor
productsarrayopcional
Lista de productos
columnsarrayopcional
Definición de la columna de render
costTimeintegeropcional
Tiempo de interfaz (millisegundos)
costTokenintegeropcional
Cantidad de token consumido
typestringopcional
tipo de respuesta
productIdintegeropcional
SKU ID
titlestringopcional
Nombre del producto (ruso)
brandstringopcional
marca
brandIdintegeropcional
ID de marca
sellerNamestringopcional
Nombre del vendedor
sellerIdintegeropcional
ID del vendedor
categorystringopcional
Categoría ruta (ruso, `/` separados)
nicheNamestringopcional
Ruta de pista (ruso)
nicheIdintegeropcional
ID de pista
countrystringopcional
País de venta, Ozon Hengwei `RU`
firstDatestringopcional
Fecha de lanzamiento (`yyyy-MM-dd`)
imageUrlstringopcional
Imagen principal URL
productPageUrlstringopcional
Página del producto URL
pricenumberopcional
Precio de venta actual
oldPricenumberopcional
Precio original antes del descuento
ozonCardPricenumberopcional
Precio de la tarjeta Ozon
currencystringopcional
Signatura de la moneda (`₽` / `$` / `€`)
ratingnumberopcional
Calificación, 0-5
reviewCountintegeropcional
Número de comentarios
balanceintegeropcional
Inventario actual (piezas)
balanceFbsintegeropcional
Inventario de FBS (número de artículos enviados por el vendedor)
frozenStocksintegeropcional
Inventario de movimientos lentos
warehousesCountintegeropcional
Número de posiciones de FBO
isFbsbooleanopcional
Si se debe enviar por FBS
salesPerDaynumberopcional
Volumen medio de ventas diarias (piezas/día)
monthlySalesUnitsintegeropcional
Volumen de ventas durante el período estadístico (piezas)
monthlySalesRevenuenumberopcional
Ventas durante el período estadístico
lostProfitnumberopcional
Ventas perdidas (causadas por existencias, etc.)
daysInSiteintegeropcional
Número de días de venta (período estadístico, incluidos los días de venta)
daysInStockintegeropcional
días en stock
turnoverDaysnumberopcional
Días de vuelta (el más pequeño, el más rápido)
positionintegeropcional
Ranking dentro de la dimensión de consulta actual (este punto final es el vendedor)
categoryPositionintegeropcional
Clasificación dentro de la categoría
revenueSharePercentnumberopcional
La relación de ventas de este SKU en la dimensión actual de la consulta, 0-100

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_ozon_seller_products",
    "arguments": {
      "currencyRate": 1,
      "endDate": "2026-01-31",
      "page": 1,
      "pageSize": 100,
      "sellerId": "1581151",
      "startDate": "2026-01-01"
    }
  }
}

Ejemplo de datos

Parámetros de solicitud

{
  "sellerId": "985891",
  "page": 1,
  "pageSize": 1,
  "currency": "RUB"
}

Respuesta

{
  "code": 0,
  "msg": null,
  "data": {
    "total": 1,
    "costTime": 3349,
    "columns": [
      {
        "filterable": true,
        "cellType": "number",
        "field": "productId",
        "sortable": true,
        "title": "SKU ID"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "title",
        "sortable": true,
        "title": "商品名称"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "productPageUrl",
        "sortable": true,
        "title": "商品页URL"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "imageUrl",
        "sortable": true,
        "title": "主图URL"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "brand",
        "sortable": true,
        "title": "品牌"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "brandId",
        "sortable": true,
        "title": "品牌ID"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "sellerName",
        "sortable": true,
        "title": "卖家"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "sellerId",
        "sortable": true,
        "title": "卖家ID"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "category",
        "sortable": true,
        "title": "品类路径"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "categoryPosition",
        "sortable": true,
        "title": "品类排名"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "nicheId",
        "sortable": true,
        "title": "赛道ID"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "nicheName",
        "sortable": true,
        "title": "赛道路径"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "currency",
        "sortable": true,
        "title": "币种符号"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "price",
        "sortable": true,
        "title": "当前售价"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "averagePrice",
        "sortable": true,
        "title": "均价"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "minPrice",
        "sortable": true,
        "title": "最低价"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "maxPrice",
        "sortable": true,
        "title": "最高价"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "ozonCardPrice",
        "sortable": true,
        "title": "Ozon Card 价"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "oldPrice",
        "sortable": true,
        "title": "原价"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "rating",
        "sortable": true,
        "title": "评分"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "reviewCount",
        "sortable": true,
        "title": "评论数"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "monthlySalesUnits",
        "sortable": true,
        "title": "销量"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "salesPerDay",
        "sortable": true,
        "title": "日均销量"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "monthlySalesRevenue",
        "sortable": true,
        "title": "销售额"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "lostProfit",
        "sortable": true,
        "title": "损失销售额"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "revenueSharePercent",
        "sortable": true,
        "title": "营收占比"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "balance",
        "sortable": true,
        "title": "库存"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "balanceFbs",
        "sortable": true,
        "title": "FBS库存"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "daysInStock",
        "sortable": true,
        "title": "有货天数"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "daysInSite",
        "sortable": true,
        "title": "在售天数"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "turnoverDays",
        "sortable": true,
        "title": "周转天数"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "frozenStocks",
        "sortable": true,
        "title": "滞销库存"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "warehousesCount",
        "sortable": true,
        "title": "分仓数"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "isFbs",
        "sortable": true,
        "title": "是否FBS仓发货"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "firstDate",
        "sortable": true,
        "title": "上架日期"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "country",
        "sortable": true,
        "title": "销售国"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "position",
        "sortable": true,
        "title": "排名"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "sourceType",
        "sortable": true,
        "title": "数据源"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "sourceTool",
        "sortable": true,
        "title": "来源工具"
      }
    ],
    "type": "productWorkbenches",
    "products": [
      {
        "daysInSite": 9,
        "warehousesCount": 0,
        "sellerName": "ART LITE",
        "nicheName": "Строительство и ремонт/Водоснабжение/Водоочистка и фильтры/Умягчители воды",
        "rating": 0,
        "title": "Соль таблетированная для водоподготовки и умягчения воды 25 кг Уцененный товар",
        "frozenStocks": 0,
        "productPageUrl": "https://www.ozon.ru/context/detail/id/5932831435/",
        "salesPerDay": 0.03,
        "isFbs": false,
        "sellerId": 985891,
        "sourceTool": "MPSTATS-Ozon商品列表",
        "balance": 0,
        "reviewCount": 0,
        "price": 1746,
        "imageUrl": "https://ir.ozone.ru/s3/multimedia-1-3/d100/9839676423.jpg",
        "daysInStock": 1,
        "firstDate": "2026-10-01",
        "currency": "₽",
        "ozonCardPrice": 1571,
        "brand": "ТУЛЬСКАЯ СОЛЬ",
        "categoryPosition": 0,
        "revenueSharePercent": 100,
        "productId": "5932831435",
        "oldPrice": 7000,
        "balanceFbs": 0,
        "lostProfit": 50634,
        "turnoverDays": 0,
        "monthlySalesRevenue": 1746,
        "sourceType": "ozon",
        "minPrice": 1549,
        "averagePrice": 1746,
        "maxPrice": 2565,
        "category": "",
        "nicheId": 33051,
        "monthlySalesUnits": 1
      }
    ]
  }
}

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.

17 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
/mp/ozon/sellerProducts
Método de MCP
nexscope_ozon_seller_products
cURL
curl -X POST \
  https://api.nexscope.ai/mp/ozon/sellerProducts \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "pageSize": 100, "sellerId": "3628678", "sortDirection": "desc", "sortField": "revenue" }'
Respuesta
Todavía no hay respuesta. Ejecuta la solicitud para ver la respuesta aquí.

API relacionadas