接口标识: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变体对应图片地址,防盗链