API接口名称(item_search - 根据关键词取商品列表)[item_search,item_get,item_search_shop等]

434 阅读6分钟

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

名称类型必须描述
keyString调用key(必须以GET方式拼接在URL中)
secretString调用密钥
api_nameStringAPI接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等]
cacheString[yes,no]默认yes,将调用缓存的数据,速度比较快
result_typeString[json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读
langString[cn,en,ru]翻译语言,默认cn简体中文
versionStringAPI版本

请求参数

请求参数:q=眼镜&page=1&sort=

参数说明:q:关键词,
filter:搜索类型:filter=video 搜索视频、filter=goods 搜索商品、filter=user 搜索用户,
page:页数
sort:排序(目前只视频可排序):sort=new 最新发布 sort=credit 最多点赞 sort=bid 综合排序

API测试工具 点击申请试用

响应参数

Version: Date:

名称类型必须示例值描述
itemsitems[]0按关键字搜索商品
pageInt01页码
real_total_resultsInt01900宝贝数量
total_resultsInt01900宝贝数量
page_sizeInt020接口返回数量
pagecountInt0120总页数
itemitem[]0宝贝详情数据

请求示例

<?php

// 请求示例 url 默认请求参数已经URL编码处理
// 本示例代码未加密secret参数明文传输,若要加密请参考:https://open.onebound.cn/help/demo/sdk/demo-sign.php
$method = "GET";
$url = "https://api-gw.onebound.cn/douyin/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=眼镜&page=1&sort=";
$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",
		"real_total_results": 500,
		"total_results": 500,
		"page_size": 20,
		"pagecount": 25,
		"item": [
			{
				"title": "洁の良品防雾眼镜湿巾擦拭镜片手机屏幕头盔不起雾防哈气清洁神器",
				"pic_url": "https://p9-aio.ecombdimg.com/obj/ecom-shop-material/gVDPAFMM_m_3a1fcc8f843a737f462b0299b301f194_sx_522904_www800-800",
				"promotion_price": 19.8,
				"price": 19.8,
				"sales": 124335,
				"num_iid": "3572863239199044780",
				"shop_name": "悟空优品精选",
				"shop_id": 21026855,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3572863239199044780&pick_source=MfhueQD"
			},
			{
				"title": "【惠达】通用型眼镜气囊鼻托",
				"pic_url": "https://p9-aio.ecombdimg.com/obj/temai/16d42ea4277b3ac998b24d1b25e06844www800-800",
				"promotion_price": 9.9,
				"price": 9.9,
				"sales": 1172288,
				"num_iid": "3472514634311951872",
				"shop_name": "惠达严选",
				"shop_id": 11976237,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3472514634311951872&pick_source=Mfhp4vy"
			},
			{
				"title": "【超值100片装】眼镜清洁湿巾纸 除尘去油速干无痕擦拭镜片布屏幕",
				"pic_url": "https://p9-aio.ecombdimg.com/obj/ecom-shop-material/LhkzXJHT_m_c048ede004deed3d8005fe9e9d957999_sx_429885_www800-800",
				"promotion_price": 9.9,
				"price": 9.9,
				"sales": 60107,
				"num_iid": "3569544447119255774",
				"shop_name": "大杨优品精选",
				"shop_id": 28546813,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3569544447119255774&pick_source=MfhXA6U"
			},
			{
				"title": "【9.9元拍二发三】超值100片装眼镜清洁湿巾纸 除尘去油 速干无痕",
				"pic_url": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/RjYyHZIk_m_f19c1c4caad188d87dcd6a09356dacd0_sx_390311_www800-800",
				"promotion_price": 9.9,
				"price": 9.9,
				"sales": 147497,
				"num_iid": "3563776398265077772",
				"shop_name": "伦勋小店",
				"shop_id": 28316998,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3563776398265077772&pick_source=Mfh7Kmf"
			},
			{
				"title": "【血亏浮力损坏换新】防蓝光高清老花镜超轻可折叠镜架久戴不头晕",
				"pic_url": "https://p6-aio.ecombdimg.com/obj/ecom-shop-material/v1_yjApwIXz_70919261505405750140227_2d26d420b81a417985bdc4003a24b151_sx_202262_www800-800",
				"promotion_price": 9.9,
				"price": 9.9,
				"sales": 74161,
				"num_iid": "3554316270952404857",
				"shop_name": "靖驰",
				"shop_id": 12047227,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3554316270952404857&pick_source=MfhP8wp"
			},
			{
				"title": " 【买一送一】9.9元两副 摔不坏的老花镜 智能变焦 高清防蓝光",
				"pic_url": "https://p6-aio.ecombdimg.com/obj/ecom-shop-material/fZumyzNI_m_2c9ba951647f0a3c67a2c8d936cf57cb_sx_110534_www800-800",
				"promotion_price": 9.9,
				"price": 9.9,
				"sales": 51554,
				"num_iid": "3559874222765553627",
				"shop_name": "正合优选",
				"shop_id": 13063729,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3559874222765553627&pick_source=MfhVgjG"
			},
			{
				"title": "折叠钥匙扣老花镜伸缩折叠",
				"pic_url": "https://p6-aio.ecombdimg.com/obj/ecom-shop-material/ckOSYVNI_m_901be43e9bf1b8bba48fdbfc47aea087_sx_103254_www800-800",
				"promotion_price": 29.9,
				"price": 29.9,
				"sales": 98769,
				"num_iid": "3566191658116712210",
				"shop_name": "耶好个体店",
				"shop_id": 46253100,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3566191658116712210&pick_source=Mfh9yxs"
			},
			{
				"title": "卡通眼镜熊宽松上衣韩版ins学生百搭女装印花圆领卫衣553#",
				"pic_url": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/hzDqCMa_m_8178f07cb52b615df57f512f38530330_sx_193291_www1280-1280",
				"promotion_price": 29.99,
				"price": 29.99,
				"sales": 16661,
				"num_iid": "3572937861957302746",
				"shop_name": "源头服装供应链",
				"shop_id": 908762,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3572937861957302746&pick_source=Mfht17t"
			},
			{
				"title": "LOOKWAY一次性眼镜防雾湿巾擦拭纸速干持久防雾",
				"pic_url": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/REfCFsUm_m_6b4c5c621aaa53ef8754afa1f7c813de_sx_81622_www800-800",
				"promotion_price": 19.9,
				"price": 19.9,
				"sales": 33820,
				"num_iid": "3571762679481764454",
				"shop_name": "誉逸个体店",
				"shop_id": 45806532,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3571762679481764454&pick_source=MfhmrrM"
			},
			{
				"title": "【整盒100片装】眼镜清洁防雾湿巾布 除尘去油镜头车载屏幕后视镜",
				"pic_url": "https://p9-aio.ecombdimg.com/obj/ecom-shop-material/OcrQvScp_m_27a0d1eba11a3c75ffd6b74d2b302a16_sx_379194_www750-750",
				"promotion_price": 9.9,
				"price": 9.9,
				"sales": 30437,
				"num_iid": "3575260267073956126",
				"shop_name": "肆鱼百货供应链",
				"shop_id": 31196526,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3575260267073956126&pick_source=MfhgvHh"
			},
			{
				"title": "男女同款钛合金方框高清防蓝光平光眼镜➕眼镜盒➕眼镜布",
				"pic_url": "https://p3-aio.ecombdimg.com/obj/temai/1c7fa43a1e5b8113de6fec77f3750840www831-831",
				"promotion_price": 39.9,
				"price": 39.9,
				"sales": 135804,
				"num_iid": "3520925985941899588",
				"shop_name": "贤轩电子商务商行",
				"shop_id": 12340318,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3520925985941899588&pick_source=MfhC93r"
			},
			{
				"title": "半年抛 可啦啦好椰美瞳女隐形近视眼镜非日抛正品【品牌专享】",
				"pic_url": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/CvFkhHJ_m_62941ec32e35f354a4ad6d20945042f9_sx_447535_www800-800",
				"promotion_price": 109.9,
				"price": 109.9,
				"sales": 69956,
				"num_iid": "3558411938855793805",
				"shop_name": "可啦啦官方旗舰店",
				"shop_id": 5668549,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3558411938855793805&pick_source=Mfh7YYk"
			},
			{
				"title": "【西西专属】可啦啦 半年抛甄选系列彩色美瞳隐形眼镜2片",
				"pic_url": "https://p6-aio.ecombdimg.com/obj/ecom-shop-material/CvFkhHJ_m_9ee72b16a4e6669880c032f515b04052_sx_868652_www800-800",
				"promotion_price": 74.9,
				"price": 74.9,
				"sales": 22842,
				"num_iid": "3576755349409144264",
				"shop_name": "可啦啦官方旗舰店",
				"shop_id": 5668549,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3576755349409144264&pick_source=Mfh5qQo"
			},
			{
				"title": "miflame(顺丰包邮)太空铝镜头膜 鹰眼镜头膜 镜头保护膜 钢化膜",
				"pic_url": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/v1_hnVGngrj_70942457734830984010338_118185336ac9e32a2795e1465f995a54_sx_151544_www800-800",
				"promotion_price": 22.8,
				"price": 22.8,
				"sales": 115593,
				"num_iid": "3459072900559162441",
				"shop_name": "石头潮品数码店",
				"shop_id": 11011338,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3459072900559162441&pick_source=MfhbhcJ"
			},
			{
				"title": "【主播补贴】韩版太阳镜ins同款时尚墨镜男女同款hh",
				"pic_url": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/lNPFjENI_m_3cf908fa4f099b7b95e4155dc5bf53ee_sx_126779_www1109-1109",
				"promotion_price": 9.9,
				"price": 9.9,
				"sales": 20741,
				"num_iid": "3572508045353291475",
				"shop_name": "可可西里好物优选个体店",
				"shop_id": 54107309,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3572508045353291475&pick_source=MfhxoM1"
			},
			{
				"title": "隐形眼镜清洗器便携手动简约清洁美瞳收纳盒子小巧美瞳盒",
				"pic_url": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/v1_igeuolKx_71219610241149340500132_5303f971ab1decdc7284f08ad4e24a18_sx_356497_www800-800",
				"promotion_price": 29.9,
				"price": 29.9,
				"sales": 31058,
				"num_iid": "3557609265361504035",
				"shop_name": "童心精品",
				"shop_id": 15135132,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3557609265361504035&pick_source=MfhnQue"
			},
			{
				"title": "COFANCY/可糖半年抛 玉桂狗 大耳狗 彩色隐形眼镜 美瞳彩瞳2片/副",
				"pic_url": "https://p6-aio.ecombdimg.com/obj/ecom-shop-material/oRjrPRIP_m_e57b25b2095183fd46c2b4f826eaf46b_sx_126251_www1000-1000",
				"promotion_price": 139,
				"price": 139,
				"sales": 137936,
				"num_iid": "3519799946398274868",
				"shop_name": "COFANCY可糖旗舰店",
				"shop_id": 11443120,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3519799946398274868&pick_source=MfhuWTm"
			},
			{
				"title": "苹果手机壳13/12/11/13pro新款液态硅胶X/XS瞳眼镜头全包超薄防摔",
				"pic_url": "https://p6-aio.ecombdimg.com/obj/ecom-shop-material/v1_NUoiDJdq_70978567851637312370602_310730b6e59c8516d3ae19276e042e42_sx_38659_www800-800",
				"promotion_price": 1,
				"price": 1,
				"sales": 38313,
				"num_iid": "3548928412670419767",
				"shop_name": "星星3C数码个体店",
				"shop_id": 48448602,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3548928412670419767&pick_source=Mfh1gCj"
			},
			{
				"title": "【桔子】通用型眼镜气囊鼻托防压痕防滑超软",
				"pic_url": "https://p6-aio.ecombdimg.com/obj/ecom-shop-material/v1_cnnEhESf_70953613449541061150997_da5829ecfb7236e761b172908ed331e1_sx_225512_www800-800",
				"promotion_price": 9.9,
				"price": 9.9,
				"sales": 45188,
				"num_iid": "3547683731080890360",
				"shop_name": "桔子好物个体店",
				"shop_id": 41431997,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3547683731080890360&pick_source=Mfh4N9u"
			},
			{
				"title": "洁の良品眼镜清洁湿巾纸一次性擦眼镜布镜头镜片清洁湿巾",
				"pic_url": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/kNcOjJPA_m_0ca79b472eb646326be2dc836650ba69_sx_187968_www800-800",
				"promotion_price": 19.9,
				"price": 19.9,
				"sales": 17151,
				"num_iid": "3564933425972563864",
				"shop_name": "芬菲百货",
				"shop_id": 37952666,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3564933425972563864&pick_source=MfhvpW9"
			}
		],
		"_ddf": "xpgj"
	},
	"error_code": "0000",
	"reason": "ok",
	"secache": "b81e26cf47034af5eee4bda61fc10beb",
	"secache_time": 1666257142,
	"secache_date": "2022-10-20 17:12:22",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"error": "",
	"cache": 0,
	"api_info": "today:23 max:10000 all[103=23+33+47];expires:2030-12-31",
	"execution_time": "0.658",
	"server_time": "Beijing/2022-10-20 17:12:22",
	"client_ip": "117.162.192.171",
	"call_args": {
		"q": "眼镜",
		"start_price": "1"
	},
	"api_type": "douyin",
	"translate_language": "zh-CN",
	"translate_engine": "baidu",
	"server_memory": "3.16MB",
	"request_id": "gw-1.635110f58d343",
	"last_id": "1297055131"
}