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

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

获取类目下关键词的数据

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_service_context TopServiceContext 必须 topServiceContext
  • └ biz_code
  • String
  • 必须
  • xxxxx
  • api业务线编码
  • └ login_type
  • Number
  • 可选
  • 1
  • 1: 直客(正常)登录 2: 代理直投(叉乘账号)
  • └ member_id
  • Number
  • 可选
  • 12345
  • 代理直投时被代理商家账号, 代理直投(叉乘)时必填。 直客 时也可以填入 memberId
  • └ ext
  • String
  • 可选
  • {}
  • 扩展内容, 暂时无用
cats_word_data_query_v_o CatsWordDataQueryVO 必须 catsWordDataQueryVO
  • word_category_list
  • WordCategoryVO []
  • 必须
  • 词类目集合
  • └ cate_id
  • Number
  • 必须
  • 50010850
  • 类目id
  • └ word
  • String
  • 必须
  • 裙子
  • └ start_time
  • String
  • 必须
  • 2026-01-01
  • 开始时间,格式只能为:yyyy-MM-dd
  • └ end_time
  • String
  • 必须
  • 2026-02-01
  • 结束时间,格式只能为:yyyy-MM-dd

响应参数

名称 类型 示例值 描述
top_result TopResult topResult
  • info
  • TopInfo
  • 通用前端结果的Info信息
  • 请求系统信息
  • └ ok
  • Boolean
  • true
  • 是否成功
  • └ message
  • String
  • 参数错误
  • 错误信息
  • └ error_code
  • String
  • xxxxx
  • 错误编码
  • cats_word_data_result_v_o_top_bulk_data
  • TopBulkData
  • 结果集
  • └ count
  • Number
  • 10
  • 成功数量
  • cats_word_data_result_v_o_list
  • CatsWordDataResultVO []
  • 批量成功结果集
  • └ the_date
  • String
  • 2026-01-15
  • 日期
  • └ impression
  • String
  • 242
  • 展现量
  • └ click
  • String
  • 21
  • 点击量
  • └ coverage
  • String
  • 1.23
  • 点击转化率
  • └ cpc
  • String
  • 1.11
  • 平均点击花费
  • └ bid_word
  • String
  • 连衣裙
  • 关键词
  • └ ctr
  • String
  • 0.04
  • 点击率
  • └ competition
  • String
  • 10000
  • 竞争度

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UniversalbpNewInsightCatsworddataGetRequest req = new UniversalbpNewInsightCatsworddataGetRequest();
UniversalbpNewInsightCatsworddataGetRequest.TopServiceContext obj1 = new UniversalbpNewInsightCatsworddataGetRequest.TopServiceContext();
obj1.setBizCode("xxxxx");
obj1.setLoginType(1L);
obj1.setMemberId(12345L);
obj1.setExt("{}");
req.setTopServiceContext(obj1);
UniversalbpNewInsightCatsworddataGetRequest.CatsWordDataQueryVO obj2 = new UniversalbpNewInsightCatsworddataGetRequest.CatsWordDataQueryVO();
List<UniversalbpNewInsightCatsworddataGetRequest.WordCategoryVO> list4 = new ArrayList<UniversalbpNewInsightCatsworddataGetRequest.WordCategoryVO>();
UniversalbpNewInsightCatsworddataGetRequest.WordCategoryVO obj5 = new UniversalbpNewInsightCatsworddataGetRequest.WordCategoryVO();
list4.add(obj5);
obj5.setCateId(50010850L);
obj5.setWord("裙子");
obj2.setWordCategoryList(list4);
obj2.setStartTime("2026-01-01");
obj2.setEndTime("2026-02-01");
req.setCatsWordDataQueryVO(obj2);
UniversalbpNewInsightCatsworddataGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<universalbp_new_insight_catsworddata_get_response>
    <top_result>
        <info>
            <ok>true</ok>
            <message>参数错误</message>
            <error_code>xxxxx</error_code>
        </info>
        <cats_word_data_result_v_o_top_bulk_data>
            <count>10</count>
            <cats_word_data_result_v_o_list>
                <cats_word_data_result_v_o>
                    <the_date>2026-01-15</the_date>
                    <impression>242</impression>
                    <click>21</click>
                    <coverage>1.23</coverage>
                    <cpc>1.11</cpc>
                    <bid_word>连衣裙</bid_word>
                    <ctr>0.04</ctr>
                    <competition>10000</competition>
                </cats_word_data_result_v_o>
            </cats_word_data_result_v_o_list>
        </cats_word_data_result_v_o_top_bulk_data>
    </top_result>
</universalbp_new_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

返回
顶部