抖音根据关键词取商品列表 API 返回值说明

245 阅读6分钟

请求参数:q=连衣裙&page=1&sort=

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

image.png

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": "【整箱150个】三包共150只加厚一次性纸杯 家用商用办公必备",
				"pic_url": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/LosxFZUm_m_0601e88169a79f0e59e9dbae1b36a398_sx_60082_www800-800",
				"promotion_price": 0.1,
				"price": 0.1,
				"sales": 3303450,
				"num_iid": "3572695561553450331",
				"shop_name": "完美生活家居店",
				"shop_id": 40853012,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3572695561553450331&pick_source=MDh6j9Q"
			},
			{
				"title": "【居家好物】家用一次性杯子一次性纸杯子水杯 9.9元150只整箱",
				"pic_url": "https://p6-aio.ecombdimg.com/obj/ecom-shop-material/v1_wIRFkNaB_71123570879249943190884_bfd4e1bffee6b116d669863eab9af0d1_sx_156955_www800-800",
				"promotion_price": 0.1,
				"price": 0.1,
				"sales": 2858102,
				"num_iid": "3556158687326406814",
				"shop_name": "智选精品供应链个体店",
				"shop_id": 52379884,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3556158687326406814&pick_source=MDMvtdw"
			},
			{
				"title": "【琴叔宠粉专属】三包共150只加厚一次性纸杯 家用待客办公商用",
				"pic_url": "https://p9-aio.ecombdimg.com/obj/ecom-shop-material/LosxFZUm_m_d69b18038854708b5133e9a088853fab_sx_128315_www1109-1109",
				"promotion_price": 0.1,
				"price": 0.1,
				"sales": 1940250,
				"num_iid": "3573288883468764204",
				"shop_name": "完美生活家居店",
				"shop_id": 40853012,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3573288883468764204&pick_source=MDhSu2C"
			},
			{
				"title": "桔页【加厚商务格子150只】家用一次性纸杯只要9.9元水杯",
				"pic_url": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/skDKUqPW_m_ad54aad44f3c986e15b96c8781d38340_sx_298391_www800-800",
				"promotion_price": 0.08,
				"price": 0.08,
				"sales": 1671900,
				"num_iid": "3573953108742685323",
				"shop_name": "桔页企业店",
				"shop_id": 33669853,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3573953108742685323&pick_source=MDhesCd"
			},
			{
				"title": "【张小云专属】家用商务一次性纸杯9.9元150只 3大包整箱水杯",
				"pic_url": "https://p9-aio.ecombdimg.com/obj/ecom-shop-material/wIRFkNaB_m_d7878f6ec54296ae32ab9c5f84169cc5_sx_321485_www800-800",
				"promotion_price": 9.9,
				"price": 9.9,
				"sales": 1138068,
				"num_iid": "3574306773470964446",
				"shop_name": "智选精品供应链个体店",
				"shop_id": 52379884,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3574306773470964446&pick_source=MDhhAc8"
			},
			{
				"title": "【粉丝福利 家用一次性纸杯水杯 一次性茶杯9.9元150只水杯",
				"pic_url": "https://p9-aio.ecombdimg.com/obj/ecom-shop-material/wIRFkNaB_m_d7878f6ec54296ae32ab9c5f84169cc5_sx_321485_www800-800",
				"promotion_price": 0.1,
				"price": 0.1,
				"sales": 980236,
				"num_iid": "3573233594270904964",
				"shop_name": "智选精品供应链个体店",
				"shop_id": 52379884,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3573233594270904964&pick_source=MDhYdMR"
			},
			{
				"title": "【璐璐糖专享】加厚兔年一次性纸杯9.9元整箱150只杯子图案随机发",
				"pic_url": "https://p9-aio.ecombdimg.com/obj/ecom-shop-material/hhdvJxXQ_m_9f746e024b5cfcb8ab0bda477753efa3_sx_58727_www800-800",
				"promotion_price": 0.1,
				"price": 0.1,
				"sales": 847638,
				"num_iid": "3572513398929365454",
				"shop_name": "享生活家居馆",
				"shop_id": 59742265,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3572513398929365454&pick_source=MDhUVuL"
			},
			{
				"title": "【纸箱包装】兔年加厚一次性纸杯9.9元整箱150只杯子图案随机发",
				"pic_url": "https://p9-aio.ecombdimg.com/obj/ecom-shop-material/hhdvJxXQ_m_9f746e024b5cfcb8ab0bda477753efa3_sx_58727_www800-800",
				"promotion_price": 9.9,
				"price": 9.9,
				"sales": 705210,
				"num_iid": "3571951170530465136",
				"shop_name": "享生活家居馆",
				"shop_id": 59742265,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3571951170530465136&pick_source=MDrEnKf"
			},
			{
				"title": "智选好物】9.9元150只 一次性纸杯水杯 一次性水杯 家居好茶杯",
				"pic_url": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/wIRFkNaB_m_68c561c06d22eee3151a0ddf309c01f3_sx_268630_www800-800",
				"promotion_price": 9.9,
				"price": 9.9,
				"sales": 526690,
				"num_iid": "3574532046753809713",
				"shop_name": "智选精品供应链个体店",
				"shop_id": 52379884,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3574532046753809713&pick_source=MDhjf65"
			},
			{
				"title": "【4大包加厚纸杯】一次性纸杯家用一次性杯子210ml工厂直销120只",
				"pic_url": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/skDKUqPW_m_c586a5824a20506fbb30015cad7de0ad_sx_273408_www800-800",
				"promotion_price": 0.1,
				"price": 0.1,
				"sales": 440640,
				"num_iid": "3572646502272730415",
				"shop_name": "桔页企业店",
				"shop_id": 33669853,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3572646502272730415&pick_source=MDh8LQP"
			},
			{
				"title": "小茶日记【小杨哥专属】316宇航熊儿童学生保温杯弹盖吸管500ML",
				"pic_url": "https://p6-aio.ecombdimg.com/obj/ecom-shop-material/v1_yCdBNHNE_71170805122958789240926_585726d10e30762d4bf67156d6793c58_sx_408263_www1000-1000",
				"promotion_price": 39.8,
				"price": 39.8,
				"sales": 729121,
				"num_iid": "3562166436057236310",
				"shop_name": "小茶日记官方旗舰店",
				"shop_id": 22135926,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3562166436057236310&pick_source=MDhBgva"
			},
			{
				"title": "【粉丝福利】加厚一次性纸杯茶杯9.9元150只 水杯家居日用 办公",
				"pic_url": "https://p6-aio.ecombdimg.com/obj/ecom-shop-material/v1_wIRFkNaB_71123570879249943190884_bfd4e1bffee6b116d669863eab9af0d1_sx_156955_www800-800",
				"promotion_price": 9.9,
				"price": 9.9,
				"sales": 178596,
				"num_iid": "3573434712573800962",
				"shop_name": "智选精品供应链个体店",
				"shop_id": 52379884,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3573434712573800962&pick_source=MDhJErw"
			},
			{
				"title": "【熊宝专属】加厚一次性纸杯 9.9元150只 家用办公一次性水杯",
				"pic_url": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/v1_wIRFkNaB_71123570772143475610884_a8812f9e5020375bdb583a7d9a65bc99_sx_189671_www800-800",
				"promotion_price": 9.9,
				"price": 9.9,
				"sales": 157242,
				"num_iid": "3573254731994380144",
				"shop_name": "智选精品供应链个体店",
				"shop_id": 52379884,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3573254731994380144&pick_source=MDhrxHE"
			},
			{
				"title": "【发150只】三包共150只加厚一次性纸杯 聚餐家用待客办公必备",
				"pic_url": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/LosxFZUm_m_83f0b1e982531fe3786ac4d6026d3251_sx_70584_www800-800",
				"promotion_price": 9.9,
				"price": 9.9,
				"sales": 143621,
				"num_iid": "3563228538670817451",
				"shop_name": "完美生活家居店",
				"shop_id": 40853012,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3563228538670817451&pick_source=MDhFr3K"
			},
			{
				"title": "桔页【直播间专属】一次性加厚加硬纸杯210ml共150只杯子",
				"pic_url": "https://p6-aio.ecombdimg.com/obj/ecom-shop-material/skDKUqPW_m_12784f5f4bfe5c392258c5b20c23bb9e_sx_1484113_www1000-1000",
				"promotion_price": 0.08,
				"price": 0.08,
				"sales": 129000,
				"num_iid": "3573824006270402293",
				"shop_name": "桔页企业店",
				"shop_id": 33669853,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3573824006270402293&pick_source=MDhDcYo"
			},
			{
				"title": "【100只装】家用一次性纸杯子商用咖啡加厚饮水杯",
				"pic_url": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/paocqqdZ_m_04efeaa9e2dcc99ce2969a4d4e4dde76_sx_472034_www800-800",
				"promotion_price": 0.1,
				"price": 0.1,
				"sales": 332950,
				"num_iid": "3564925394266254802",
				"shop_name": "禾欣优选",
				"shop_id": 38816882,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3564925394266254802&pick_source=MDh1UCq"
			},
			{
				"title": "【4大包一整箱】一次性纸杯 茶道杯加厚120只纸杯子家用喝水杯",
				"pic_url": "https://p9-aio.ecombdimg.com/obj/ecom-shop-material/IZWyRtDU_m_385e7947413a6e2a82a243e494eb1837_sx_266355_www800-800",
				"promotion_price": 0.1,
				"price": 0.1,
				"sales": 96360,
				"num_iid": "3575286142104394046",
				"shop_name": "清河源企业店",
				"shop_id": 50455781,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3575286142104394046&pick_source=MDh6ocg"
			},
			{
				"title": "【第三代升级款】懒人全自动搅拌杯304不锈钢便携式磁力咖啡杯",
				"pic_url": "https://p9-aio.ecombdimg.com/obj/ecom-shop-material/fIcjIGcp_m_af5313786212a09e721538b9ca960a55_sx_44983_www800-800",
				"promotion_price": 29.9,
				"price": 29.9,
				"sales": 92880,
				"num_iid": "3569536819190210489",
				"shop_name": "松昂优品智能工厂店",
				"shop_id": 59513175,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3569536819190210489&pick_source=MDhLbMb"
			},
			{
				"title": "【速立达2】升级款316不锈钢保温杯",
				"pic_url": "https://p9-aio.ecombdimg.com/obj/ecom-shop-material/v1_tyRvhHeS_70978390549476313990124_2fd15a720d4d7b7bc9bb69190bb94c04_sx_654897_www800-800",
				"promotion_price": 29,
				"price": 29,
				"sales": 206425,
				"num_iid": "3511617395854817996",
				"shop_name": "速立达餐饮具旗舰店",
				"shop_id": 8430124,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3511617395854817996&pick_source=MDhAkup"
			},
			{
				"title": "【粉丝优享】一次性纸杯 加厚茶杯 9.9元150只 家居生活日用办公",
				"pic_url": "https://p9-aio.ecombdimg.com/obj/ecom-shop-material/wIRFkNaB_m_d7878f6ec54296ae32ab9c5f84169cc5_sx_321485_www800-800",
				"promotion_price": 9.9,
				"price": 9.9,
				"sales": 66401,
				"num_iid": "3573085804463034896",
				"shop_name": "智选精品供应链个体店",
				"shop_id": 52379884,
				"detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3573085804463034896&pick_source=MDhdHw2"
			}
		],
		"_ddf": "xpgj"
	},
	"error_code": "0000",
	"reason": "ok",
	"secache": "6818ea916d6594496364c5560e9db8af",
	"secache_time": 1666074330,
	"secache_date": "2022-10-18 14:25:30",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"error": "",
	"cache": 0,
	"api_info": "today:50 max:10000 all[123=50+34+39];expires:2030-12-31",
	"execution_time": "0.598",
	"server_time": "Beijing/2022-10-18 14:25:30",
	"client_ip": "106.6.38.170",
	"call_args": {
		"q": "水杯",
		"start_price": "1"
	},
	"api_type": "douyin",
	"translate_language": "zh-CN",
	"translate_engine": "baidu",
	"server_memory": "3.16MB",
	"request_id": "gw-1.634e46d97cedb",
	"last_id": "1291235957"
}