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

taobao.simba.insight.catsworddata.get (获取类目下关键词的数据)

获取给定词在给定类目下的详细数据

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
cat_id String 必须 50014579 类目id
bidword_list String [] 必须 l连衣裙
  • 最大列表长度:100
  • 需要查询的关键词列表,最大长度100。
    start_date String 必须 2000-01-01 开始时间,格式只能为:yyyy-MM-dd
    end_date String 必须 2000-01-01 结束时间,格式只能为:yyyy-MM-dd

    响应参数

    名称 类型 示例值 描述
    catword_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);
    SimbaInsightCatsworddataGetRequest req = new SimbaInsightCatsworddataGetRequest();
    req.setCatId("50014579");
    req.setBidwordList("l连衣裙");
    req.setStartDate("2000-01-01");
    req.setEndDate("2000-01-01");
    SimbaInsightCatsworddataGetResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <simba_insight_catsworddata_get_response>
        <catword_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>
        </catword_data_list>
    </simba_insight_catsworddata_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

    返回
    顶部