获取建议出价

您可以使用本接口获取系统建议出价，建议出价基于基本的推广系列及广告组的设置（如推广目标、转化事件以及地域定向等）。获取的建议出价仅能用于成本上限出价策略（即bid_type=BID_TYPE_CUSTOM)。

v1.2与v1.3版本对比

以下表格概括了 v1.2与v1.3接口的变化。 ``xtable |变化内容{30%}|v1.2{35%}|v1.3{35%}| |---|---|---| |接口路径|/v1.2/tools/suggest_bid/|/v1.3/tool/bid/recommend/| |请求参数类型 |advertiser_id: number<br>campaign_id: number|advertiser_id: string<br>campaign_id: string| |请求参数名称和类型 |locations: number[]|location_ids`: string[]|

## 请求

**地址** https://business-api.tiktok.com/open_api/v1.3/tool/bid/recommend/

**方法** POST

**header**

``` xtable
|字段|类型|描述|
|---|---|---|
|Access-Token{必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|

参数

|字段|类型|描述|
|---|---|---|
| advertiser_id {必填} | string | 广告主ID。 |
| campaign_id | string | 推广系列ID。 |
| objective_type {必填} | string | 推广系列的推广目标。该接口目前仅支持访问量和网站转化量目标。枚举值及描述请查看[推广目标](https://ads.tiktok.com/marketing_api/docs?id=1737585562434561)。<br><p><span style="color:darkred"><b>注意</b></span>: 该接口目前正在进行优化，以扩大支持的功能范围、提高结果准确性。请密切关注更新信息。 |
| location_ids {必填} | string[] | 你想要定向的地域ID列表。 |
| external_action {必填} | string | 广告组的转化事件。 |

示例

(code curl http)
curl -H "Access-Token:xxx" -H "Content-Type:application/json" -X POST \
-d '{
    "advertiser_id": "ADVERTISER_ID",
    "campaign_id": "CAMPAIGN_ID",
    "objective_type": "OBJECTIVE_TYPE",
    "locations": [
        "LOCATIONS"
    ],
    "external_action": "EXTERNAL_ACTION"
}' \
https://business-api.tiktok.com/open_api/v1.3/tool/bid/recommend/
(/code)

返回

|字段|类型|描述|
|---|---|---|
|code |number | 返回码。完整返回码列表及描述，可查看[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string | 返回信息。更多信息可查看[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|request_id|string|请求的日志 ID，唯一标识一个请求。 |
|data |object| 返回数据。 |
#|bid| number | 建议出价的值。|

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "1234",
    "data": {
       "bid": 1.0
       }
}
(/code)