一、业务背景
跨境选品采集的核心痛点：需要从淘宝、天猫货源拿到标准化的标题、主图、SKU 规格、价格、库存、属性、运费、销量等数据，清洗后映射到海外平台刊登。 很多团队直接写爬虫，容易被风控、封 IP、图片防盗链；而官方商品详情 API（taobao.item.get）是合规稳定的数据源，按需拉取 fields 字段，只采集选品真正需要的数据，减少流量与解析压力 Aliba...。 本文重点站在跨境选品视角，梳理入参、返回结构、字段取舍、数据清洗要点。
二、接口基础信息
接口名称：taobao.item.get（淘宝开放平台商品详情接口,Taobaoapi2014 前往体验）
请求地址：c0b.cc/R4rbK2
适用场景：根据商品数字 ID（num_iid）查询单品详情
三、请求参数解读（跨境选品重点）
参数是否必填说明跨境选品使用建议
appkey是应用密钥开放平台创建应用获取
timestamp是时间戳 GMT+8签名校验，误差不能超过 10 分钟
sign是请求签名重点，签名错误直接返回 400，批量采集最容易踩坑
v是协议版本，固定 2.0固定写死
format否xml / json推荐 json，方便程序解析
num_iid是商品数字 ID从搜索接口拿到的商品 id，单次请求只支持单个商品
fields是需要返回的字段，逗号分隔核心！不要全量拉取，按需选择
跨境选品推荐 fields 组合（直接复制使用）
num_iid,title,pic_url,item_imgs,cid,props,sku,price,orginal_price,post_fee,volume,shop_name,location,approve_status,desc
含义：商品 ID、标题、主图、轮播图、类目、属性、SKU 列表、售价、原价、邮费、销量、店铺名、发货地、上下架状态、详情描述淘宝开放平...
四、返回结构分层解读（跨境选品视角）
返回顶层是 item 对象，下面分几大块：基础信息、图片、属性、SKU 数组、物流、销量、店铺信息。
4.1 基础商品信息（选品打分、标题翻译用）
{"num_iid":"723456789012","title":"夏季纯棉短袖T恤女宽松百搭上衣","cid":50012286,"price":"39.90","orginal_price":"79.00","volume":"2356","location":"浙江杭州","shop_name":"XX服饰旗舰店","approve_status":"onsale"}
volume：销量，跨境选品核心指标，用来判断爆款潜力
location：发货地，反向海淘、集运系统判断国内仓、预估运费
approve_status：onsale 在售 /instock 仓库，过滤已下架商品
4.2 图片字段（铺货素材，重中之重）
"pic_url":"https://img.alicdn.com/xxx.jpg","item_imgs": [{"url":"https://img.alicdn.com/xxx1.jpg"},{"url":"https://img.alicdn.com/xxx2.jpg"}]
跨境业务注意：阿里图片有防盗链，不能直接外链刊登海外平台，采集后必须下载、转存到自己对象存储，再做白底图裁剪、多语种配图处理。
4.3 商品属性 props（类目映射、关键词、报关信息）
props 是属性 ID: 属性值字符串，例如 1627207:白色;12345:XL
用途：自动翻译、生成海外平台 spec 规格、报关申报要素
坑点：属性 ID 是淘系内部类目体系，不能直接丢给 Ozon/Temu，需要维护一张属性映射字典，把淘系属性映射成海外平台标准属性。
4.4 SKU 数组（跨境刊登最容易出错模块）
"sku": [ {"sku_id":"345678901","properties":"颜色:白色;尺码:XL","price":"39.90","quantity":"120","outer_id":"WH-XL" }]
properties：规格组合，需要拆分成独立的键值对（颜色、尺码）
quantity：库存，铺货前做库存校验，防止超卖
outer_id：商家编码，可作为我方系统内部 SKU 编码关联 ID
业务难点：很多淘系 SKU 规格名称是中文口语，需要清洗、标准化，再翻译成英文 / 俄文等目标语种。
4.5 物流相关 post_fee
post_fee：基础运费，用于集运、代购系统预估成本、核算利润。
五、跨境选品采集的字段取舍策略
必取字段：num_iid、title、pic、item_imgs、sku、price、volume、location、props、post_fee
可选字段：商品详情 desc（用于 AI 文案改写、NLP 卖点提取）
尽量不取：优惠券、直播、淘客佣金、评价（评价单独走评论 API，详情接口拉取会加重接口负载）
