Setting Live ‘Ad Traffic By Keywords’ Tasks

正式环境

https://api.302.ai

POST

/dataforseo/v3/keywords_data/google_ads/ad_traffic_by_keywords/live

请注意，从 6 月 1 日起，Google 按关键词的广告流量将返回整个广告系列的批量数据（设置任务时指定的所有关键词）。您可以在此更新中了解更多信息。
请注意，Google Ads 关键词数据 API 基于最新版本的 Google Ads API，已取代旧版 Google AdWords API。如果您正在使用 DataForSEO Google AdWords API，您需要升级到 DataForSEO Google Ads API。
使用按关键词的广告流量端点，您可以接收一组用于估算展示次数、CPC 和点击次数的统计数据。这些数据对于估算特定关键词的实际需求非常有用，因为它比常规的搜索量信息更为准确，后者显示的是一组相似关键词的广泛匹配估算。
请注意，Google Ads API 提供基于广告历史、账户中已有的创意和其他因素的账户特定结果。使用高 bid 来平衡其他因素。
您在响应中收到的值取决于设定的预测时间段。有两种方法可以指定所需的时间段：

通过使用 date_from 和 date_to 指定未来的确切日期；

通过将 date_interval 设置为 next_week 、 next_month 或 next_quarter
如果您不使用上述方法之一，默认将应用 next_month 的预测时间段。

参考：https://docs.dataforseo.com/v3/keywords_data/google_ads/ad_traffic_by_keywords/live/

请求参数

Header 参数

Body 参数application/json必填

示例

[
    {
        "location_code": 2840,
        "language_code": "en",
        "bid": 999,
        "match": "exact",
        "keywords": [
            "seo marketing"
        ]
    }
]

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/dataforseo/v3/keywords_data/google_ads/ad_traffic_by_keywords/live' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "location_code": 2840,
        "language_code": "en",
        "bid": 999,
        "match": "exact",
        "keywords": [
            "seo marketing"
        ]
    }
]'

返回响应

🟢200成功

application/json

Body

示例

{}

修改于 2026-03-19 09:06:59

Get ‘Keywords For Keywords’ Results by id

Setting ‘Ad Traffic By Keywords’ Tasks