首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >技术实战:Mercari(煤炉)API商品详情接口技术解析与标准JSON返回参考

技术实战:Mercari(煤炉)API商品详情接口技术解析与标准JSON返回参考

原创
作者头像
Anzexi58
发布2026-08-27 09:58:12
发布2026-08-27 09:58:12
780
举报
文章被收录于专栏:API接口开发API接口开发

前言

在日本二手电商选品、中古商品价格监控、跨境二手货源分析的业务场景中,Mercari(煤炉)商品详情API是跨境从业者最核心的结构化数据入口。它无需搭建复杂的日本本地代理与反爬体系,就能稳定获取全维度的煤炉二手商品结构化信息,大幅降低中古选品、竞品监控类业务的开发门槛,是打通日本二手电商货源数据与自有跨境ERP系统的必备工具。

一、接口核心覆盖的数据范围

这套接口可以返回日本二手电商业务开发中几乎所有需要的Mercari商品核心字段,完全适配中古选品、价格监控、正品溯源等多种场景:

  1. 基础标识:商品唯一ID、商品日文标题、所属卖家ID、卖家昵称、商品上架时间、商品所属类目ID与类目路径
  2. 价格体系:当前售卖价、商品原价参考、运费承担方标识、平台手续费预估、支持的支付方式列表,所有价格数据支持分钟级更新
  3. 交易属性:商品浏览量、累计收藏数、评论数、商品成色等级(全新/近乎全新/轻微使用/明显使用痕迹)、是否支持议价
  4. 规格库存:商品当前库存状态、可选变体SKU列表、每个子变体的对应价格、商品尺寸/颜色等属性明细
  5. 素材资源:多尺寸主图数组、详情图列表、商品细节实拍图链接、商品360度展示图地址
  6. 附加信息:商品详细描述、品牌归属、发货地(日本都道府县)、预计发货时效、平台售后保障标识、是否支持匿名配送

二、最简接入操作步骤

结合之前1688、速卖通等跨境电商接口的开发经验,新手跟着3步就能快速完成适配调用:

  1. 选择合规的Mercari第三方数据服务平台(如Apify上的h4sh/mercari-scraper工具)注册开发者账号,申请商品详情查询接口权限,获取专属的API密钥(o0b.cn/anzexi)
  2. 按照平台规范生成合法请求头,携带认证密钥完成身份校验,无需额外配置复杂的日本本地账号登录流程
  3. 用HTTPS POST方式将请求提交到API网关,传入目标商品ID,即可直接返回标准JSON格式的结构化商品数据

三、可直接参考的标准成功返回JSON示例

这是脱敏后的标准返回结构,完全匹配主流Mercari商品详情API的原生返回格式,核心字段都标注了业务含义,可直接用于开发调试参考:

代码语言:javascript
复制
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
    }

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 前言
    • 一、接口核心覆盖的数据范围
    • 二、最简接入操作步骤
    • 三、可直接参考的标准成功返回JSON示例
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档