淘宝开放平台

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

直通车API

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

获取关键词按地域细分的详细数据，目前地域只能细化到省级别，返回的结果中包括市，是为了方便以后扩展，目前结果中市的值等于省。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
bidword String 必须 连衣裙 关键词
start_date String 必须 2000-01-01 开始时间，格式：yyyy-MM-dd
end_date String 必须 2000-01-01 结束时间，格式：yyyy-MM-dd

响应参数

名称 类型 示例值 描述
word_areadata_list InsightWordsAreaDistributeDataDTO [] 地域细分数据
  • └ impression
  • Number
  • 242
  • 展现量
  • └ indirecttransaction
  • Number
  • 10000
  • 间接成交金额
  • └ click
  • Number
  • 21
  • 点击量
  • └ cost
  • Number
  • 10000
  • 花费，单位（分）
  • └ directtransaction
  • Number
  • 100
  • 直接成交金额
  • └ favitemtotal
  • Number
  • 10000
  • 宝贝搜藏数
  • └ provincename
  • String
  • 北京
  • 省名称
  • └ transactionshippingtotal
  • Number
  • 10000
  • 总的成交笔数
  • └ coverage
  • String
  • 1.23
  • 点击转化率
  • └ cpc
  • String
  • 1.11
  • 平均点击花费
  • └ favtotal
  • Number
  • 10000
  • 总的收藏数，包括宝贝收藏和店铺收藏
  • └ roi
  • String
  • 2.12
  • 投入产出比
  • └ transactiontotal
  • Number
  • 10000
  • 成交总金额
  • └ indirecttransactionshipping
  • Number
  • 10000
  • 间接成交笔数
  • └ cityname
  • String
  • 北京
  • 市名称
  • └ bidword
  • String
  • 连衣裙
  • 关键词
  • └ directtransactionshipping
  • Number
  • 10000
  • 直接成交笔数
  • └ ctr
  • String
  • 0.04
  • 点击率
  • └ favshoptotal
  • Number
  • 100
  • 店铺搜藏数
  • └ competition
  • Number
  • 10000
  • 竞争度

请求示例

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

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
<simba_insight_wordsareadata_get_response>
    <word_areadata_list>
        <insight_words_area_distribute_data_d_t_o>
            <impression>242</impression>
            <indirecttransaction>10000</indirecttransaction>
            <click>21</click>
            <cost>10000</cost>
            <directtransaction>100</directtransaction>
            <favitemtotal>10000</favitemtotal>
            <provincename>北京</provincename>
            <transactionshippingtotal>10000</transactionshippingtotal>
            <coverage>1.23</coverage>
            <cpc>1.11</cpc>
            <favtotal>10000</favtotal>
            <roi>2.12</roi>
            <transactiontotal>10000</transactiontotal>
            <indirecttransactionshipping>10000</indirecttransactionshipping>
            <cityname>北京</cityname>
            <bidword>连衣裙</bidword>
            <directtransactionshipping>10000</directtransactionshipping>
            <ctr>0.04</ctr>
            <favshoptotal>100</favshoptotal>
            <competition>10000</competition>
        </insight_words_area_distribute_data_d_t_o>
    </word_areadata_list>
</simba_insight_wordsareadata_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

我要提问
返回
顶部