如何获取淘宝/天猫批量获取商品信息 API 返回值?

item_list_weight-批量获取商品信息

taobao.item_list_weight

公共参数

请求地址: https://api-gw-4.cn/taobao/item_list_weight

名称	类型	必须	描述
key	String	是	调用key（必须以GET方式拼接在URL中）
secret	String	是	调用密钥
api_name	String	是	API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cache	String	否	[yes,no]默认yes，将调用缓存的数据，速度比较快
result_type	String	否	[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
lang	String	否	[cn,en,ru]翻译语言，默认cn简体中文
version	String	否	API版本

请求参数

请求参数：num_iids=14905766423,584458528092

参数说明：num_iids:商品id,多个用英文逗号分隔

响应参数

Version: Date:

名称	类型	必须	示例值	描述
num_iid	Bigint	0	14905766423	宝贝ID
weight	Float	0	0.24	重量
unit	String	0	kg	单位

请求示例

• Curl
• PHP
• PHPsdk
• JAVA
• C#
• Python
• Golang
• javascript
• JS-SDK
• Ruby
• Swift
• Objective-C
• C
• C++
• Node.JS
• Kotlin
• Rust
• R
• MATLAB

	
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw-4.cn/taobao/item_list_weight/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iids=14905766423,584458528092"

响应示例

异常示例

相关资料

错误码解释

状态代码(error_code)	状态信息	详细描述	是否收费
0000	success	接口调用成功并返回相关数据	是
2000	Search success but no result	接口访问成功，但是搜索没有结果	是
4000	Server internal error	服务器内部错误	否
4001	Network error	网络错误	否
4002	Target server error	目标服务器错误	否
4003	Param error	用户输入参数错误	忽略
4004	Account not found	用户帐号不存在	忽略
4005	Invalid authentication credentials	授权失败	忽略
4006	API stopped	您的当前API已停用	忽略
4007	Account stopped	您的账户已停用	忽略
4008	API rate limit exceeded	并发已达上限	忽略
4009	API maintenance	API维护中	忽略
4010	API not found with these values	API不存在	忽略
4012	Please add api first	请先添加api	忽略
4013	Number of calls exceeded	调用次数超限	忽略
4014	Missing url param	参数缺失	忽略
4015	Wrong pageToken	参数pageToken有误	忽略
4016	Insufficient balance	余额不足	忽略
4017	timeout error	请求超时	否
5000	unknown error	未知错误	否

API 工具

淘宝/天猫批量获取商品信息的API通常使用淘宝开放平台（Taobao Open Platform）或天猫开放平台（Tmall Open Platform）提供的接口。这些接口可以返回商品的基本信息、价格、销量、属性、评价等。以下是一个简化的示例，展示了可能包含在API返回值中的一些字段：

1. **商品ID**：每个商品在淘宝/天猫平台上的唯一标识（通常称为`num_iid`）。

2. **商品标题**：商品的名称或标题。

3. **商品图片**：商品的主图链接，以及其他可能存在的图片链接（如详情图等）。

4. **商品价格**：商品的销售价格，可能包括原价、促销价、划线价等。

5. **商品销量**：商品近期的销售数量。

6. **商品属性**：如品牌、材质、尺寸、颜色、适用场景等。

7. **商品描述**：商品的详细描述，可能包括商品功能、使用方法等。

8. **商品库存**：商品的库存数量，是否缺货等。

9. **商品分类**：商品所属的分类或标签。

10. **店铺信息**：出售该商品的店铺的名称、ID、评分等。

11. **优惠信息**：如限时抢购、满减优惠、优惠券等促销信息。

12. **用户评价**：商品的用户评价概述，可能包括好评率、评价数量等，以及链接到详细评价页面的URL。

13. **运费模板**：商品的运费信息，如是否包邮、运费标准等。

请注意，实际的API返回值可能会根据API的版本、调用方式以及商品的具体信息而有所不同。此外，由于淘宝和天猫平台的更新和迭代，API的返回值和结构也可能会发生变化。

在使用淘宝/天猫的API之前，你应该查阅淘宝开放平台或天猫开放平台的官方文档，以获取最准确和最新的API返回值说明。这些文档通常会详细列出每个字段的含义、数据类型以及可能的返回值。同时，确保你的应用在使用这些API时遵守平台的使用协议和隐私政策。