淘宝开放平台

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

直通车API

taobao.simba.bidword.pricetools (关键词出价指导工具（新）)

关键词出价指导工具（新）

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
adgroup_id Number 必须 12345678 推广单元id
bidword_id Number 必须 1234567890 关键词id
traffic_type String 可选 WL 区分渠道 ，计算机：PC，无线 ：WL
type Number 必须 1 出价目标 ，1：争取排名；2：提升展现；3：提示点击；4：提升转化

响应参数

名称 类型 示例值 描述
result_list PriceSuggestionDto true true 表示符合准入，false不符合
  • └ bidwordid
  • String
  • 123123123
  • 关键词id
  • └ word
  • String
  • 连衣裙
  • 关键词原词
  • └ stat
  • String
  • 1
  • 状态码
  • yesterday_info
  • YesterdayInfo
  • 1
  • 昨日信息
  • └ click
  • String
  • 1
  • 昨日点击量
  • └ impression
  • String
  • 1
  • 昨日展现量
  • guidance_price
  • GuidancePrice
  • 1
  • 出价建议
  • └ click_up_rate
  • String
  • 1
  • 相对当前价格点击提升比例
  • └ impression_up_rate
  • String
  • 1
  • 相对当前价格展现提升比例
  • └ price_flag
  • String
  • 1
  • 价格类型，0代表正常排名建议，1代表被过滤排名建议， * 2代表相近价格建议，3代表转化出价建议
  • └ price
  • String
  • 1
  • 建议出价（分）
  • └ flag
  • String
  • 1
  • flag＝0，1时为目标排名，flag＝2时无意义,flag=3时代表对应的建议
  • └ new_click
  • String
  • 1
  • 建议价格能够拿到的点击量
  • └ new_impression
  • String
  • 1
  • 建议价格能够拿到的展现量

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
8
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
SimbaBidwordPricetoolsRequest req = new SimbaBidwordPricetoolsRequest();
req.setAdgroupId(12345678L);
req.setBidwordId(1234567890L);
req.setTrafficType("WL");
req.setType(1L);
SimbaBidwordPricetoolsResponse rsp = client.execute(req, sessionKey);
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
<simba_bidword_pricetools_response>
    <result_list>
        <bidwordid>123123123</bidwordid>
        <word>连衣裙</word>
        <stat>1</stat>
        <yesterday_info>
            <click>1</click>
            <impression>1</impression>
        </yesterday_info>
        <guidance_price>
            <click_up_rate>1</click_up_rate>
            <impression_up_rate>1</impression_up_rate>
            <price_flag>1</price_flag>
            <price>1</price>
            <flag>1</flag>
            <new_click>1</new_click>
            <new_impression>1</new_impression>
        </guidance_price>
    </result_list>
</simba_bidword_pricetools_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

我要提问
返回
顶部