速卖通按关键字搜索aliexpress商品 API 返回值说明

请求地址: 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版本

请求参数

请求参数：q=shoe&start_price=&end_price=&page=&cat=&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=

参数说明：q:搜索关键字
cat:分类ID
start_price:开始价格
end_price:结束价格
sort:排序[bid,_bid,_sale,_new]
(bid:总价,sale:销量,new上架时间,加_前缀为从大到小排序)
page:

API测试工具 点击申请试用

响应参数

Version: Date:

名称	类型	必须	示例值	描述
num_iid	Bigint	0	32944112999	宝贝ID
title	String	0	Male Breathable Comfortable Casual Shoes Fashion Men Canvas Shoes Lace up Wear-resistant Men Sneakers zapatillas deportiva	商品标题
pic_url	String	0	//ae01.alicdn.com/kf/HTB1_AwYXdfvK1RjSspfq6zzXFXap/Male-Breathable-Comfortable-Casual-Shoes-Fashion-Men-Canvas-Shoes-Lace-up-Wear-resistant-Men-Sneakers-zapatillas.jpg_220x220xz.jpg	宝贝图片
promotion_price	String	0	8.75-8.97	优惠价
price	String	0	8.75-8.97	价格
sales	Int	0		销量
feedback	Int	0	80	评论数
orders	Int	0	815	订单数
sample_id	String	0		商品风格标识ID
post_fee	Float	0	9.91	物流费用
star	String	0	4.8	商品评分
area	String	0		店铺所在地
detail	String	0	//www.aliexpress.com/item/Male-B…	商品链接

请求示例

<?php

// 请求示例 url 默认请求参数已经URL编码处理
// 本示例代码未加密secret参数明文传输，若要加密请参考：https://open.onebound.cn/help/demo/sdk/demo-sign.php
$method = "GET";
$url = "https://api-gw.onebound.cn/aliexpress/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=shoe&start_price=&end_price=&page=&cat=&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=";
$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST,FALSE);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER,FALSE);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, true);
curl_setopt($curl, CURLOPT_ENCODING, "gzip");
var_dump(curl_exec($curl));
?>

API返回结果

---------------------------------------
{
	"items": {
		"page": 1,
		"error": "",
		"real_total_results": "1678642",
		"total_results": 4400,
		"item": [
			{
				"title": "Kids Basketball Shoes Boys Girls Breathable Sport Running Children's Sneakers Non-Slip Zapatillas Tenis Size 31-40",
				"pic_url": "https://ae04.alicdn.com/kf/Scb5e6e033e4243f9b171846cef9a21dbE.jpg",
				"promotion_price": 26.85,
				"price": 26.85,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256804587273729",
				"sample_id": "41d2c8f1-3b3a-4354-ac77-fcaaf866277e-0",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256804587273729.html"
			},
			{
				"title": "Dafu Original 1920 Black White KungFu Shoes Improved Version Sneakers Men Women Shoes Parkour shoes",
				"pic_url": "//ae04.alicdn.com/kf/S6b80416b66ca418a8794d8fdd9113b11Y.jpg",
				"promotion_price": 22.58,
				"price": 22.58,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256803217653338",
				"sample_id": "41d2c8f1-3b3a-4354-ac77-fcaaf866277e-1",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256803217653338.html"
			},
			{
				"title": "49 Winter Lager Size Outdoor Men Leather Casual Shoes Women Warm Fur Sneakers Lace Up Adult Footwear Plush Spring Summer Walking",
				"pic_url": "//ae04.alicdn.com/kf/Se9a1139b04bb4b709abfde8a3b482d970.jpg",
				"promotion_price": 25.97,
				"price": 25.97,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256801553557202",
				"sample_id": "41d2c8f1-3b3a-4354-ac77-fcaaf866277e-2",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256801553557202.html"
			},
			{
				"title": "BJ Shoes",
				"pic_url": "//ae04.alicdn.com/kf/S258d732203764485ac6433bf934f1bfeF.jpg",
				"promotion_price": 11.22,
				"price": 11.22,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256803512234986",
				"sample_id": "41d2c8f1-3b3a-4354-ac77-fcaaf866277e-3",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256803512234986.html"
			},
			{
				"title": "D04 2022 New Hot Low Men's Skateboarding Shoes Sneakers Women Men Shoes Sport Mesh Trainers Running Shoes Outdoor Athletic Shoes",
				"pic_url": "https://ae04.alicdn.com/kf/S3aeeee89d32e4736b01161ed6cf83d40G.jpg",
				"promotion_price": 78.09,
				"price": 78.09,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256804656777739",
				"sample_id": "41d2c8f1-3b3a-4354-ac77-fcaaf866277e-4",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256804656777739.html"
			},
			{
				"title": "2022 New Men Sneakers Running Shoes Women Sport Shoes Classical Mesh Breathable Casual Shoes Men Fashion Lightweight Sneakers",
				"pic_url": "https://ae04.alicdn.com/kf/S45d9e8fa751040b58940d53cbde60398R.jpg",
				"promotion_price": 5.27,
				"price": 5.27,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256804650155931",
				"sample_id": "41d2c8f1-3b3a-4354-ac77-fcaaf866277e-5",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256804650155931.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": "Children Shoes Spring Autumn Casual Fashion Breathable Kids Boys Girls Baby Shoes Soft Bottom Non-Slip",
				"pic_url": "https://ae04.alicdn.com/kf/H267236bbca154b33b7165f764ef685cbv.jpg",
				"promotion_price": 10.48,
				"price": 10.48,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256803599162329",
				"sample_id": "41d2c8f1-3b3a-4354-ac77-fcaaf866277e-7",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256803599162329.html"
			},
			{
				"title": "Winter Simple Japanese Woolen Elastic Band Slippers for Boys 2022 All-match Indoor and Outdoor Girls Child Fashion Casual Shoes",
				"pic_url": "https://ae04.alicdn.com/kf/S1f05b7b7ca5b4cabb0e9fdf9eccc246br.jpg",
				"promotion_price": 14.33,
				"price": 14.33,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256804601481382",
				"sample_id": "41d2c8f1-3b3a-4354-ac77-fcaaf866277e-8",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256804601481382.html"
			},
			{
				"title": "Xiaomi Sneakers Outdoor Hiking Shoes Non-slip Wear-resistant Breathable Shock Absorption High-quality Light Men Sports Sneakers",
				"pic_url": "//ae04.alicdn.com/kf/S341a4c3186034f00bb59c051365d8920h.jpg",
				"promotion_price": 43.06,
				"price": 43.06,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256804257742147",
				"sample_id": "41d2c8f1-3b3a-4354-ac77-fcaaf866277e-9",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256804257742147.html"
			},
			{
				"title": "Leisure sports shoes in 2022",
				"pic_url": "https://ae04.alicdn.com/kf/S3ff63af030c443e5882f8969c9011528y.jpg",
				"promotion_price": 10.39,
				"price": 10.39,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256804642810478",
				"sample_id": "41d2c8f1-3b3a-4354-ac77-fcaaf866277e-10",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256804642810478.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": "2022 New Comfort  flats Espadrilles fashion word matrons with flats Single shoes flat shoes",
				"pic_url": "//ae04.alicdn.com/kf/S73f60f44301a40369ff1494d9eac3b2dX.jpg",
				"promotion_price": 42.9,
				"price": 42.9,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256804620721931",
				"sample_id": "41d2c8f1-3b3a-4354-ac77-fcaaf866277e-12",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256804620721931.html"
			},
			{
				"title": "2022 Men Shoes Lightweight Breathable Men Shoes Flat Lace-Up Men Sneakers White Business Travel Unisex Tenis Masculino",
				"pic_url": "https://ae04.alicdn.com/kf/Sb6e1112c515547ffb6e12bd72cd79d27c.jpg",
				"promotion_price": 15.11,
				"price": 15.11,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256804388639194",
				"sample_id": "41d2c8f1-3b3a-4354-ac77-fcaaf866277e-13",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256804388639194.html"
			},
			{
				"title": "A10 2022 New Hot High Quality Plus Black Men Running Shoes Comfortable Sports Lightweight Sneakers Original size 36-45",
				"pic_url": "https://ae04.alicdn.com/kf/S04ff57172fd64a249f211065b3f29705H.jpg",
				"promotion_price": 115.13,
				"price": 115.13,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256804656829478",
				"sample_id": "41d2c8f1-3b3a-4354-ac77-fcaaf866277e-14",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256804656829478.html"
			},
			{
				"title": "YZ02 2022 New High Quality Running Shoes Belgua Frozen Dazzling Blue Tailgate Static Men Women Zebra Sneakers",
				"pic_url": "https://ae04.alicdn.com/kf/S33b67c728fe94ed8a36dd8e659cc2e28n.jpg",
				"promotion_price": 102.11,
				"price": 102.11,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256804656778765",
				"sample_id": "41d2c8f1-3b3a-4354-ac77-fcaaf866277e-15",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256804656778765.html"
			},
			{
				"title": "A09 2022 Hot Men And Womens Running Shoes Mesh Breathable Sneakers White Triple Black Red Comfortable Trainers Sport 36-45",
				"pic_url": "https://ae04.alicdn.com/kf/S6e1dc609d61c4f3c8c460afce8f490b1O.jpg",
				"promotion_price": 115.13,
				"price": 115.13,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256804656786675",
				"sample_id": "41d2c8f1-3b3a-4354-ac77-fcaaf866277e-16",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256804656786675.html"
			},
			{
				"title": "Women Boots Waterproof Snow Boots For Winter Shoes Women Heels Ankle Boots Winter Platform Botas Mujer Keep Warm Bottines Female",
				"pic_url": "//ae04.alicdn.com/kf/S546f0aefaf444d9da8269665f8c2ffee5.jpg",
				"promotion_price": 15.44,
				"price": 15.44,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256804593827173",
				"sample_id": "41d2c8f1-3b3a-4354-ac77-fcaaf866277e-17",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256804593827173.html"
			},
			{
				"title": "Outdoor Lover Trekking Shoes Men Waterproof Hiking Shoes Mountain Boots Genuine Leather Woodland Hunting Tactical Shoes",
				"pic_url": "//ae04.alicdn.com/kf/S3f1cd9116ddb472d9f75e338a5bfc13dQ.jpg",
				"promotion_price": 24.26,
				"price": 24.26,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256803932768599",
				"sample_id": "41d2c8f1-3b3a-4354-ac77-fcaaf866277e-18",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256803932768599.html"
			},
			{
				"title": "Wedge Platform Sneakers 2022 New Fashion Plus Size Casual Sports Shoes Women Lace-up Mesh Breathable Women's Vulcanized Shoes",
				"pic_url": "https://ae04.alicdn.com/kf/Secb7315c9214445dae61a09176b18828U.jpg",
				"promotion_price": 15.12,
				"price": 15.12,
				"orginal_price": "",
				"sales": 0,
				"num_iid": "3256804616448274",
				"sample_id": "41d2c8f1-3b3a-4354-ac77-fcaaf866277e-19",
				"seller_nick": "",
				"detail_url": "https://www.aliexpress.com/item/3256804616448274.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": 1666144608,
	"secache_date": "2022-10-19 09:56:48",
	"error": "",
	"cache": 0,
	"api_info": "today:110 max:10000 all[664=110+68+486];expires:2030-12-31",
	"execution_time": "1.468",
	"server_time": "Beijing/2022-10-19 09:56:48",
	"client_ip": "117.162.192.171",
	"call_args": {
		"q": "shoe"
	},
	"api_type": "aliexpress",
	"translate_language": "zh-CN",
	"translate_engine": "google_cn",
	"server_memory": "0.86MB",
	"request_id": "gw-4.634f595f78702",
	"last_id": "1293351320"
}