淘宝/天猫按分类搜索淘宝直播接口 API 返回值说明

雨点打透心脏的1/2处 2024-03-23 12:09 75阅读 0赞

淘宝直播是阿里巴巴推出的直播平台，定位于“消费类直播”，用户可边看边买，涵盖的范畴包括母婴、美妆等。

随着越来越多的商家加入淘宝直播，就会发现许多主播面临着这样的问题：**淘宝直播新人没人看**。**淘宝直播到底应该怎么做？怎样做才能吸引更多的粉丝？**因此很多商家以及主播无比惆怅。

千人千面的奉行，淘宝共性化举荐流量的占比愈来愈大，淘宝直播的标签化越精确，就更能定位好精确人群。若是标签过于混乱，系统没法分辨是什么标签，那么自然就没法匹配到合适的人群，就无法举荐给用户人群获得流量。

获取现有淘宝直播数据，进行数据分析，可以帮助直播新人更快的找好自己的定位，借鉴做的好的主播敬仰。给自己的直播贴上合适的标签，能快速匹配到精准客户群体。

### item\_videolist-按分类搜索淘宝直播接口 ###

请求示例（PHP） [进入调用][Link 1]

<?php
    
    // 请求示例 url 默认请求参数已经URL编码处理
    // 本示例代码未加密secret参数明文传输，若要加密请参考：数据文档
    $method = "GET";
    $url = "https://vx-15870092527.cn/taobao/item_videolist/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&channelId=0&page=1";
    $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));
    ?>

请求示例（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://服务器地址/taobao/item_videolist/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&channelId=0&page=1"
    headers = {
        "Accept-Encoding": "gzip",
        "Connection": "close"
    }
    if __name__ == "__main__":
        r = requests.get(url, headers=headers)
        json_obj = r.json()
        print(json_obj)

调用说明

公共参数

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>类型</th> 
   <th>必须</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>key</td> 
   <td>String</td> 
   <td>是</td> 
   <td>调用key（必须以GET方式拼接在URL中）</td> 
  </tr> 
  <tr> 
   <td>secret</td> 
   <td>String</td> 
   <td>是</td> 
   <td>调用密钥</td> 
  </tr> 
  <tr> 
   <td>api_name</td> 
   <td>String</td> 
   <td>是</td> 
   <td>API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]</td> 
  </tr> 
  <tr> 
   <td>cache</td> 
   <td>String</td> 
   <td>否</td> 
   <td>[yes,no]默认yes，将调用缓存的数据，速度比较快</td> 
  </tr> 
  <tr> 
   <td>result_type</td> 
   <td>String</td> 
   <td>否</td> 
   <td>[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读</td> 
  </tr> 
  <tr> 
   <td>lang</td> 
   <td>String</td> 
   <td>否</td> 
   <td>[cn,en,ru]翻译语言，默认cn简体中文</td> 
  </tr> 
  <tr> 
   <td>version</td> 
   <td>String</td> 
   <td>否</td> 
   <td>API版本</td> 
  </tr> 
 </tbody> 
</table>

请求参数

请求参数：channelId=0&page=1

参数说明：channelId：视频分类ID  
page页数

响应参数

Version: Date:

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>类型</th> 
   <th>必须</th> 
   <th>示例值</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td> <p>title</p> </td> 
   <td>String</td> 
   <td>0</td> 
   <td>年货盛宴 心意之选</td> 
   <td>商品标题</td> 
  </tr> 
  <tr> 
   <td> <p>num_iid</p> </td> 
   <td>Bigint</td> 
   <td>0</td> 
   <td>294846800380</td> 
   <td>宝贝ID</td> 
  </tr> 
  <tr> 
   <td> <p>view_count</p> </td> 
   <td>Int</td> 
   <td>0</td> 
   <td>890</td> 
   <td>观看人数</td> 
  </tr> 
  <tr> 
   <td> <p>pic_url</p> </td> 
   <td>String</td> 
   <td>0</td> 
   <td>https://gw.alicdn.com/tfscom/i1/O1CN019WuTCM1WkoKlZhTPU_!!0-dgshop.jpg</td> 
   <td>宝贝图片</td> 
  </tr> 
  <tr> 
   <td> <p>detail_url</p> </td> 
   <td>String</td> 
   <td>0</td> 
   <td>//h5.m.taobao.com/taolive/video.html?id=294846800380</td> 
   <td>宝贝链接</td> 
  </tr> 
  <tr> 
   <td> <p>seller_info</p> </td> 
   <td>Mix</td> 
   <td>0</td> 
   <td>{"user_num_id": 2064892827, "head_img": "//img.alicdn.com/imgextra/i4/2064892827/O1CN01FQoRJd1WkoJuNhJOw_!!2064892827-0-beehive-scenes.jpg", "seller_nick": "雅诗兰黛旗舰店"}</td> 
   <td>卖家信息</td> 
  </tr> 
 </tbody> 
</table>

[Link 1]: https://o0b.cn/jennif