速卖通：获得商品详情 API

item_get-获得aliexpress商品详情  注册开通测试

onebound.aliexpress.item_get

公共参数

请求地址: api-gw.onebound.cn/aliexpress/…

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

参数说明：num_iid:aliexpress商品ID

响应参数

Version: Date:

名称	类型	必须	示例值	描述
num_iid	Bigint	0	32667038134	商品ID
title	String	0	女装T恤短袖吸湿快速干燥健身T恤女装上衣	商品标题
desc_short	String	0		商品简介
price	String	0	4.35-4.68	价格
total_price	Int	0	0
suggestive_price	Int	0	0
orginal_price	String	0	6.21-6.68	原价
nick	String	0	SILVERCELL SILVERCELL Store	买卖方昵称
num	Int	0	1799	可购买商品数量
min_num	Int	0	0
detail_url	String	0	www.aliexpress.com/item//32667…	商品链接
pic_url	String	0	ae01.alicdn.com/kf/HTB12r_y…	商品图片
brand	String	0		品牌名称
brandId	Bigint	0		品牌ID
rootCatId	Bigint	0	100003109	顶级分类ID
cid	Bigint	0
crumbs	Mix	0	{"100003109": "女性着装", "100003127": "T恤", "200000785": "上衣和T恤"}	导航菜单
created_time	Date	0		创建时间
modified_time	Date	0		修改时间
delist_time	Date	0		删除时间
desc	String	0
desc_img	Mix	0	[]	商品描述图片
item_imgs	Mix	0	[{"url": "ae01.alicdn.com/kf/HTB12r_y…"}]	商品图片
item_weight	Float	0	0.25	包装重量
item_size	String	0	22	18	20	包装尺寸
location	String	0		发货地
post_fee	Float	0	6.00	物流费用
express_fee	Float	0	6.00	快递费用
ems_fee	Float	0	6.00	EMS费用
shipping_to	String	0		发货至
has_discount	Boolean	0		是否有折扣
video	Mix	0	[]	商品视频
is_virtual	Boolean	0
sample_id	Bigint	0		商品风格标识ID
is_promotion	Boolean	0
props_name	String	0	14:193:Color:Black;5:361385:Size:L	商品属性名
prop_imgs	Mix	0	{"prop_img": [{"properties": "14:193", "url": "ae01.alicdn.com/kf/HTB1Q9GW…"}]}	商品属性图片列表
property_alias	String	0	14:193:Black;5:361385:L	商品属性别名
props	Mix	0	[{ "name": "上衣类型","value": "T恤" }]	商品详情
total_sold	Int	0	110	总销量
skus	Mix	0	{"sku": [{"price": "4.61", "orginal_price": "6.58", "properties": "14:193;5:361385", "properties_name": "Color:Black::;Size:L::", "quantity": 100, "sku_id": "14:193;5:361385"}]	商品规格信息
seller_id	Bigint	0		卖家ID
sales	Int	0		销量
shop_id	Bigint	0		店铺ID
props_list	Mix	0	{"Color:Black": ":","Size:L": ":"}	商品属性
seller_info	Mix	0	{ "nick": "", "city": " China ", "level": "", "rate": "", "score": "", "delivery_score": "", "item_score": "", "shop_type": "", "user_num_id": "", "sid": "206074139", "title": "I", "zhuy": "//www.aliexpress.com/store/93319…", "menu": []}	卖家信息
tmall	Boolean	0	false	是否天猫
error	String	0		错误信息
warning	String	0		警告信息
url_log	Mix	0
score	Float	0	4.8	商品评分
votes	Int	0	49	评分人数
stuff_status	String	0
shopinfo	Mix	0	{"shop_name": ""}	店铺信息
promo_type	String	0
shop_item	Mix	0	[]
relate_items	Mix	0	[]
packaging	Mix	0	[{ "name": "Package Size","value": "22cm x 18cm x 20cm (8.66in x 7.09in x 7.87in)"}]	包装信息
current_lang	String	0	en
currency_code	String	0	USD
props_img	Mix	0	{"14:193": "ae01.alicdn.com/kf/HTB1Q9GW…	属性图片

请求示例

• Curl
• PHP
• PHPsdk
• JAVA
• C#
• Python

	
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/aliexpress/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=4000926586732"

响应示例

	"items": {
		"page": 1,
		"error": "",
		"real_total_results": "3950970",
		"total_results": 4400,
		"item": [
			{
				"title": "Zapatos de hombre",
				"pic_url": "https://ae04.alicdn.com/kf/S146337910c4242daaed0cc400b6635e5v.jpg",
				"promotion_price": 20.87,
				"price": 20.87,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256804369275759",
				"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-0",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256804369275759.html"
			},
			{
				"title": "Zapatos de malla para mujer WJ161",
				"pic_url": "https://ae04.alicdn.com/kf/S3b3a9294dded435dbb9f5b51395751f9o.jpg",
				"promotion_price": 17.5,
				"price": 17.5,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256804369292813",
				"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-1",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256804369292813.html"
			},
			{
				"title": "Colgante de plata de ley 925 para mujer, dije de amor, compatible con Pandora, pulseras, joyería Original, serie oceánica de verano, novedad",
				"pic_url": "//ae04.alicdn.com/kf/S2da341e0ad7c44e3951763c2e7f1f055x.jpg",
				"promotion_price": 0.01,
				"price": 0.01,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256803242880791",
				"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-2",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256803242880791.html"
			},
			{
				"title": "Chanclas de verano para hombre, sandalias de playa antideslizantes, zapatos planos informales, Zapatillas de casa para interior y exterior, 2022",
				"pic_url": "https://ae04.alicdn.com/kf/S3303f3d624e148a384c913a7ffc33e68Z.jpg",
				"promotion_price": 3.89,
				"price": 3.89,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256804184357575",
				"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-3",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256804184357575.html"
			},
			{
				"title": "Botas de Cosplay de Ojamajo Doremi Hana Makihatayama, zapatos de cuero blanco a medida",
				"pic_url": "https://ae04.alicdn.com/kf/Sf478a18c2cd443babe9f40498731f1ffI.jpg",
				"promotion_price": 35.64,
				"price": 35.64,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256802726545330",
				"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-4",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256802726545330.html"
			},
			{
				"title": "Zapatillas de suela gruesa para hombre y mujer, chanclas de plataforma antideslizantes, zapatos de diseñador, sandalias",
				"pic_url": "https://ae04.alicdn.com/kf/Sec33322602a94251bf12531885670b07x.jpg",
				"promotion_price": 3.92,
				"price": 3.92,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256804226773913",
				"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-5",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256804226773913.html"
			},
			{
				"title": "B",
				"pic_url": null,
				"promotion_price": null,
				"price": null,
				"orginal_price": "",
				"sales": 0,
				"num_iid": null,
				"sample_id": null,
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/.html"
			},
			{
				"title": "Sandalias de verano para niñas pequeñas, zapatos bonitos de princesa caramelo, sandalias romanas antideslizantes, zapatos transpirables de playa con agujeros en la cueva",
				"pic_url": "//ae04.alicdn.com/kf/S71f03a99254641e8a0cea0686d5e59a2Z.jpg",
				"promotion_price": 7.9,
				"price": 7.9,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256803872305870",
				"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-7",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256803872305870.html"
			},
			{
				"title": "Zapatillas de tiburón para mujer, sandalias de verano, chanclas antideslizantes para el hogar, zapatos de moda para parejas, zapatillas divertidas para interiores y exteriores, 2022",
				"pic_url": "//ae04.alicdn.com/kf/S6f5f4b77db6a47ff84e44ec75f4fe83be.jpg",
				"promotion_price": 8.08,
				"price": 8.08,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256804002500233",
				"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-8",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256804002500233.html"
			},
			{
				"title": "Zapatillas de playa para hombre y mujer, chanclas suaves de Eva, de suela gruesa dentada, antideslizantes",
				"pic_url": "https://ae04.alicdn.com/kf/S8f0d6d2e0ce14b0c834cbdccff982e58z.jpg",
				"promotion_price": 8.99,
				"price": 8.99,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256804137655133",
				"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-9",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256804137655133.html"
			},
			{
				"title": "White Sneakers Women Shoes Casual Platform Mesh Breathable Vulcanized Shoes Ladies Outdoor Walking Footwear Chaussure Femme",
				"pic_url": "https://ae04.alicdn.com/kf/S5c34e405ba854e2b944b397c36565005H.jpg",
				"promotion_price": 10.46,
				"price": 10.46,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256804344307211",
				"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-10",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256804344307211.html"
			},
			{
				"title": "B",
				"pic_url": null,
				"promotion_price": null,
				"price": null,
				"orginal_price": "",
				"sales": 0,
				"num_iid": null,
				"sample_id": null,
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/.html"
			},
			{
				"title": "Zapatillas de tiburón para hombre y mujer, chanclas de playa con plataforma de 4CM, para interior y baño, suaves, de EVA, para verano",
				"pic_url": "https://ae04.alicdn.com/kf/S4ee5e71c3c664db1b6183e49c6787f59R.jpg",
				"promotion_price": 6.39,
				"price": 6.39,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256804223634744",
				"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-12",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256804223634744.html"
			},
			{
				"title": "Sandalias de Plataforma para Mujer, Zapatos Planos de Verano, a la Moda para Interiores y el Hogar, Nuevo, 2022",
				"pic_url": "https://ae04.alicdn.com/kf/S62b2b9205384410fa2833ec76d2851aa7.jpg",
				"promotion_price": 10.17,
				"price": 10.17,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256803602412251",
				"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-13",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256803602412251.html"
			},
			{
				"title": "Zapatillas de deporte informales para hombre, Tenis de lujo, transpirables, para correr, baloncesto, caminar",
				"pic_url": "//ae04.alicdn.com/kf/Sb1e8292672bb4bba8863670afc596d9aA.jpg",
				"promotion_price": 40,
				"price": 40,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256804181619191",
				"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-14",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256804181619191.html"
			},
			{
				"title": "Zapatillas de deporte de alta calidad para Hombre, zapatos transpirables, blancos, a la moda, para gimnasio, calzado ligero informal para caminar",
				"pic_url": "https://ae04.alicdn.com/kf/S62f5c44e5aba442c9dd8bf8cc743e539D.jpg",
				"promotion_price": 19.5,
				"price": 19.5,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256804370443445",
				"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-15",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256804370443445.html"
			},
			{
				"title": "Zapatillas peludas para mujer, sandalias mullidas de pelo de zorro de felpa, pantuflas de piel cálidas para invierno",
				"pic_url": "https://ae04.alicdn.com/kf/Se7d1c776fd6e4a9c844dc6e3aa5dc1d5q.jpg",
				"promotion_price": 7.98,
				"price": 7.98,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256804038443132",
				"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-16",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256804038443132.html"
			},
			{
				"title": "Lolita-zapatos de tacón alto con plataforma para mujer, sandalias de estilo japonés, Estilo Vintage, para estudiantes",
				"pic_url": "https://ae04.alicdn.com/kf/S9142e109e5674cb19961770656feb369Y.jpg",
				"promotion_price": 9.4,
				"price": 9.4,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "2255801092398027",
				"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-17",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/2255801092398027.html"
			},
			{
				"title": "Abalorio de plata de ley 925 con diseño de gato y bicicleta, accesorio Original compatible con pulseras Pandora, joyería DIY para hacer regalos, novedad",
				"pic_url": "https://ae04.alicdn.com/kf/Had57949a494b4decac372d2909f7820fu.jpg",
				"promotion_price": 3.14,
				"price": 3.14,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256803389168840",
				"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-18",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256803389168840.html"
			},
			{
				"title": "Zapatos de Seguridad Ligeros y Transpirables con Punta de Acero Antigolpes, Zapatillas a Prueba de Perforaciones para el Trabajo, Calzado para Hombre y Mujer",
				"pic_url": "//ae04.alicdn.com/kf/H805ef31d8a784faab67ddf38bd53dd67t.jpg",
				"promotion_price": 24.38,
				"price": 24.38,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "2261800176846677",
				"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-19",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/2261800176846677.html"
			}
		],
		"related_keywords": [],
		"nav_catcamp": [],
		"crumbs": [],
		"breadcrumbs": [],
		"navs": [],
		"data_from": "",
		"url": "",
		"keyword": "shoe",
		"cid": "",
		"page_size": 20,
		"pagecount": ""
	},
	"error_code": "0000",
	"reason": "ok",
	"secache": "a799cd7c0b5c3217932480868ddb51cc",
	"secache_time": 1658883513,
	"secache_date": "2022-07-27 08:58:33",
	"error": "",
	"cache": 0,
	"api_info": "today:75 max:10100 all[160=75+26+59];expires:2030-12-31",
	"execution_time": "2.172",
	"server_time": "Beijing/2022-07-27 08:58:33",
	"client_ip": "106.6.35.233",
	"call_args": {
		"q": "shoe"
	},
	"api_type": "aliexpress",
	"translate_language": "zh-CN",
	"translate_engine": "google_cn",
	"server_memory": "3.25MB",
	"request_id": "gw-1.62e08db758267",
	"last_id": "1105609715"
}

异常示例相关资料错误码解释

状态代码(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	未知错误	否