（即将废弃）获取推荐出价

重要提示
下个 API 版本中将废弃本接口。推荐您迁移至 /tool/diagnosis/get/ 接口，通过 bid_edr_info 获取出价预估成效结果。

您可以使用本接口获取 9 组推荐出价及对应的预估花费数据，预估数据为当日采用推荐出价后，当天的花费提升数据。

欲获取基于推广系列及广告组基本设置的建议出价，请查看获取建议出价。

请求

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

方法 GET

Header

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

参数

|字段|类型|描述|
|---|---|---|
| advertiser_id {必填} |string| 广告主 ID。 |
| adgroup_ids {必填} | string[] | 广告组 ID列表，ID数量最大为20。|

示例

(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/delivery/bid/recommend/?advertiser_id={{advertiser_id}}&adgroup_ids=["{{adgroup_id}}"]' \
--header 'Access-Token: {{Access-Token}}'
(/code)

返回

|字段{35%}|类型{10%}|描述{55%}|
|---|---|---|
|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| 返回数据。 |
#| results |object[] | 广告组ID及对应的出价推荐结果列表。|
##| adgroup_id | string |广告组ID。 |
##| recommendations | object[] | 9 组推荐出价及预估成效数据，推荐出价涨幅从-10%逐步增加5%，最高推荐增加30%出价。 |
###| recommended_bid | float |推荐出价。若需更新合适的出价，请使用[/adgroup/update/](https://ads.tiktok.com/marketing_api/docs?id=1739586761631745)接口，将出价传给`conversion_bid_price`字段，在当天（广告主账户时区）进行更新。|
###| bid_increase_ratio | float | 出价增加的预估比例。 |
###| estimated_cost | float | 预估花费。|
###| cost_uplift |float | 预估花费提升量。 |
###| cost_uplift_ratio | float | 预估花费提升比例。 |

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "results": [
            {
                "recommendations": [
                    {
                        "cost_uplift_ratio": 0.83,
                        "estimated_cost": 553.43,
                        "recommended_bid": 0.63,
                        "bid_increase_ratio": 0.25,
                        "cost_uplift": 251.4
                    },
                    {
                        "cost_uplift_ratio": 0.47,
                        "estimated_cost": 444.8,
                        "recommended_bid": 0.57,
                        "bid_increase_ratio": 0.15,
                        "cost_uplift": 142.36
                    },
                    {
                        "cost_uplift_ratio": -0.14,
                        "estimated_cost": 261.17,
                        "recommended_bid": 0.48,
                        "bid_increase_ratio": -0.05,
                        "cost_uplift": -42.4
                    },
                    {
                        "cost_uplift_ratio": -0.27,
                        "estimated_cost": 222.25,
                        "recommended_bid": 0.45,
                        "bid_increase_ratio": -0.1,
                        "cost_uplift": -81.78
                    },
                    {
                        "cost_uplift_ratio": 0.0,
                        "estimated_cost": 302.89,
                        "recommended_bid": 0.5,
                        "bid_increase_ratio": 0.0,
                        "cost_uplift": 0
                    },
                    {
                        "cost_uplift_ratio": 0.15,
                        "estimated_cost": 347.4,
                        "recommended_bid": 0.53,
                        "bid_increase_ratio": 0.05,
                        "cost_uplift": 45.43
                    },
                    {
                        "cost_uplift_ratio": 1.02,
                        "estimated_cost": 611.93,
                        "recommended_bid": 0.65,
                        "bid_increase_ratio": 0.3,
                        "cost_uplift": 308.95
                    },
                    {
                        "cost_uplift_ratio": 0.64,
                        "estimated_cost": 497.73,
                        "recommended_bid": 0.6,
                        "bid_increase_ratio": 0.2,
                        "cost_uplift": 193.85
                    },
                    {
                        "cost_uplift_ratio": 0.3,
                        "estimated_cost": 394.72,
                        "recommended_bid": 0.55,
                        "bid_increase_ratio": 0.1,
                        "cost_uplift": 90.87
                    }
                ],
                "adgroup_id": "adgroup_id"
            }
        ]
    }
}
(/code)