淘宝商品详情查询 API(item_detail)主要用于获取淘宝商品的详细信息,以下是相关介绍:
- 请求参数: num_iid:必填参数,代表商品的唯一标识 ID。通过该 ID 可以准确地指定要查询的商品。例如,你想要查询某个特定的手机商品详情,就需要获取该手机商品的 num_iid 并传入接口。 is_promotion:可选参数,用于指定是否获取促销价信息。如果设置为 true,接口返回的信息中会包含商品的促销价格等相关促销信息;如果设置为 false(或不设置该参数),则可能只返回商品的常规价格信息6。
- 响应参数: (如体验API:c0b.cc/R4rbK2)
item:包含宝贝的详细数据,是一个复杂的结构体,里面包含众多子参数。 num_iid:商品的唯一 ID,与请求参数中的 num_iid 相对应,用于确认返回的商品信息是否正确。 title:商品的标题,简洁明了地描述商品的名称或主要特点。比如 “华为 P50 智能手机” 等。 desc_short:商品的简短描述,通常是对商品的核心特点或优势的简要概括。 promotion_price:商品的优惠价,如果商品有促销活动,该价格就是促销后的价格。 price:商品的价格,可能是原价或者当前的非促销价格。 original_price:商品的原价,用于与促销价等进行对比,让用户了解商品价格的变化。 nick:卖家的昵称,帮助买家了解商品的卖家信息。 num:商品的库存数量,告知买家该商品目前的可购买数量。 min_num:最小购买数,即购买该商品时最少需要购买的数量限制。 detail_url:商品的详情链接,点击该链接可以跳转到淘宝商品的详细页面。 pic_url:商品的图片链接,通过该链接可以获取到商品的图片,方便买家查看商品的外观等信息。 brand:商品的品牌名称,对于品牌商品,该参数可以帮助买家快速了解商品的品牌信息。 brandid:品牌的唯一标识 ID,方便系统对品牌进行识别和管理。 rootcatid:商品的顶级分类 ID,用于确定商品所属的大分类,如电子产品、服装等。 cid:商品的子分类 ID,在顶级分类的基础上进一步细分商品的具体类别。 created_time:商品的创建时间,记录了商品在淘宝平台上的创建日期和时间。 modified_time:商品的修改时间,当卖家对商品信息进行修改时,该时间会更新。 delist_time:商品的下架时间,如果商品已经下架,该参数会记录下架的时间。 desc:商品的详细描述,包含商品的详细介绍、功能、使用方法、材质等详细信息。 item_imgs:商品的图片列表,可能包含商品的多角度展示图片、细节图片等。 props_name:商品的属性名,例如颜色、尺寸、型号等属性的名称和对应的值6。 skus:商品的规格信息列表,包含不同规格(如不同颜色、尺寸等)的商品的具体信息,如价格、库存等。