API科普 | 微店商品查询API接口汇总及应用场景介绍-优快云博客

本文链接：https://blog.youkuaiyun.com/Ob_API20230201/article/details/149218012

微店商品详情 API 接口是连接微店平台与外部系统的数据桥梁，通过调用该接口可获取商品的标题、价格、库存、规格、图文描述等详细信息。其应用场景广泛，涵盖电商运营、工具开发、数据分析等多个领域，具体如下：

一、第三方电商工具开发

店铺管理工具：开发者可基于该 API 开发多店铺管理系统，帮助商家集中查看不同微店的商品详情（如价格、库存），实现批量修改、同步商品信息等操作，提升管理效率。
选品工具：针对电商从业者（如代购、分销商），工具可通过 API 抓取微店商品数据，结合销量、评价等维度进行分析，生成选品推荐列表，辅助用户快速筛选优质商品。
订单处理工具：当用户在第三方平台下单后，工具可调用微店商品详情 API 获取商品规格、库存等信息，自动校验订单可行性（如库存是否充足），并同步至微店完成下单流程。

二、跨平台商品同步与展示

多平台店铺运营：若商家同时运营微店和其他电商平台（如淘宝、拼多多），可通过 API 将微店商品详情同步至其他平台，确保各平台商品信息（如价格、描述）一致，减少手动维护成本。
自媒体 / 社群带货：在公众号、小程序、社群等场景中，可通过 API 实时获取微店商品详情，自动生成带购买链接的商品卡片或文案，用户点击后直接跳转至微店购买，缩短转化路径。
企业官网嵌入：品牌商家可在官网的 “商城” 板块中，通过 API 对接微店商品数据，实时展示商品详情，用户在官网浏览后可直接跳转至微店完成交易，实现官网流量与微店销售的联动。

三、数据分析与市场调研

竞品分析：电商从业者可通过 API 批量获取竞争对手微店的商品详情（如价格策略、规格设置、促销活动），结合自身商品数据进行对比分析，优化定价和产品策略。
行业趋势研究：研究机构或平台可抓取特定品类下的微店商品数据，分析商品属性（如材质、功能）、价格区间、销量分布等，总结行业趋势（如热门功能、消费偏好），为企业决策提供参考。
库存与销售监控：商家可通过 API 实时获取自家微店商品的库存、销量数据，结合商品详情中的规格信息（如尺码、颜色），分析不同规格的销售表现，优化库存备货策略，避免积压或断货。

item_search-根据关键词取商品列表

item_get-获得微店商品详情

公共参数

名称	类型	必须	描述
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_iid=2749499386

参数说明：num_iid:微店商品ID

测试示例

响应数据

{
  "item": {
		"num_iid": "2749499386",
		"title": "Swarovski施华洛世奇LIFELONG BOW 流苏蝴蝶结浪漫妩媚女款项链饰品礼物5447082",
		"desc_short": "Swarovski施华洛世奇LIFELONG BOW 流苏蝴蝶结浪漫妩媚女款项链饰品礼物5447082",
		"price": 45,
		"total_price": 0,
		"suggestive_price": 0,
		"orginal_price": "45",
		"nick": "达薇妮珠宝",
		"num": "",
		"min_num": 0,
		"detail_url": "https://weidian.com/item.html?itemID=2749499386",
		"pic_url": "https://si.geilicdn.com/pcitem1288244399-3b300000016a3fd26d6f0a217216_800_800.jpg",
		"brand": "",
		"brandId": "",
		"rootCatId": "",
		"cid": "",
		"favcount": "",
		"fanscount": "",
		"crumbs": [],
		"created_time": "",
		"modified_time": "",
		"delist_time": "",
		"desc": "<img src=\"https://si.geilicdn.com/pcitem1288244399-23910000016a40086f230a217216_790_420.jpg\"/><img src=\"https://si.geilicdn.com/pcitem1288244399-25490000016a40086f650a217252_790_402.jpg\"/><img src=\"https://si.geilicdn.com/pcitem1288244399-064c0000016a400870600a21924b_790_503.jpg\"/><img src=\"https://si.geilicdn.com/pcitem1288244399-61250000016a400870900a219248_790_308.jpg\"/><img src=\"https://si.geilicdn.com/pcitem1288244399-0e370000016a400871960a21924a_790_600.jpg\"/><img src=\"https://si.geilicdn.com/pcitem1288244399-25730000016a400874400a217252_790_600.jpg\"/><img src=\"https://si.geilicdn.com/pcitem1288244399-61470000016a400874790a219248_790_600.jpg\"/><img src=\"https://si.geilicdn.com/pcitem1288244399-26c00000016a400875df0a217205_790_600.jpg\"/><img src=\"https://si.geilicdn.com/pcitem1288244399-34850000016a400876a90a20b7b9_790_834.jpg\"/><img src=\"https://si.geilicdn.com/pcitem1288244399-23c00000016a4008754e0a217216_790_379.jpg\"/><img src=\"https://si.geilicdn.com/pcitem1288244399-06800000016a400876500a21924b_790_524.jpg\"/><img src=\"https://si.geilicdn.com/pcitem1288244399-25840000016a400875e90a217252_790_427.jpg\"/>",
		"desc_img": [
			"https://si.geilicdn.com/pcitem1288244399-23910000016a40086f230a217216_790_420.jpg",
			"https://si.geilicdn.com/pcitem1288244399-25490000016a40086f650a217252_790_402.jpg",
			"https://si.geilicdn.com/pcitem1288244399-064c0000016a400870600a21924b_790_503.jpg",
			"https://si.geilicdn.com/pcitem1288244399-61250000016a400870900a219248_790_308.jpg",
			"https://si.geilicdn.com/pcitem1288244399-0e370000016a400871960a21924a_790_600.jpg",
			"https://si.geilicdn.com/pcitem1288244399-25730000016a400874400a217252_790_600.jpg",
			"https://si.geilicdn.com/pcitem1288244399-61470000016a400874790a219248_790_600.jpg",
			"https://si.geilicdn.com/pcitem1288244399-26c00000016a400875df0a217205_790_600.jpg",
			"https://si.geilicdn.com/pcitem1288244399-34850000016a400876a90a20b7b9_790_834.jpg",
			"https://si.geilicdn.com/pcitem1288244399-23c00000016a4008754e0a217216_790_379.jpg",
			"https://si.geilicdn.com/pcitem1288244399-06800000016a400876500a21924b_790_524.jpg",
			"https://si.geilicdn.com/pcitem1288244399-25840000016a400875e90a217252_790_427.jpg"
		],
		"item_imgs": [
			{
				"url": "https://si.geilicdn.com/pcitem1288244399-3b300000016a3fd26d6f0a217216_800_800.jpg"
			}
		],
		"item_weight": "",
		"item_size": "",
		"location": "",
		"post_fee": "",
		"express_fee": "",
		"ems_fee": "",
		"shipping_to": "",
		"has_discount": "",
		"video": [],
		"is_virtual": "",
		"sample_id": "",
		"is_promotion": "false",
		"props_name": "0:561195188:项链:流苏蝴蝶结项链;",
		"prop_imgs": {
			"prop_img": []
		},
		"property_alias": "",
		"props": [],
		"total_sold": "0",
		"skus": {
			"sku": [
				{
					"price": "45.00",
					"orginal_price": "45.00",
					"properties": "0:561195188;",
					"properties_name": "0:561195188:项链:流苏蝴蝶结项链;:",
					"quantity": 957,
					"sku_id": 10668572309
				}
			]
		},
		"seller_id": "",
		"sales": 106,
		"shop_id": 1288244399,
		"props_list": [
			{
				"0:561195188": "项链:流苏蝴蝶结项链"
			}
		],
		"seller_info": {
			"title": "达薇妮珠宝",
			"shop_name": "达薇妮珠宝",
			"zhuy": "https://weidian.com/?userid=1288244399",
			"level": 3,
			"shop_type": 3,
			"user_num_id": 1288244399,
			"nick": "达薇妮珠宝"
		},
		"tmall": "false",
		"error": "",
		"warning": "",
		"url_log": [],
		"stuff_status": "",
		"data_from": "micro",
		"method": "",
		"promo_type": null,
		"props_img": null,
		"rate_grade": "",
		"priceRange": [],
		"shop_item": [],
		"relate_items": []
	},
	"secache": "bca4a25047d7b435e098ecb97efd77dd",
	"secache_time": 1611128224,
	"secache_date": "2021-01-20 15:37:04",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},

}