一、关键词搜索抖音商品列表API接口通过代码对接可以拿到商品链接,商品视频,商品列表,商品sku信息,卖家昵称,价格,优惠价,页码,宝贝数量等参数,代码对接如下:
1.公共参数
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| key | String | 是 | 调用key(必须以GET方式拼接在URL中) |
| secret | String | 是 | 调用密钥 (点击获取key 和secret) |
| 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版本 |
2.请求参数
请求参数:q=连衣裙&page=1&sort=
参数说明:q:关键词,
filter:搜索类型:filter=video 搜索视频、filter=goods 搜索商品、filter=user 搜索用户,
page:页数
sort:排序(目前只视频可排序):sort=new 最新发布 sort=credit 最多点赞 sort=bid 综合排序
3.响应参数
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| items | items[] | 0 | 按关键字搜索商品 | |
| page | Int | 0 | 1 | 页码 |
| real_total_results | Int | 0 | 1900 | 宝贝数量 |
| total_results | Int | 0 | 1900 | 宝贝数量 |
| page_size | Int | 0 | 20 | 接口返回数量 |
| pagecount | Int | 0 | 120 | 总页数 |
| item | item[] | 0 | 宝贝详情数据 | |
| title | String | 0 | 【清子】显瘦小蛮腰~新款定制设计春装卫衣连衣裙L0788 | 商品标题 |
| pic_url | String | 0 | https://p6-aio.ecombdimg.com/obj/ecom-shop-material/v1_cbrNegKF_70732696448192514710931_f48788ff100d9afb00d63ed437357f29_sx_920709_www2891-2891 | 宝贝图片 |
| promotion_price | Float | 0 | 169.00 | 优惠价 |
| price | Float | 0 | 169.00 | 价格 |
| sales | Int | 0 | 17872 | 销量 |
| num_iid | Bigint | 0 | 3536467110454782000 | 宝贝ID |
| shop_name | String | 0 | MDNW服饰 | 卖家昵称 |
| detail_url | String | 0 | https://haohuo.jinritemai.com/views/product/item2?id=3536467110454782196&pick_source=Nvt7YLu | 商品链接 |
4.请求参数(CURL、PHP 、PHPsdk 、Java 、C# 、Python...)
- # coding:utf-8
- """
- Compatible for python2.x and python3.x
- requirement: pip install requests
- """
- from __future__ import print_function
- import requests
- # 请求示例 url 默认请求参数已经做URL编码
- url = "https://vx19970108018/douyin/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=连衣裙&page=1&sort="
- headers = {
- "Accept-Encoding": "gzip",
- "Connection": "close"
- }
- if __name__ == "__main__":
- r = requests.get(url, headers=headers)
- json_obj = r.json()
- print(json_obj)
5.响应示例
- {
- "items": {
- "page": "1",
- "real_total_results": 500,
- "total_results": 500,
- "page_size": 20,
- "pagecount": 25,
- "item": [
- {
- "title": "【清子】显瘦小蛮腰~新款定制设计春装卫衣连衣裙L0788",
- "pic_url": "https://p6-aio.ecombdimg.com/obj/ecom-shop-material/v1_cbrNegKF_70732696448192514710931_f48788ff100d9afb00d63ed437357f29_sx_920709_www2891-2891",
- "promotion_price": 169,
- "price": 169,
- "sales": 17872,
- "num_iid": 3536467110454782000,
- "shop_name": "MDNW服饰",
- "shop_id": 9088931,
- "detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3536467110454782196&pick_source=Nvt7YLu"
- },
- {
- "title": "【诗雨推荐】时尚气质休闲连衣裙",
- "pic_url": "https://p9-aio.ecombdimg.com/obj/ecom-shop-material/v1_yjSJQYM_70770131096798824990399_b8a44fa0240e628775f3b8c4fbee085d_sx_342317_www782-782",
- "promotion_price": 59.9,
- "price": 59.9,
- "sales": 19871,
- "num_iid": 3536848829968219000,
- "shop_name": "星辰服饰店铺",
- "shop_id": 6970399,
- "detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3536848829968218897&pick_source=NvndGU9"
- },
- {
- "title": "晶咕 蕾蕾宠粉LL&JINGU/「不挑人」V领显瘦撞色设计的连衣裙",
- "pic_url": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/v1_yAcTOwNE_70755344657952115580027_9faedfb6047eaf1a87f6cabde09476a7_sx_245846_www1080-1080",
- "promotion_price": 159,
- "price": 159,
- "sales": 15298,
- "num_iid": 3537767536399665700,
- "shop_name": "晶咕旗舰店",
- "shop_id": 27226027,
- "detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3537767536399665722&pick_source=Nvtt1n1"
- },
- {
- "title": "TONGXUAN/同瑄春夏季新款碎花连衣裙0313.2058",
- "pic_url": "https://p6-aio.ecombdimg.com/obj/ecom-shop-material/v1_uEvMYbQo_70745289030580472430369_27dd8add86a7996ef8e397d401099068_sx_218598_www1170-1170",
- "promotion_price": 159.9,
- "price": 159.9,
- "sales": 6001,
- "num_iid": 3537264606424760000,
- "shop_name": "晟达服饰",
- "shop_id": 34202369,
- "detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3537264606424759942&pick_source=Nvn1XRe"
- },
- {
- "title": "【清子】时尚无敌 ~新款定制 链条卫衣连衣裙L0789",
- "pic_url": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/v1_cbrNegKF_70773595225615240000931_886c00ad1ebeab7423044faa9524d549_sx_701912_www2761-2761",
- "promotion_price": 149,
- "price": 149,
- "sales": 14638,
- "num_iid": 3537798859512253400,
- "shop_name": "MDNW服饰",
- "shop_id": 9088931,
- "detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3537798859512253339&pick_source=Nvt3BPJ"
- },
- {
- "title": "Lenakids 22夏季 蝴蝶结爱心公主连衣裙22022503",
- "pic_url": "https://p6-aio.ecombdimg.com/obj/ecom-shop-material/v1_ejmsuggl_70752756065601129260328_fd86404f26cb6d2e2d70daa3ca80a132_sx_485473_www1920-1920",
- "promotion_price": 129,
- "price": 129,
- "sales": 17406,
- "num_iid": 3537637931424610000,
- "shop_name": "莉娜kids-YG店",
- "shop_id": 36857328,
- "detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3537637931424609759&pick_source=NvnLTgd"
- },
- {
- "title": "女童夏季连衣裙2022新款碎花泡泡袖公主裙夏女宝宝夏装短袖裙子",
- "pic_url": "https://p9-aio.ecombdimg.com/obj/temai/af695f0729ae83a24c325bcfd5aec192www800-800",
- "promotion_price": 19.9,
- "price": 19.9,
- "sales": 33642,
- "num_iid": 3534622230833180000,
- "shop_name": "萌小兜童装工厂店",
- "shop_id": 14088342,
- "detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3534622230833179994&pick_source=NvtgRFD"
- },
- {
- "title": "Disney/迪士尼儿童碎花两件套连衣裙XFW1BZ115①",
- "pic_url": "https://p3-aio.ecombdimg.com/obj/temai/efcf9481abd785adc282276ee7fac9e3www800-800",
- "promotion_price": 139.9,
- "price": 139.9,
- "sales": 14398,
- "num_iid": 3533677142598661000,
- "shop_name": "Disney小店",
- "shop_id": 9944359,
- "detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3533677142598661014&pick_source=Nvtwqfy"
- },
- {
- "title": "初为家 春季新品银杏叶印花自带腰带连衣裙 - 9966#",
- "pic_url": "https://p6-aio.ecombdimg.com/obj/temai/397bdc8c8631c4255cf1fb96a8b3d490www1080-1080",
- "promotion_price": 6666,
- "price": 6666,
- "sales": 11775,
- "num_iid": 3532954784934043000,
- "shop_name": "初为时尚大码女装",
- "shop_id": 699303,
- "detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3532954784934042902&pick_source=NvtWDtU"
- },
- {
- "title": "心动粉黛连衣裙XZ2090",
- "pic_url": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/v1_PzFHhbHs_70818007540879526520081_c791eaf5449f2e05e1e3d847aac8552b_sx_177192_www1079-1079",
- "promotion_price": 199,
- "price": 199,
- "sales": 10894,
- "num_iid": 3540451021136484400,
- "shop_name": "YINZ小银子女装",
- "shop_id": 12839081,
- "detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3540451021136484138&pick_source=NvtG65c"
- },
- {
- "title": "圆脸酥新款显瘦牛仔连衣裙 送同款腰链",
- "pic_url": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/v1_UzNjkRcp_70845668187397491550759_6a3a5112365b685c464ed55396c10ee8_sx_207425_www800-800",
- "promotion_price": 129.9,
- "price": 129.9,
- "sales": 17698,
- "num_iid": 3541937150696256000,
- "shop_name": "圆脸酥服装工厂",
- "shop_id": 12306759,
- "detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3541937150696256191&pick_source=NvtoWpT"
- },
- {
- "title": "2022年精梳莫代尔家居服睡裙V字百褶设计连衣裙1059",
- "pic_url": "https://p9-aio.ecombdimg.com/obj/temai/bbc089c8205f78211d4830d7167be0f5www800-800",
- "promotion_price": 35,
- "price": 35,
- "sales": 42535,
- "num_iid": 3509952969334515000,
- "shop_name": "大荣服装店",
- "shop_id": 4378674,
- "detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3509952969334514955&pick_source=NvnGMKR"
- },
- {
- "title": "TONGXUAN/同瑄春夏季新款连衣裙0312.2041",
- "pic_url": "https://p9-aio.ecombdimg.com/obj/ecom-shop-material/v1_uEvMYbQo_70741570862837271390369_1bd285f4891ba56efeccee4753239110_sx_171847_www1170-1170",
- "promotion_price": 149.9,
- "price": 149.9,
- "sales": 4261,
- "num_iid": 3537078793221058000,
- "shop_name": "晟达服饰",
- "shop_id": 34202369,
- "detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3537078793221057827&pick_source=NvnLNDw"
- },
- {
- "title": "【大喜自制】CP裙连衣裙优雅气质长裙",
- "pic_url": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/v1_uvMttNQo_70770253450812623700320_2551e5b1fd36e1ed1f3d5cdf4d5cb722_sx_82756_www600-600",
- "promotion_price": 359,
- "price": 359,
- "sales": 11118,
- "num_iid": 3536498199617493500,
- "shop_name": "大喜女装店",
- "shop_id": 31046320,
- "detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3536498199617493444&pick_source=Nvtp4nX"
- },
- {
- "title": "仙女定制·韩版收腰设计感POLO领显瘦连衣裙6687#",
- "pic_url": "https://p9-aio.ecombdimg.com/obj/ecom-shop-material/v1_BmscpSV_70786600292214377080577_3fc24c8158db19f069fb1a6ef4a520e0_sx_908521_www1440-1681",
- "promotion_price": 39.9,
- "price": 39.9,
- "sales": 9868,
- "num_iid": 3538414620425485000,
- "shop_name": "仙女定制官方帐号",
- "shop_id": 2780577,
- "detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3538414620425484697&pick_source=NvtErRV"
- },
- {
- "title": "2021新款吊带衬衫减龄白色连衣裙洋气两件套装",
- "pic_url": "https://p9-aio.ecombdimg.com/obj/temai/d8b9b52a523dee34c21b80f14a20a79f478f837bwww800-800",
- "promotion_price": 79,
- "price": 79,
- "sales": 23896,
- "num_iid": 3493447132738898400,
- "shop_name": "衣漫朵",
- "shop_id": 6335140,
- "detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3493447132738898360&pick_source=Nvt7KP4"
- },
- {
- "title": "2130旗袍裙子连衣裙中长款祺包裙2022年新款年轻改良旗袍版少女",
- "pic_url": "https://p3-aio.ecombdimg.com/obj/temai/b406e48fe59f3141e98fa15b0f0345843dc36ad8www750-750",
- "promotion_price": 79.9,
- "price": 79.9,
- "sales": 24234,
- "num_iid": 3480085173800951000,
- "shop_name": "哇喔服饰",
- "shop_id": 3889958,
- "detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3480085173800950962&pick_source=Nvneodf"
- },
- {
- "title": "RRFG.R溶溶zero 连衣裙N1052 3.17",
- "pic_url": "https://p6-aio.ecombdimg.com/obj/ecom-shop-material/v1_UoIznLQo_70763979360951503680152_d117fd3c6eb2bca82272247654efbfa1_sx_197906_www800-800",
- "promotion_price": 149.9,
- "price": 149.9,
- "sales": 6898,
- "num_iid": 3537948146133031000,
- "shop_name": "溶溶高定服装",
- "shop_id": 21961152,
- "detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3537948146133030735&pick_source=NvnR9gq"
- },
- {
- "title": "冰沙蜜桃连衣裙XZ2242",
- "pic_url": "https://p6-aio.ecombdimg.com/obj/ecom-shop-material/v1_PzFHhbHs_70775320259173419930081_0fbc2a86b8227fa1762240d17ae774bc_sx_201357_www1080-1080",
- "promotion_price": 189,
- "price": 189,
- "sales": 6718,
- "num_iid": 3538407183639311000,
- "shop_name": "YINZ小银子女装",
- "shop_id": 12839081,
- "detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3538407183639310973&pick_source=NvnWosw"
- },
- {
- "title": "女童夏季连衣裙2022新款儿童韩版洋气樱桃公主裙夏装裙子",
- "pic_url": "https://p6-aio.ecombdimg.com/obj/ecom-shop-material/v1_eiXzSSw_70740828160441387850169_d8e63140c5f63eae45ba0bc3f214a1a3_sx_717003_www800-800",
- "promotion_price": 39.9,
- "price": 39.9,
- "sales": 13356,
- "num_iid": 3537041448480433000,
- "shop_name": "吉米家族旗舰店",
- "shop_id": 1921169,
- "detail_url": "https://haohuo.jinritemai.com/views/product/item2?id=3537041448480432904&pick_source=NvttnNN"
- }
- ],
- "_ddf": "xpgj"
- },
- "error_code": "0000",
- "reason": "ok",
- "secache": "9fd1f6906c8b8bc9080fe69807fc5a1f",
- "secache_time": 1649835424,
- "secache_date": "2022-04-13 15:37:04",
- "translate_status": "",
- "translate_time": 0,
- "language": {
- "default_lang": "cn",
- "current_lang": "cn"
- },
- "error": "",
- "cache": 0,
- "api_info": "today:48 max:11000",
- "execution_time": "0.048",
- "server_time": "Beijing/2022-04-13 17:02:00",
- "client_ip": "106.6.34.146",
- "call_args": {
- "q": "连衣裙",
- "start_price": "1"
- },
- "api_type": "douyin",
- "translate_language": "zh-CN",
- "translate_engine": "google_new",
- "server_memory": "0.77MB",
- "request_id": "gw-4.625691883e023",
- "last_id": "880760728"
- }