一、业务背景
跨境选品采集的核心痛点：需要从淘宝、天猫货源拿到标准化的标题、主图、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，详情接口拉取会加重接口负载）
