淘宝开放平台

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

直通车API

taobao.simba.insight.catsdata.get (获取类目的大盘数据)

根据类目id获取类目的大盘数据，包括展现指数，点击指数，点击率，本次提供的insight相关的其它接口的都是这种情况。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
category_id_list String [] 必须 50014579
  • 最大列表长度：5
    		•  表示要查询的类目id
    start_date String 必须 2000-01-01 开始时间，格式：yyyy-MM-dd
    end_date String 必须 2000-01-01 查询截止时间，格式：yyyy-MM-dd

    响应参数

    名称 类型 示例值 描述
    cat_data_list InsightCategoryDataDTO [] 类目详细数据列表
    • └ impression
    • Number
    • 242
    • 展现量
    • └ click
    • Number
    • 21
    • 点击量
    • └ cat_name
    • String
    • 刹车片
    • 类目名称
    • └ cat_id
    • Number
    • 11
    • 类目id
    • └ ctr
    • String
    • 0.04
    • 点击率

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    1
    2
    3
    4
    5
    6
    7
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    SimbaInsightCatsdataGetRequest req = new SimbaInsightCatsdataGetRequest();
    req.setCategoryIdList("50014579");
    req.setStartDate("2000-01-01");
    req.setEndDate("2000-01-01");
    SimbaInsightCatsdataGetResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    <simba_insight_catsdata_get_response>
        <cat_data_list>
            <insight_category_data_d_t_o>
                <impression>242</impression>
                <click>21</click>
                <cat_name>刹车片</cat_name>
                <cat_id>11</cat_id>
                <ctr>0.04</ctr>
            </insight_category_data_d_t_o>
        </cat_data_list>
    </simba_insight_catsdata_get_response>

    异常示例

    • XML示例
    • JSON示例
    1
    2
    3
    4
    5
    6
    <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测试工具 错误码查询工具 SDK下载

    如何获得此API

    FAQ

    我要提问
    返回
    顶部