Setting ‘Search Volume’ Tasks

正式环境

https://api.302.ai

POST

/dataforseo/v3/keywords_data/google_ads/search_volume/task_post

请注意，Google Ads 关键词数据 API 基于最新版本的 Google Ads API，已取代旧版 Google AdWords API。如果您正在使用 DataForSEO Google AdWords API，您需要升级到 DataForSEO Google Ads API。
此端点将为您提供单次请求中最多 1000 个关键词的搜索量、每月搜索次数、竞争情况及其他相关数据。
这是标准的数据检索方法。如果您不需要实时接收数据，这种方法是您的最佳选择。设置一个任务，并在我们的系统收集结果时检索结果。执行时间取决于系统负载。
如果您的系统需要即时结果，Live 方法将是更好的解决方案。此方法不需要对相应的端点进行单独的 POST 和 GET 请求。
历史数据可追溯至 4 年。

参考：https://docs.dataforseo.com/v3/keywords_data/google_ads/search_volume/task_post/

请求参数

Header 参数

Body 参数application/json必填

示例

[
    {
        "location_name": "United States",
        "keywords": [
            "buy laptop",
            "cheap laptops for sale",
            "purchase laptop"
        ]
    }
]

请求示例代码

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/search_volume/task_post' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "location_name": "United States",
        "keywords": [
            "buy laptop",
            "cheap laptops for sale",
            "purchase laptop"
        ]
    }
]'

返回响应

🟢200成功

application/json

Body

示例

{}

修改于 2026-03-19 07:36:34

Perplexity LLM Responses Models List

Setting Live ‘Google Ads Search Volume’ Tasks