用途:按单个 Ozon(俄罗斯)SKU 查询完整商品详情卡,结果包含价格、Ozon Card 价格、折扣、评分、评论数、库存、月销量与销售额、损失利润、潜在收入、首次上架日期、图片等字段,可用于竞品商品卡审核与库存影响分析。
主要能力与参数:productId 必填,为单个 Ozon 商品 ID(整数或字符串),不支持 productIds 数组。startDate/endDate 定义统计窗口(YYYY-MM-DD),最晚可选日期为昨天(T-1),今天及未来日期会被拒绝。includeFbs=true 时允许纳入 FBS 及其指标,false 或省略则结果以 FBO 为主。商品卡还返回 deliveryScheme(FBO/FBS)、previousSalesUnits/previousRevenue(前一等长周期数据,便于环比)、revenuePotential 与 lostProfit/lostProfitPercent(衡量缺货影响)、salesPerDayWithStock 等有货天数口径指标。
使用方式:API 端点 /mpstats/ozon/productDetail;脚本 python scripts/ozon_product_detail.py '<JSON params>' [--inline]。默认将完整响应写入工作目录 nexscope/<日期>/<会话>/data/ 下 JSON 文件;响应体 ≤8 KB 时打印完整 JSON,>8 KB 时只打印摘要,可用 --inline 强制完整输出。需要鉴权:配置 NEXSCOPE_API_KEY 环境变量;401/402 或额度不足时可按资料提示前往 Nexscope 定价页充值。
适用场景:已有明确 SKU、需要价格/评分/库存/销量时使用;可与 ecommerce.ozon-product-search 串联(先搜索得到 ID 再逐个查询);单 SKU 逐日走势应改用 ecommerce.ozon-product-trend;品牌/类目/卖家维度应改用对应下钻技能。
限制:每次调用仅一个 SKU,且消耗额度,同会话同参数组合默认单次调用并本地缓存 24 小时,失败或空结果不应自动换参重试;仅覆盖 Ozon,不含 Wildberries 等平台;T-1 数据;部分类目 FBS 覆盖不全;不含 brandId、国家、类目、minPrice/maxPrice/averagePrice、balanceFbs、frozenStocks、warehousesCount、position 等字段;标题为俄语,不自动翻译;currency 为 RUB,不应擅自改写;不得在无更广泛分析时给出“值得卖”等业务建议。