文档中心 > API类目 > 直通车API

taobao.simba.insight.catstopwordnew.get (获取类目下最热门的词)

按照某个维度,查询某个类目下最热门的词,维度有点击,展现,花费,点击率等,具体可以按哪些字段进行排序,参考参数说明,比如选择了impression,则返回该类目下展现量最高那几个词。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
cat_id String 必须 50014579 类目id
start_date String 必须 2000-01-01 查询开始时间,格式必须为:yyyy-MM-dd
end_date String 必须 2000-02-01 查询截止时间,格式只能是:yyyy-MM-dd
dimension String 必须 click 表示查询的维度,比如选择click,则查询该类目下点击量最大的词,可供选择的值有:impression, click, cost, ctr, cpc, coverage, transactiontotal, transactionshippingtotal, favtotal, roi
page_size Number 必须 10 返回前多少条数据

响应参数

名称 类型 示例值 描述
topword_data_list InsightWordDataUnderCatDTO [] 类目下热门词详细数据
  • └ impression
  • Number
  • 242
  • 展现量
  • └ indirecttransaction
  • Number
  • 10000
  • 间接成交金额
  • └ click
  • Number
  • 21
  • 点击量
  • └ cost
  • Number
  • 10000
  • 花费,单位(分)
  • └ cat_name
  • String
  • 急救包
  • 类目名称
  • └ directtransaction
  • Number
  • 100
  • 直接成交金额
  • └ favitemtotal
  • Number
  • 10000
  • 宝贝搜藏数
  • └ cat_id
  • Number
  • 10000
  • 类目id
  • └ transactionshippingtotal
  • Number
  • 10000
  • 总的成交笔数
  • └ coverage
  • String
  • 1.23
  • 点击转化率
  • └ cpc
  • String
  • 1.11
  • 平均点击花费
  • └ favtotal
  • Number
  • 10000
  • 总的收藏数,包括宝贝收藏和店铺收藏
  • └ roi
  • String
  • 2.12
  • 投入产出比
  • └ transactiontotal
  • Number
  • 10000
  • 成交总金额
  • └ indirecttransactionshipping
  • Number
  • 10000
  • 间接成交笔数
  • └ bidword
  • String
  • 连衣裙
  • 关键词
  • └ directtransactionshipping
  • Number
  • 10000
  • 直接成交笔数
  • └ ctr
  • String
  • 0.04
  • 点击率
  • └ favshoptotal
  • Number
  • 100
  • 店铺搜藏数
  • └ competition
  • Number
  • 10000
  • 竞争度

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
SimbaInsightCatstopwordnewGetRequest req = new SimbaInsightCatstopwordnewGetRequest();
req.setCatId("50014579");
req.setStartDate("2000-01-01");
req.setEndDate("2000-02-01");
req.setDimension("click");
req.setPageSize(10L);
SimbaInsightCatstopwordnewGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<simba_insight_catstopwordnew_get_response>
    <topword_data_list>
        <insight_word_data_under_cat_d_t_o>
            <impression>242</impression>
            <indirecttransaction>10000</indirecttransaction>
            <click>21</click>
            <cost>10000</cost>
            <cat_name>急救包</cat_name>
            <directtransaction>100</directtransaction>
            <favitemtotal>10000</favitemtotal>
            <cat_id>10000</cat_id>
            <transactionshippingtotal>10000</transactionshippingtotal>
            <coverage>1.23</coverage>
            <cpc>1.11</cpc>
            <favtotal>10000</favtotal>
            <roi>2.12</roi>
            <transactiontotal>10000</transactiontotal>
            <indirecttransactionshipping>10000</indirecttransactionshipping>
            <bidword>连衣裙</bidword>
            <directtransactionshipping>10000</directtransactionshipping>
            <ctr>0.04</ctr>
            <favshoptotal>100</favshoptotal>
            <competition>10000</competition>
        </insight_word_data_under_cat_d_t_o>
    </topword_data_list>
</simba_insight_catstopwordnew_get_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

返回
顶部