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

taobao.universalbp.new.insight.wordsareadata.get (获取关键词按地域进行细分的数据)

获取关键词按地域进行细分的数据

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_service_context TopServiceContext 必须 topServiceContext
  • └ biz_code
  • String
  • 必须
  • universalBP
  • api业务线编码
  • └ login_type
  • Number
  • 可选
  • 1
  • 1: 直客(正常)登录 2: 代理直投(叉乘账号)
  • └ member_id
  • Number
  • 可选
  • 12345
  • 代理直投时被代理商家账号, 代理直投(叉乘)时必填。 直客 时也可以填入 memberId
  • └ ext
  • String
  • 可选
  • {}
  • 扩展内容, 暂时无用
words_area_data_query_v_o WordsAreaDataQueryVO 必须 wordsAreaDataQueryVO
  • └ original_word
  • String
  • 必须
  • 连衣裙
  • 关键词
  • └ category_id
  • Number
  • 必须
  • 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
  • 错误编码
  • words_area_data_result_v_o_top_bulk_data
  • TopBulkData
  • 结果集
  • └ count
  • Number
  • 10
  • 成功数量
  • words_area_data_result_v_o_list
  • WordsAreaDataResultVO []
  • 批量成功结果集
  • └ city_name
  • String
  • 北京
  • 市名称
  • └ 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);
UniversalbpNewInsightWordsareadataGetRequest req = new UniversalbpNewInsightWordsareadataGetRequest();
UniversalbpNewInsightWordsareadataGetRequest.TopServiceContext obj1 = new UniversalbpNewInsightWordsareadataGetRequest.TopServiceContext();
obj1.setBizCode("universalBP");
obj1.setLoginType(1L);
obj1.setMemberId(12345L);
obj1.setExt("{}");
req.setTopServiceContext(obj1);
UniversalbpNewInsightWordsareadataGetRequest.WordsAreaDataQueryVO obj2 = new UniversalbpNewInsightWordsareadataGetRequest.WordsAreaDataQueryVO();
obj2.setOriginalWord("连衣裙");
obj2.setCategoryId(50014579L);
obj2.setStartDate("2026-01-01");
obj2.setEndDate("2026-02-01");
req.setWordsAreaDataQueryVO(obj2);
UniversalbpNewInsightWordsareadataGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<universalbp_new_insight_wordsareadata_get_response>
    <top_result>
        <info>
            <ok>true</ok>
            <message>参数错误</message>
            <error_code>xxxxx</error_code>
        </info>
        <words_area_data_result_v_o_top_bulk_data>
            <count>10</count>
            <words_area_data_result_v_o_list>
                <words_area_data_result_v_o>
                    <city_name>北京</city_name>
                    <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>
                </words_area_data_result_v_o>
            </words_area_data_result_v_o_list>
        </words_area_data_result_v_o_top_bulk_data>
    </top_result>
</universalbp_new_insight_wordsareadata_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

返回
顶部