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

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

获取类目的大盘数据

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_service_context TopServiceContext 必须 topServiceContext
  • └ biz_code
  • String
  • 必须
  • universalBP
  • api业务线编码
  • └ login_type
  • Number
  • 必须
  • 1
  • 1: 直客(正常)登录 2: 代理直投(叉乘账号)
  • └ member_id
  • Number
  • 可选
  • 12345
  • 代理直投时被代理商家账号, 代理直投(叉乘)时必填。 直客 时也可以填入 memberId
  • └ ext
  • String
  • 可选
  • {}
  • 扩展内容, 暂时无用
cats_data_query_v_o CatsDataQueryVO 必须 catsDataQueryVO
  • └ category_id_list
  • String []
  • 必须
  • [50014579]
  • 表示要查询的类目id
  • └ start_date
  • String
  • 必须
  • 2026-01-01
  • 查询开始时间,格式必须为:yyyy-MM-dd
  • └ end_date
  • String
  • 必须
  • 2026-02-01
  • 查询截止时间,格式只能是:yyyy-MM-dd

响应参数

名称 类型 示例值 描述
top_result TopResult topResult
  • info
  • TopInfo
  • 通用前端结果的Info信息
  • 请求系统信息
  • └ ok
  • Boolean
  • true
  • 是否成功
  • └ message
  • String
  • 参数错误
  • 错误信息
  • └ error_code
  • String
  • xxxxx
  • 错误编码
  • cats_data_result_v_o_top_bulk_data
  • TopBulkData
  • 结果集
  • └ count
  • Number
  • 10
  • 成功数量
  • cats_data_result_v_o_list
  • CatsDataResultVO []
  • 批量成功结果集
  • └ impression
  • String
  • 242
  • 展现量
  • └ click
  • String
  • 21
  • 点击量
  • └ cat_name
  • String
  • 刹车片
  • 类目名称
  • └ cat_id
  • String
  • 50014579
  • 类目id
  • └ ctr
  • String
  • 0.04
  • 点击率

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UniversalbpNewInsightCatsdataGetRequest req = new UniversalbpNewInsightCatsdataGetRequest();
UniversalbpNewInsightCatsdataGetRequest.TopServiceContext obj1 = new UniversalbpNewInsightCatsdataGetRequest.TopServiceContext();
obj1.setBizCode("universalBP");
obj1.setLoginType(1L);
obj1.setMemberId(12345L);
obj1.setExt("{}");
req.setTopServiceContext(obj1);
UniversalbpNewInsightCatsdataGetRequest.CatsDataQueryVO obj2 = new UniversalbpNewInsightCatsdataGetRequest.CatsDataQueryVO();
obj2.setCategoryIdList("50014579");
obj2.setStartDate("2026-01-01");
obj2.setEndDate("2026-02-01");
req.setCatsDataQueryVO(obj2);
UniversalbpNewInsightCatsdataGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<universalbp_new_insight_catsdata_get_response>
    <top_result>
        <info>
            <ok>true</ok>
            <message>参数错误</message>
            <error_code>xxxxx</error_code>
        </info>
        <cats_data_result_v_o_top_bulk_data>
            <count>10</count>
            <cats_data_result_v_o_list>
                <cats_data_result_v_o>
                    <impression>242</impression>
                    <click>21</click>
                    <cat_name>刹车片</cat_name>
                    <cat_id>50014579</cat_id>
                    <ctr>0.04</ctr>
                </cats_data_result_v_o>
            </cats_data_result_v_o_list>
        </cats_data_result_v_o_top_bulk_data>
    </top_result>
</universalbp_new_insight_catsdata_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

返回
顶部