文档中心 > API类目 > 手淘用户增长

taobao.growth.reaching.buzzword.query (淘宝热词榜单数据查询接口)

查询淘宝热词榜单数据

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
device_ids DeviceIdParam 必须 设备信息
  • └ os
  • String
  • 必须
  • Android
  • 操作系统: Android/iOS/Windows/macOS
  • └ is_md5
  • Boolean
  • 必须
  • true
  • 是否 md5 hash 值
  • └ type
  • String
  • 必须
  • oaid
  • 设备标识类型: oaid/idfa/imei/caid1/caid2
  • └ value
  • String
  • 必须
  • 1fe9a970-efbb-29e0-0bdd-f5dbbf751ab5
  • 设备标识内容
wanted_size Number 可选 20
  • 默认值:20
  • 需要的数据量,如果产出的数据不足,会返回错误代码:data insufficient
    site_id String 可选 111111 媒体站点类型
    data_offset Number 可选 0
  • 默认值:0
  • 数据偏移位置

    响应参数

    名称 类型 示例值 描述
    buzzwords BuzzwordDto [] 榜单词条列表
    • └ name
    • String
    • 春季必入床品四件套
    • 词条
    • └ popularity
    • Number
    • 1
    • 热度
    • └ tag
    • String
    • 标签,可选,热、新等
    • └ tag_url
    • String
    • https://gw.alicdn.com/imgextra/i4/O1CN011hBDf61c1MoJGSsKF_!!6000000003540-2-tps-56-56.png
    • 标签对应的图片 url
    • └ deeplink_url
    • String
    • tbopen://m.taobao.com/tbopen/index.html?action=ali.open.nav&module=h5&bootImage=0&h5Url=https%3A%2F%2Fs.m.taobao.com%2Fh5%3Fq%3D%25E9%2592%2588%25E7%25BB%2587%25E5%25BC%2580%25E8%25A1%25AB%25E6%2598%25A5%25E6%25AC%25BE%26qlist_id%3DYrUVny%26qlist_ranking%3D2%26qlist_template%3Dhot_rank_content%26from%3Dnt_hotsearch-bangdan%26channelSrp%3Dfuyiping&bc_fl_src=growth_dhh_2200803434487_os-hotsearch-1069565676-huawei&backURL=search%3A%2F%2Fcom.huawei.search%2Fhotword
    • App跳转链接
    • └ h5_url
    • String
    • https://market.m.taobao.com/app/asr-pages/muise-tb-hot-list/p/tb-hot-list?wh_weex=true&wx_navbar_transparent=true&defaultTab=0&channelSrp=fuyiping&g_channelSrp=fuyiping
    • 未安装淘宝时 h5 页面跳
    • └ click_url
    • String []
    • https://wcp.taobao.com/adstrack/track.json?oaidMd5=aaa
    • 点击上报链接
    • └ exposure_url
    • String []
    • https://wcp.taobao.com/adstrack/track.json?action=2&app=1&channel=__CHANNELID__&oaidMd5=__DEVICEID__&advertiserId=__ADVERTISERID__&adid=__ADID__&cid=__CID__&requestId=__REQUESTID__
    • 词条曝光链接
    • └ invalid_time
    • Number
    • 1679293665
    • 词条失效时间(秒级时间戳)
    • └ display_image_url
    • String
    • https://img.alicdn.com/imgextra/i1/O1CN01hRthxz1j9L4zW6Tgg_!!6000000004505-2-tps-1200-1600.png
    • 展示图片
    • └ heat_search_text
    • String
    • 热度710.5w
    • 热度搜索文字
    • └ sub_title
    • String
    • 本周上升11%
    • 副标题
    extra ExtraDto 更多内容跳转链接
    • └ deeplink_url
    • String
    • tbopen://m.taobao.com/tbopen/index.html?action=ali.open.nav&bootImage=0 &h5Url=https%3A%2F%2Fmarket.m.taobao.com%2Fapp%2Fasr-pages%2Fmuise-tb-hot-list%2Fp%2Ftb-hot-list%3F wh_weex%3Dtrue%26wx_navbar_transparent%3Dtrue%26defaultTab%3D0%26channelSrp%3Dfuyiping%26g_channelSrp%3Dfuyiping &bc_fl_src=growth_dhh_2200803434487_os-hotsearch-1069565676-huawei&afc_route=1
    • App跳转链接
    • └ h5_url
    • String
    • https://market.m.taobao.com/app/asr-pages/muise-tb-hot-list/p/tb-hot-list?wh_weex=true&wx_navbar_transparent=true&defaultTab=0&channelSrp=fuyiping&g_channelSrp=fuyiping
    • 未安装淘宝时 h5 页面跳
    • └ exposure_url
    • String []
    • 拓展曝光上报链接, 可以用于榜单曝光
    • └ click_url
    • String []
    • 拓展点击上报链接, 可以用于“点击更多”上报
    is_offering Boolean true 是否针对此设备进行投放
    cache_duration Number 600 缓存时长,单位是秒
    exposure_url String https://wcp.taobao.com/adstrack/track.json?action=2&app=1&channel=__CHANNELID__&oaidMd5=__DEVICEID__&advertiserId=__ADVERTISERID__&adid=__ADID__&cid=__CID__&requestId=__REQUESTID__ 榜单词条曝光链接

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    GrowthReachingBuzzwordQueryRequest req = new GrowthReachingBuzzwordQueryRequest();
    GrowthReachingBuzzwordQueryRequest.DeviceIdParam obj1 = new GrowthReachingBuzzwordQueryRequest.DeviceIdParam();
    obj1.setOs("Android");
    obj1.setIsMd5(true);
    obj1.setType("oaid");
    obj1.setValue("1fe9a970-efbb-29e0-0bdd-f5dbbf751ab5");
    req.setDeviceIds(obj1);
    req.setWantedSize(20L);
    req.setSiteId("111111");
    req.setDataOffset(0L);
    GrowthReachingBuzzwordQueryResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <growth_reaching_buzzword_query_response>
        <buzzwords>
            <buzzword_dto>
                <name>春季必入床品四件套</name>
                <popularity>1</popularity>
                <tag>热</tag>
                <tag_url>https://gw.alicdn.com/imgextra/i4/O1CN011hBDf61c1MoJGSsKF_!!6000000003540-2-tps-56-56.png</tag_url>
                <deeplink_url>tbopen://m.taobao.com/tbopen/index.html?action=ali.open.nav&amp;module=h5&amp;bootImage=0&amp;h5Url=https%3A%2F%2Fs.m.taobao.com%2Fh5%3Fq%3D%25E9%2592%2588%25E7%25BB%2587%25E5%25BC%2580%25E8%25A1%25AB%25E6%2598%25A5%25E6%25AC%25BE%26qlist_id%3DYrUVny%26qlist_ranking%3D2%26qlist_template%3Dhot_rank_content%26from%3Dnt_hotsearch-bangdan%26channelSrp%3Dfuyiping&amp;bc_fl_src=growth_dhh_2200803434487_os-hotsearch-1069565676-huawei&amp;backURL=search%3A%2F%2Fcom.huawei.search%2Fhotword</deeplink_url>
                <h5_url>https://market.m.taobao.com/app/asr-pages/muise-tb-hot-list/p/tb-hot-list?wh_weex=true&amp;wx_navbar_transparent=true&amp;defaultTab=0&amp;channelSrp=fuyiping&amp;g_channelSrp=fuyiping</h5_url>
                <click_url>
                    <string>https://wcp.taobao.com/adstrack/track.json?oaidMd5=aaa</string>
                </click_url>
                <exposure_url>
                    <string>https://wcp.taobao.com/adstrack/track.json?action=2&amp;app=1&amp;channel=__CHANNELID__&amp;oaidMd5=__DEVICEID__&amp;advertiserId=__ADVERTISERID__&amp;adid=__ADID__&amp;cid=__CID__&amp;requestId=__REQUESTID__</string>
                </exposure_url>
                <invalid_time>1679293665</invalid_time>
                <display_image_url>https://img.alicdn.com/imgextra/i1/O1CN01hRthxz1j9L4zW6Tgg_!!6000000004505-2-tps-1200-1600.png</display_image_url>
                <heat_search_text>热度710.5w</heat_search_text>
                <sub_title>本周上升11%</sub_title>
            </buzzword_dto>
        </buzzwords>
        <extra>
            <deeplink_url>tbopen://m.taobao.com/tbopen/index.html?action=ali.open.nav&amp;bootImage=0 &amp;h5Url=https%3A%2F%2Fmarket.m.taobao.com%2Fapp%2Fasr-pages%2Fmuise-tb-hot-list%2Fp%2Ftb-hot-list%3F wh_weex%3Dtrue%26wx_navbar_transparent%3Dtrue%26defaultTab%3D0%26channelSrp%3Dfuyiping%26g_channelSrp%3Dfuyiping &amp;bc_fl_src=growth_dhh_2200803434487_os-hotsearch-1069565676-huawei&amp;afc_route=1</deeplink_url>
            <h5_url>https://market.m.taobao.com/app/asr-pages/muise-tb-hot-list/p/tb-hot-list?wh_weex=true&amp;wx_navbar_transparent=true&amp;defaultTab=0&amp;channelSrp=fuyiping&amp;g_channelSrp=fuyiping</h5_url>
        </extra>
        <is_offering>true</is_offering>
        <cache_duration>600</cache_duration>
        <exposure_url>https://wcp.taobao.com/adstrack/track.json?action=2&amp;app=1&amp;channel=__CHANNELID__&amp;oaidMd5=__DEVICEID__&amp;advertiserId=__ADVERTISERID__&amp;adid=__ADID__&amp;cid=__CID__&amp;requestId=__REQUESTID__</exposure_url>
    </growth_reaching_buzzword_query_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部