美客多商品详情 API 返回值说明(标准开发手册)

接口标识:mercadolibre.item_get业务用途:拉美跨境 ERP、竞品监控、选品分析、素材采集、批量刊登预处理;入参:item_id商品编码、site站点编码(MLM 墨西哥 / MLB 巴西 / MLA 阿根廷 / MLC 智利),公共鉴权 key/secret;返回完整商品结构化数据,支持美客多全主流站点。

接口基础信息

接口标识:mercadolibre.item_get(美客多商品详情 API,taobaoapi2014前往体验)

请求方式:GET / POST

主要入参:asin商品 ASIN 编码,公共鉴权参数

返回内容:商品基础标题、价格体系、图片集合、五点描述、长描述、类目路径、品牌、属性参数、评分、销量参考、库存状态、发货方式、变体 SKU 集合。

适用场景:跨境 ERP 商品同步、竞品价格监控、选品数据分析、跨平台铺货、商品情报采集。

一、顶层响应结构

字段类型说明

codeint200 成功;400 参数错误;403 鉴权拒绝;429 接口限流;500 服务异常

msgstring返回提示文本,success代表正常返回数据

request_idstring请求唯一 ID,排查线上问题必备

dataobject商品业务主体对象

二、data 主体核心字段

字段类型说明

item_idstring商品唯一 ID,业务主键

sitestring站点编码 MLM / MLB / MLA / MLC

titlestring商品标题,当地语言(西班牙语 / 葡萄牙语)

brandstring品牌名称,无品牌返回空字符串

main_imagestring主图 CDN 地址,存在防盗链,不可直接外链使用

imagesarray[string]全部商品图片 URL 数组

video_urlstring商品视频地址,无视频返回空字符串

pricestring前台展示售卖价格(站点本地货币)

original_pricestring划线原价,无原价为空

promotion_pricestring限时促销价,无促销为空

currencystring货币编码 MXN 墨西哥比索 / BRL 雷亚尔 / ARS 比索 / CLP 比索

descriptionstring商品长描述,原始 HTML 文本

category_patharray[string]类目层级路径数组

category_idstring商品类目 ID,刊登类目映射参考

attributesarray[object]商品规格参数集合[{"name":"颜色","value":"Negro"}]

ratingstring商品平均评分

review_countint评论总数量

available_quantityint参考库存,区间映射值,非真实精确库存Mercado Li...

sold_quantityint历史累计销量

fulfillment_typestring履约模式FULL美客多海外仓 /FBM卖家自发货

statusstring商品状态active正常售卖 /paused暂停 /closed下架

permalinkstring商品详情网页链接

seller_infoobject卖家信息子对象

variantsarray[object]变体 SKU 数组,变体商品核心数据来源

seller_info 卖家子对象字段

字段类型说明

seller_idstring卖家店铺 ID

seller_namestring店铺名称

三、variants [] 变体子项字段(开发重点)

外层 price 仅页面展示;变体商品真实价格、库存、规格全部在此数组,刊登、监控必须遍历该数组。

字段类型说明

variant_idstring变体唯一编号

spec_textstring规格文本,颜色、尺寸等组合描述

pricestring该变体独立售价

available_quantityint变体参考库存,依旧为区间参考值Mercado Li...

pic_urlstring变体对应图片地址,防盗链

©著作权归作者所有,转载或内容合作请联系作者
【社区内容提示】社区部分内容疑似由AI辅助生成,浏览时请结合常识与多方信息审慎甄别。
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

友情链接更多精彩内容