Nexscope

API de búsqueda de informes de productos de Ozon

Filtra productos de Ozon por métricas de ventas, ingresos, crecimiento, conversión, precio, valoraciones, margen, devoluciones, anuncios, vendedor y logística. Invoca la API mediante REST o MCP.

CosteRecent Avg. 32 · Range 13–32 credits / call
Probar en línea
POST · https://api.nexscope.ai/sr/ozon/productReportSearchMCP · nexscope_ozon_product_report_search

Qué hace esta API

Filtrar los productos Ozon por ventas, ingresos, crecimiento, conversión, precio, calificaciones, margen, devoluciones, anuncios, ventas y métricas de cumplimiento.

Casos de uso de API de búsqueda de informes de productos de Ozon

Buscar productos que coincidan con un resumen de abastecimiento

Para encontrar productos que coincidan con un informe de búsqueda, un analista de mercado envía página y página a Ozon Informe de Producto Buscar. El errcode devuelto, errmsg, productos ayudan a identificar productos que coincidan con los criterios de búsqueda solicitados.

Comparar una lista de búsqueda de productos

Un analista de mercado utiliza Ozon Product Report Search con page.page y page.page para comparar una lista de búsqueda de productos. El errcode, errmsg, productos devueltos ayudan a comparar candidatos antes de solicitar detalles individuales del producto.

Reunir a los candidatos para una revisión del mercado

Para este flujo de trabajo, un analista de mercado llama a Ozon Informe de Producto Search con página y página.page para recoger candidatos para una revisión de mercado.El resultado ayuda a elegir productos para un proveedor o la revisión de competidor.

Preguntas frecuentes sobre API de búsqueda de informes de productos de Ozon

¿Qué busca el informe de productos Ozon? API ¿Volver?

Filtrar los productos de Ozon por ventas, ingresos, crecimiento, conversión, precio, calificaciones, margen, devoluciones, anuncios, ventas y métricas de cumplimiento. `errcode`, `errmsg`, `products`, `sku`, `productId`, `title`, `imageUrl`, `productUrl`. Corresponde a los parámetros proporcionados `page`, `page.page`, `page.pageSize`, `page.orders`, `skus`. 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 Informe de Producto de Ozon? API ¿costo?

El coste documentado actualmente es Recent Avg. 32 · Range 13–32 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 a la búsqueda del informe de producto Ozon? API desde mi aplicación o un MCP ¿Cliente?

Enviar a POST solicitud a /sr/ozon/productReportSearch 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_product_report_search. 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

Prueba esta API
Endpoint
https://api.nexscope.ai/sr/ozon/productReportSearch
Método MCP
nexscope_ozon_product_report_search

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/sr/ozon/productReportSearch

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/sr/ozon/productReportSearch' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "page": {
    "orders": [
      {
        "direction": "DESC",
        "field": "sales"
      }
    ],
    "page": 1,
    "pageSize": 3
  }
}'

Ejemplo de código

{
  "page": {
    "orders": [
      {
        "direction": "DESC",
        "field": "sales"
      }
    ],
    "page": 1,
    "pageSize": 3
  }
}

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 una clave API ausente o no válida (code 11209, incluida una copia incompleta o dañada) o una sesión web caducada (code 12001), 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 SR

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_product_report_search",
    "arguments": {
      "page": {
        "page": 1,
        "pageSize": 20
      },
      "skus": [
        1664362124
      ]
    }
  }
}

¿Qué puedes hacer con esta API?

Datos explicados y casos de uso prácticos

AI Guide

Question

What data can Ozon Product Report Search provide, and how might I use it?

AI answer

This API returns a filterable, sortable report of Ozon products. You can look up specific SKUs or compare products by sales, price, conversion, advertising, and seller characteristics. The reported period is a rolling last 30 days when searchDate is omitted; a supplied date selects the preceding complete historical month.

Data categoryDocumented fieldsWhat the values mean
Product identitysku, productId, title, productUrl, imageUrlOzon product identifiers, the original Russian title, and links for checking the listing.
Sales and revenuesales, revenue, missedRevenue, salesRate, revenueRateMonthly units and ruble sales, reported lost sales, and growth rates.
Price and conversionprice, convToCartPdp, orderConversionRate, viewsRuble price, cart and order conversion percentages, and views.
Advertising and margindrr, grossMarginAdvertising cost share and gross margin; drr is documented as a ratio, while margin is a percentage.
Customer responsereviewRating, reviewCount, questionsAndAnswers, returnCancellationRateRating, review and Q&A counts, and return/cancellation percentage.
Seller and assortmentbrandName, sellerName, sellerId, variants, fulfillment, categoryInfoBrand and seller identity, variant count, delivery methods, and category information.
  • Filter a category by monthlySales and monthlySalesRate to find products with substantial, growing unit sales.
    • Prompt example: “I am researching products on Ozon. Could you filter a category by monthlySales and monthlySalesRate to find products with substantial, growing unit sales? Show matching records and source links where the API provides them; ask me for any required identifier or filter.”
  • Compare similarly priced products using convToCartPdp, orderConversionRate, and views to investigate listing performance.
    • Prompt example: “I am researching products on Ozon. Could you compare similarly priced products using convToCartPdp, orderConversionRate, and views to investigate listing performance? Show the returned values behind the comparison, and mark missing data.”
  • Screen products by drr, grossMargin, and returnCancellationRate when assessing reported economics and post-sale friction.
    • Prompt example: “I am researching products on Ozon. Could you screen products by drr, grossMargin, and returnCancellationRate when assessing reported economics and post-sale friction? Show the relevant returned evidence and tell me what input you need from me.”
  • Look up up to 10 known skus to compare their sales, ratings, sellers, and fulfillment methods.
    • Prompt example: “I am researching products on Ozon. Could you look up up to 10 known skus to compare their sales, ratings, sellers, and fulfillment methods? Show the returned values behind the comparison, and mark missing data.”

Ejemplo de datos

Ejemplo de solicitud y respuesta

Parámetros de solicitud

{
  "page": {
    "page": 2,
    "pageSize": 20,
    "orders": [
      {
        "field": "sales",
        "direction": "DESC"
      }
    ]
  },
  "categoryIds": [
    "17027486_17039638_91891"
  ],
  "variationsMerge": 0,
  "monthlySales": {
    "min": 500,
    "max": 900
  }
}

Respuesta

{
  "code": 0,
  "msg": null,
  "data": {
    "total": 13,
    "data": [],
    "costTime": 1181,
    "columns": [
      {
        "filterable": true,
        "cellType": "number",
        "field": "sku",
        "sortable": true,
        "title": "商品SKU"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "title",
        "sortable": true,
        "title": "商品标题"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "productUrl",
        "sortable": true,
        "title": "商品链接"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "brandId",
        "sortable": true,
        "title": "品牌ID"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "brandName",
        "sortable": true,
        "title": "品牌名称"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "brandUrl",
        "sortable": true,
        "title": "品牌链接"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "imageUrl",
        "sortable": true,
        "title": "商品图片链接"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "sellerId",
        "sortable": true,
        "title": "卖家ID"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "sellerName",
        "sortable": true,
        "title": "卖家名称"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "fulfillment",
        "sortable": true,
        "title": "配送方式"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "weight",
        "sortable": true,
        "title": "重量,单位g"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "questionsAndAnswers",
        "sortable": true,
        "title": "QA数量"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "upTime",
        "sortable": true,
        "title": "上架时间戳,毫秒"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "upDays",
        "sortable": true,
        "title": "上架天数"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "upMonths",
        "sortable": true,
        "title": "上架月数"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "price",
        "sortable": true,
        "title": "价格,单位卢布"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "grossMargin",
        "sortable": true,
        "title": "毛利率"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "reviewCount",
        "sortable": true,
        "title": "评论数"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "reviewRating",
        "sortable": true,
        "title": "评分"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "sales",
        "sortable": true,
        "title": "销量"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "salesRate",
        "sortable": true,
        "title": "销量增长率"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "revenue",
        "sortable": true,
        "title": "销售额"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "revenueRate",
        "sortable": true,
        "title": "销售额增长率"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "categoryInfo",
        "sortable": true,
        "title": "类目信息"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "views",
        "sortable": true,
        "title": "浏览量"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "convToCartPdp",
        "sortable": true,
        "title": "购物车转化率"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "orderConversionRate",
        "sortable": true,
        "title": "下单转化率"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "drr",
        "sortable": true,
        "title": "广告费用份额"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "returnCancellationRate",
        "sortable": true,
        "title": "退货取消率"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "missedRevenue",
        "sortable": true,
        "title": "损失销售额"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "variants",
        "sortable": true,
        "title": "变体数"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "volume",
        "sortable": true,
        "title": "体积,单位L"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "productId",
        "sortable": true,
        "title": "统一商品ID"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "productPageUrl",
        "sortable": true,
        "title": "统一商品页URL"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "brand",
        "sortable": true,
        "title": "统一品牌"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "rating",
        "sortable": true,
        "title": "统一评分"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "monthlySalesUnits",
        "sortable": true,
        "title": "统一月销量"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "monthlySalesRevenue",
        "sortable": true,
        "title": "统一月销售额"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "sourceType",
        "sortable": true,
        "title": "数据源"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "sourceTool",
        "sortable": true,
        "title": "来源工具"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "currency",
        "sortable": true,
        "title": "币种"
      }
    ],
    "type": "productWorkbenches",
    "products": []
  }
}

API relacionadas