1688 商品详情数据接口（1688.item_get）丨 1688API 接入指南

1688 商品详情数据接口（1688.item_get）是阿里巴巴提供给开发者的 API 接口，用于获取 1688 网站上商品的详细信息. 以下是对该接口的详细介绍：

调用前准备

• 注册成为开发者：需要在阿里巴巴开放平台注册账号，并创建一个应用，以获取 API 调用所需的凭证，如 App Key 和 App Secret. 请求 demo 示例地址：c0b.cc/R4rbK2 。

• 申请 API 调用权限：根据应用需求，申请相应的 API 调用权限，可能需要经过阿里巴巴的审核和授权.

请求参数

• app_key：必填参数，用于标识应用程序，需向 1688 申请唯一的 app_key.

• format：必填参数，返回数据的格式，通常为 json.

• timestamp：必填参数，请求的时间戳，防止请求被缓存或重复执行.

• nonce：必填参数，随机字符串，用于增加请求的安全性.

• sign_method：必填参数，签名方法，目前仅支持 RSA 签名方法。

• sign：必填参数，签名结果，确保请求的安全性，防止被篡改.

• access_id：必填参数，1688 分配给每个开发者的唯一标识符.

• fields：可选参数，商品详情页需要展示的字段，如商品名称、价格、库存、图片等，可根据需要选择.

• key 或 num_iid：可选参数，商品的 key 值或 ID，用于指定获取哪个商品的详情信息.

• sales_data：可选参数，设置为 1 时可获取近 30 天成交数据.

• agent：可选参数，设置为 1 时可获取 1688 分销代发价格数据.

返回结果

成功调用接口后，将收到一个包含商品详情的 JSON 响应，响应中包含的字段与请求参数中 fields 指定的字段相对应 1. 以下是一些常见的返回字段：

• num_iid：商品 ID。

• title：商品名称。

• desc_short：商品简短描述。

• price：商品价格。

• total_price：商品总价。

• suggestive_price：建议价格。

• orginal_price：原价。

• nick：卖家昵称。

• num：商品库存数量。

• detail_url：商品详情页的 URL。

• pic_url：商品图片的 URL。

• brand：品牌名称。

• brandid：品牌 ID。

• rootcatid：根类目 ID。

• cid：类目 ID。

• desc：商品详细描述。

• item_imgs：商品图片列表。

• item_weight：商品重量。

• post_fee：邮费。

• express_fee：快递费。

• ems_fee：EMS 费。

• shipping_to：发货地。

• video：商品视频。

• sample_id：样品 ID。

• props_name：商品属性名称。

• prop_imgs：属性图片。

• property_alias：属性别名。

• props：商品属性列表。

注意事项

• 调用频率限制：接口的使用可能会受到频率限制，在实际应用中需要注意控制请求频率，避免触发限制，以免影响正常使用或导致账号被封禁等问题.

• 接口更新：由于阿里巴巴平台可能会对接口进行更新，建议定期查看官方的 API 文档，以获取最新的接口信息，确保接口的正确使用.

• 遵守规定：在使用接口时，必须遵守 1688 的服务条款和相关法律法规，不得将数据用于非法或未经授权的用途，确保数据的合法获取和使用.