技术实战：Mercari（煤炉）API商品详情接口技术解析与标准JSON返回参考
前言
在日本二手电商选品、中古商品价格监控、跨境二手货源分析的业务场景中，Mercari（煤炉）商品详情API是跨境从业者最核心的结构化数据入口。它无需搭建复杂的日本本地代理与反爬体系，就能稳定获取全维度的煤炉二手商品结构化信息，大幅降低中古选品、竞品监控类业务的开发门槛，是打通日本二手电商货源数据与自有跨境ERP系统的必备工具。
一、接口核心覆盖的数据范围
这套接口可以返回日本二手电商业务开发中几乎所有需要的Mercari商品核心字段，完全适配中古选品、价格监控、正品溯源等多种场景：
基础标识：商品唯一ID、商品日文标题、所属卖家ID、卖家昵称、商品上架时间、商品所属类目ID与类目路径
价格体系：当前售卖价、商品原价参考、运费承担方标识、平台手续费预估、支持的支付方式列表，所有价格数据支持分钟级更新
交易属性：商品浏览量、累计收藏数、评论数、商品成色等级（全新/近乎全新/轻微使用/明显使用痕迹）、是否支持议价
规格库存：商品当前库存状态、可选变体SKU列表、每个子变体的对应价格、商品尺寸/颜色等属性明细
素材资源：多尺寸主图数组、详情图列表、商品细节实拍图链接、商品360度展示图地址
附加信息：商品详细描述、品牌归属、发货地（日本都道府县）、预计发货时效、平台售后保障标识、是否支持匿名配送
二、最简接入操作步骤
结合之前1688、速卖通等跨境电商接口的开发经验，新手跟着3步就能快速完成适配调用：
选择合规的Mercari第三方数据服务平台（如Apify上的h4sh/mercari-scraper工具）注册开发者账号，申请商品详情查询接口权限，获取专属的API密钥（o0b.cn/anzexi）
按照平台规范生成合法请求头，携带认证密钥完成身份校验，无需额外配置复杂的日本本地账号登录流程
用HTTPS POST方式将请求提交到API网关，传入目标商品ID，即可直接返回标准JSON格式的结构化商品数据
三、可直接参考的标准成功返回JSON示例
这是脱敏后的标准返回结构，完全匹配主流Mercari商品详情API的原生返回格式，核心字段都标注了业务含义，可直接用于开发调试参考：
json{
"code": 0,
"msg": "success",
"request_id": "req_20260827102245789",
"data": {
"product_id": "m12345678901",
"title": "【中古 ほぼ未使用】ニューヨーク発 レザートートバッグ ブラック A4収納可",
"category_info": {
"category_id": 12345,
"category_path": "レディース > バッグ > トートバッグ"
},
"seller_info": {
"seller_id": "u987654321",
"seller_name": "中古雑貨ショップ",
"seller_rating": "4.9",
"total_sales": 1268,
"is_anonymous": true
},
"price_info": {
"current_price": "3500",
"currency": "JPY",
"original_price": "12000",
"shipping_fee_payer": "seller",
"platform_fee": "350",
"negotiation_allowed": true
},
"product_status": {
"condition_level": 2,
"condition_desc": "やや傷や汚れあり",
"is_on_sale": true,
"view_count": 2368,
"favorite_count": 189,
"comment_count": 12
},
"stock_info": {
"total_stock": 1,
"variations": [
{
"variation_id": "v123456",
"spec_text": "ブラック フリーサイズ",
"variation_price": "3500",
"variation_stock": 1
}
]
},
"image_info": {
"main_images": [
"https://static.mercdn.net/item/detail/orig/photos/m12345678901_1.jpg",
"https://static.mercdn.net/item/detail/orig/photos/m12345678901_2.jpg",
"https://static.mercdn.net/item/detail/orig/photos/m12345678901_3.jpg"
],
"detail_images": [
"https://static.mercdn.net/item/detail/orig/photos/m12345678901_4.jpg",
"https://static.mercdn.net/item/detail/orig/photos/m12345678901_5.jpg"
]
},
"product_attr": {
"brand_name": "無印良品",
"size_info": "高さ30cm 幅40cm マチ10cm",
"description": "数回使用しましたが、目立った傷や汚れはありません。A4サイズの書類が収納可能です。"
},
"logistics_info": {
"ship_from": "東京都",
"estimated_days": "1-2日",
"shipping_method": "らくらくメルカリ便"
},
"after_sale": {
"support_return": false,
"platform_guarantee": true
}