【1688阿里巴巴中国站api接口系列】按关键字搜索商品PHP请求调用示例

发布时间 2023-06-07 15:09:26作者: API测试开发Cris

1688阿里巴巴按关键词搜索商品的接口是通过开放平台提供的API接口来实现的。具体实现方式请按以下步骤进行:

1.确认API接口的请求地址和所需参数:需要先查看API文档,了解所要访问的API接口的请求地址和请求参数,以便正确地构造请求和获取数据。

2.注册一个apikey和apisecret调用接入。

3.使用apikey和apisecret调用1688.item_search接口,可以根据关键词获取到商品的详情数据,商品名称,商品数量等。

4.根据API文档中的说明设置请求参数,发送HTTP GET请求到API地址,即可得到对应的调用返回数据。

参数说明

  • 通用参数说明

    • version:API版本
    • key:调用key,测试key:test_api_key
    • api_name:API类型[item_get,item_search]
    • cache:[yes,no]默认yes,将调用缓存的数据,速度比较快
    • result_type:[json,xml,serialize,var_export]返回数据格式,默认为json
    • lang:[cn,en,ru] 翻译语言,默认cn简体中文

php请求示例

<?php

// 请求示例 url 默认请求参数已经URL编码处理
// 本示例代码未加密secret参数明文传输,若要加密请参考:https://help/demo/sdk/demo-sign.php
$method = "GET";
$url = "https://1688/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=40&seller_info=no&nick=&seller_info=&nick=&ppath=&imgid=&filter=";
$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));
?>

请求参数

请求参数:q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=40&seller_info=no&nick=&seller_info=&nick=&ppath=&imgid=&filter=

参数说明:q:搜索关键字
cat:分类ID
start_price:开始价格
end_price:结束价格
sort:排序[bid,_bid,_sale,_credit]
  (bid:总价,sale:销量,credit信用,加_前缀为从大到小排序)
page:页数  page_size:每页宝贝数量,默认40
filter:额外的过滤参数,如:filter=filtId:1,2,3,4;activityType:1,2,3,4;city:天津;quantityBegin:1000
filtId 过滤:48小时发货,7+天包换,赠运费险,免费赊账;
activityType 优惠类型:包邮,产地货源,伙拼,手机专享价
city 地区:地区名
quantityBegin 起订量:数字

代码响应示例

{
	"items": {
		"page": "1",
		"has_more": "true",
		"real_total_results": 2000,
		"total_results": 2000,
		"page_size": 20,
		"pagecount": 100,
		"item": [
			{
				"title": "短款上衣秋季女2023春季新款设计感不规则白色长袖恤打底衫亚马逊",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01NqcxKT1keJVgxmXbZ_!!2215747404708-0-cib.jpg",
				"promotion_price": "15.11",
				"price": "15.11",
				"sales": 13,
				"turnover": "200+",
				"num_iid": "715342460673",
				"seller_nick": "广州桂凯电子商行",
				"tag_percent": "10%",
				"area": "广州市",
				"detail_url": "https://detail.1688.com/offer/715342460673.html"
			},
			{
				"title": "ins设计感打底衫连帽长袖T恤网红超火上衣女秋冬季新款高腰女装",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN0176ccL71vA365aq7TO_!!2215522636131-0-cib.jpg",
				"promotion_price": "15.11",
				"price": "15.11",
				"sales": 84,
				"turnover": "100+",
				"num_iid": "706346656155",
				"seller_nick": "姑苏区阅年秦贸易商行",
				"tag_percent": "8%",
				"area": "苏州市",
				"detail_url": "https://detail.1688.com/offer/706346656155.html"
			},
			{
				"title": "方领套头条纹短袖针织衫女春季韩版百搭修身显瘦短款小个子上衣女",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN011FT2tz1MWTwJ8fi5f_!!3896171442-0-cib.jpg",
				"promotion_price": "13.21",
				"price": "13.21",
				"sales": 857,
				"turnover": "700+",
				"num_iid": "702670416738",
				"seller_nick": "东莞市大朗百优服饰厂",
				"tag_percent": "21%",
				"area": "东莞市",
				"detail_url": "https://detail.1688.com/offer/702670416738.html"
			},
			{
				"title": "宽松白色T恤女装纯棉短袖夏季甜美港风chic复古印花半袖正肩上衣",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01Q4R2sF1lmqTZdBKk2_!!2212511504862-0-cib.jpg",
				"promotion_price": "12.26",
				"price": "12.26",
				"sales": 1023,
				"turnover": "4000+",
				"num_iid": "698475298926",
				"seller_nick": "广州市伊念服装厂",
				"tag_percent": "16%",
				"area": "广州市",
				"detail_url": "https://detail.1688.com/offer/698475298926.html"
			},
			{
				"title": "欧洲站女装2023春季新款提花网衣性感辣妹镂空超弹紧身提臀连体裤",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01m4peeH1u0bHH2j7Rc_!!2200723965975-0-cib.jpg",
				"promotion_price": "15.11",
				"price": "15.11",
				"sales": 1990,
				"turnover": "900+",
				"num_iid": "687476384705",
				"seller_nick": "广州市多蕾丝服装商行",
				"tag_percent": "43%",
				"area": "广州市",
				"detail_url": "https://detail.1688.com/offer/687476384705.html"
			},
			{
				"title": "夏季韩版女装长款T恤裙闺蜜显瘦宽松时尚中长款短袖直筒连衣裙潮",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01Be8eLc1rvtwxjw16a_!!2213946195694-0-cib.jpg",
				"promotion_price": "15.11",
				"price": "15.11",
				"sales": 21163,
				"turnover": "1万+",
				"num_iid": "672411208708",
				"seller_nick": "深圳市宝安区优米莉服饰商行",
				"tag_percent": "21%",
				"area": "深圳市",
				"detail_url": "https://detail.1688.com/offer/672411208708.html"
			},
			{
				"title": "2022新款300斤大码女装冰丝螺纹短裤短袖女时尚宽松显瘦两件套装",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01ajbUrz26g4UJGeB3O_!!3041327690-0-cib.jpg",
				"promotion_price": "15.11",
				"price": "15.11",
				"sales": 2095,
				"turnover": "3000+",
				"num_iid": "670314667851",
				"seller_nick": "深圳市依蝶妮服装有限公司",
				"tag_percent": "27%",
				"area": "普宁市",
				"detail_url": "https://detail.1688.com/offer/670314667851.html"
			},
			{
				"title": "S-5XL大码2022春夏新款女冰丝轻阔腿裤纯色高腰宽松百搭直筒裤裙",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01ATmRvN1fFVtzPxIFJ_!!2212942603977-0-cib.jpg",
				"promotion_price": "15.11",
				"price": "15.11",
				"sales": 3829,
				"turnover": "600+",
				"num_iid": "668175932246",
				"seller_nick": "东莞市凌羽服饰有限公司",
				"tag_percent": "34%",
				"area": "东莞市",
				"detail_url": "https://detail.1688.com/offer/668175932246.html"
			},
			{
				"title": "2023夏季新款莫代尔宅宅裤女时尚休闲纯色下装字母打底外穿九分裤",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/2020/081/024/13840420180_831628275.jpg",
				"promotion_price": "14.25",
				"price": "14.25",
				"sales": 1522,
				"turnover": "300+",
				"num_iid": "613615436479",
				"seller_nick": "青岛亿美缘制衣有限公司",
				"tag_percent": "22%",
				"area": "青岛市",
				"detail_url": "https://detail.1688.com/offer/613615436479.html"
			},
			{
				"title": "趋势热卖",
				"pic_url": null,
				"promotion_price": null,
				"price": null,
				"sales": null,
				"turnover": null,
				"num_iid": null,
				"seller_nick": null,
				"tag_percent": null,
				"area": null,
				"detail_url": "https://detail.1688.com/offer/.html"
			},
			{
				"title": "宽松大码5分袖胖妈妈夏季上衣女洋气女装加肥加大210斤针织衫",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01V98Vj61cR104dPjF4_!!2212552393596-0-cib.jpg",
				"promotion_price": "15.16",
				"price": "15.16",
				"sales": 212,
				"turnover": "100+",
				"num_iid": "671437452788",
				"seller_nick": "武汉市贝可特日用品商行",
				"tag_percent": "16%",
				"area": "武汉市",
				"detail_url": "https://detail.1688.com/offer/671437452788.html"
			},
			{
				"title": "2023时尚简约假两件夏季碎花连衣裙短袖V领夏装学生流行衣服批发",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/2020/684/508/13320805486_1715061393.jpg",
				"promotion_price": "13.23",
				"price": "13.23",
				"sales": 1309,
				"turnover": "800+",
				"num_iid": "574988933808",
				"seller_nick": "深圳市鑫银胜贸易有限公司",
				"tag_percent": "27%",
				"area": "深圳市",
				"detail_url": "https://detail.1688.com/offer/574988933808.html"
			},
			{
				"title": "2023新款夏季气质连衣裙女修身长裙收腰显瘦休闲开叉纯色长裙",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01DfnWap1IfPDAIwphQ_!!2845640920-0-cib.jpg",
				"promotion_price": "13.30",
				"price": "13.30",
				"sales": 137,
				"turnover": "2000+",
				"num_iid": "712895740429",
				"seller_nick": "深圳市上林宛贸易有限公司",
				"tag_percent": "27%",
				"area": "普宁市",
				"detail_url": "https://detail.1688.com/offer/712895740429.html"
			},
			{
				"title": "掌柜推荐!连衣裙女小个子背带裙2023新款仙女裙大口袋奶茶店围裙",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01dHzq6L1dxMgYtVIvl_!!2215550813802-0-cib.jpg",
				"promotion_price": "13.68",
				"price": "13.68",
				"sales": 136,
				"turnover": "1000+",
				"num_iid": "708281406211",
				"seller_nick": "东莞市虎门晨亦电子商务商行",
				"tag_percent": "18%",
				"area": "东莞市",
				"detail_url": "https://detail.1688.com/offer/708281406211.html"
			},
			{
				"title": "女装V领T恤欧美跨境时尚宽松3D印花上衣亚马逊独立站源头工厂制作",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01O6rfqI1fzlyZRBw2h_!!2215425224078-0-cib.jpg",
				"promotion_price": "13.30",
				"price": "13.30",
				"sales": 11,
				"turnover": "200+",
				"num_iid": "707146103147",
				"seller_nick": "铅山县武曌服装有限公司",
				"tag_percent": "30%",
				"area": "铅山县",
				"detail_url": "https://detail.1688.com/offer/707146103147.html"
			},
			{
				"title": "2023新款方领短款简约百搭休闲纯色体恤正肩纯欲韩版打底T恤衫上",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01NgP6JA1nfdUNiALBz_!!2215531875117-0-cib.jpg",
				"promotion_price": "15.20",
				"price": "15.20",
				"sales": 828,
				"turnover": "1000+",
				"num_iid": "706672370136",
				"seller_nick": "佛山市禅城区琬欣服装厂",
				"tag_percent": "13%",
				"area": "佛山市",
				"detail_url": "https://detail.1688.com/offer/706672370136.html"
			},
			{
				"title": "薄款长袖防晒衫女2023夏季新款ins泫雅风网纱打底衫女冰丝内搭T恤",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01vUrsoY22jV3ZIjLCD_!!2215063087156-0-cib.jpg",
				"promotion_price": "15.20",
				"price": "15.20",
				"sales": 15,
				"turnover": "100+",
				"num_iid": "702456676981",
				"seller_nick": "上海辰多里商贸中心",
				"tag_percent": "30%",
				"area": "上海市",
				"detail_url": "https://detail.1688.com/offer/702456676981.html"
			},
			{
				"title": "不规则短款T恤女装2022夏季纯欲辣妹u领漏锁骨修身短袖螺纹上衣潮",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN015t0L972JUhgdh2oeS_!!2204599425-0-cib.jpg",
				"promotion_price": "13.78",
				"price": "13.78",
				"sales": 943,
				"turnover": "3000+",
				"num_iid": "678136314229",
				"seller_nick": "汕头市潮南区陈店鹏发服装厂",
				"tag_percent": "22%",
				"area": "普宁市",
				"detail_url": "https://detail.1688.com/offer/678136314229.html"
			},
			{
				"title": "韩版网红短裤女夏季2022新款百搭高腰显瘦宽松阔腿外穿休闲裤子潮",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01QgWKYe1q5rKXFmL0v_!!2213793835445-0-cib.jpg",
				"promotion_price": "11.40",
				"price": "11.40",
				"sales": 3536,
				"turnover": "3000+",
				"num_iid": "676836677878",
				"seller_nick": "揭阳市揭东区桂岭镇展松电子商务经营部",
				"tag_percent": "19%",
				"area": "揭阳市",
				"detail_url": "https://detail.1688.com/offer/676836677878.html"
			},
			{
				"title": "2023扎染网纱防晒上衣女冰丝薄款透视长袖T恤罩衫",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01eqHwaU1oBh7yZGPGE_!!3823835187-0-cib.jpg",
				"promotion_price": "13.21",
				"price": "13.21",
				"sales": 824,
				"turnover": "2000+",
				"num_iid": "666282068455",
				"seller_nick": "广州花间婷服饰有限公司",
				"tag_percent": "31%",
				"area": "普宁市",
				"detail_url": "https://detail.1688.com/offer/666282068455.html"
			},
			{
				"title": "时尚妈妈装格子长袖衬衫中老年女装春秋装2021新款大码宽松上衣女",
				"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01cHrr4R1i6Ijp0AykA_!!2206994834363-0-cib.jpg",
				"promotion_price": "14.25",
				"price": "14.25",
				"sales": 3372,
				"turnover": "1万+",
				"num_iid": "654925074779",
				"seller_nick": "寻乌县臻美制衣厂",
				"tag_percent": "30%",
				"area": "赣州市",
				"detail_url": "https://detail.1688.com/offer/654925074779.html"
			}
		],
		"data_from": "ti"
	},
	"error_code": "0000",
	"reason": "ok",
	"secache": "f3169c714a064343dac5321a7070e76c",
	"secache_time": 1686109848,
	"secache_date": "2023-06-07 11:50:48",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"error": "",
	"cache": 0,
	"api_info": "today:24 max:10000 all[56=24+7+25];expires:2030-12-31",
	"execution_time": "2.228",
	"server_time": "Beijing/2023-06-07 11:50:48",
	"client_ip": "106.6.35.175",
	"call_args": {
		"q": "女装",
		"start_price": "0",
		"end_price": "0",
		"page": "1",
		"cat": "0",
		"page_size": "40"
	},
	"api_type": "1688",
	"translate_language": "zh-CN",
	"translate_engine": "baidu",
	"server_memory": "1.3MB",
	"request_id": "gw-4.647ffe9613b90",
	"last_id": "1790845683"
}

 文章内容有限,欢迎广大码友私信沟通交流!