设置“按关键词划分的广告流量”任务

curl --request POST \
  --url https://api.aisa.one/apis/v1/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "keywords": [
    "<string>"
  ],
  "bid": 123,
  "match": "<string>",
  "date_from": "<string>",
  "date_to": "<string>",
  "search_partners": true,
  "location_name": "<string>",
  "location_code": 123,
  "location_coordinate": "<string>",
  "language_name": "<string>",
  "language_code": "<string>",
  "date_interval": "<string>",
  "sort_by": "<string>",
  "postback_url": "<string>",
  "pingback_url": "<string>",
  "tag": "<string>"
}
'

import requests

url = "https://api.aisa.one/apis/v1/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post"

payload = {
    "keywords": ["<string>"],
    "bid": 123,
    "match": "<string>",
    "date_from": "<string>",
    "date_to": "<string>",
    "search_partners": True,
    "location_name": "<string>",
    "location_code": 123,
    "location_coordinate": "<string>",
    "language_name": "<string>",
    "language_code": "<string>",
    "date_interval": "<string>",
    "sort_by": "<string>",
    "postback_url": "<string>",
    "pingback_url": "<string>",
    "tag": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    keywords: ['<string>'],
    bid: 123,
    match: '<string>',
    date_from: '<string>',
    date_to: '<string>',
    search_partners: true,
    location_name: '<string>',
    location_code: 123,
    location_coordinate: '<string>',
    language_name: '<string>',
    language_code: '<string>',
    date_interval: '<string>',
    sort_by: '<string>',
    postback_url: '<string>',
    pingback_url: '<string>',
    tag: '<string>'
  })
};

fetch('https://api.aisa.one/apis/v1/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'keywords' => [
        '<string>'
    ],
    'bid' => 123,
    'match' => '<string>',
    'date_from' => '<string>',
    'date_to' => '<string>',
    'search_partners' => true,
    'location_name' => '<string>',
    'location_code' => 123,
    'location_coordinate' => '<string>',
    'language_name' => '<string>',
    'language_code' => '<string>',
    'date_interval' => '<string>',
    'sort_by' => '<string>',
    'postback_url' => '<string>',
    'pingback_url' => '<string>',
    'tag' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post"

	payload := strings.NewReader("{\n  \"keywords\": [\n    \"<string>\"\n  ],\n  \"bid\": 123,\n  \"match\": \"<string>\",\n  \"date_from\": \"<string>\",\n  \"date_to\": \"<string>\",\n  \"search_partners\": true,\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"location_coordinate\": \"<string>\",\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"date_interval\": \"<string>\",\n  \"sort_by\": \"<string>\",\n  \"postback_url\": \"<string>\",\n  \"pingback_url\": \"<string>\",\n  \"tag\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"keywords\": [\n    \"<string>\"\n  ],\n  \"bid\": 123,\n  \"match\": \"<string>\",\n  \"date_from\": \"<string>\",\n  \"date_to\": \"<string>\",\n  \"search_partners\": true,\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"location_coordinate\": \"<string>\",\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"date_interval\": \"<string>\",\n  \"sort_by\": \"<string>\",\n  \"postback_url\": \"<string>\",\n  \"pingback_url\": \"<string>\",\n  \"tag\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"keywords\": [\n    \"<string>\"\n  ],\n  \"bid\": 123,\n  \"match\": \"<string>\",\n  \"date_from\": \"<string>\",\n  \"date_to\": \"<string>\",\n  \"search_partners\": true,\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"location_coordinate\": \"<string>\",\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"date_interval\": \"<string>\",\n  \"sort_by\": \"<string>\",\n  \"postback_url\": \"<string>\",\n  \"pingback_url\": \"<string>\",\n  \"tag\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "version": "<string>",
  "status_code": 123,
  "status_message": "<string>",
  "time": "<string>",
  "cost": 123,
  "tasks_count": 123,
  "tasks_error": 123,
  "tasks": [
    "<string>"
  ],
  "tasks.id": "<string>",
  "tasks.status_code": 123,
  "tasks.status_message": "<string>",
  "tasks.time": "<string>",
  "tasks.cost": 123,
  "tasks.result_count": 123,
  "tasks.path": [
    "<string>"
  ],
  "tasks.data": {},
  "tasks.result": [
    "<string>"
  ]
}

POST

https://api.aisa.one/apis/v1

dataforseo

keywords_data

google_ads

ad_traffic_by_keywords

task_post

设置“按关键词划分的广告流量”任务

curl --request POST \
  --url https://api.aisa.one/apis/v1/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "keywords": [
    "<string>"
  ],
  "bid": 123,
  "match": "<string>",
  "date_from": "<string>",
  "date_to": "<string>",
  "search_partners": true,
  "location_name": "<string>",
  "location_code": 123,
  "location_coordinate": "<string>",
  "language_name": "<string>",
  "language_code": "<string>",
  "date_interval": "<string>",
  "sort_by": "<string>",
  "postback_url": "<string>",
  "pingback_url": "<string>",
  "tag": "<string>"
}
'

import requests

url = "https://api.aisa.one/apis/v1/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post"

payload = {
    "keywords": ["<string>"],
    "bid": 123,
    "match": "<string>",
    "date_from": "<string>",
    "date_to": "<string>",
    "search_partners": True,
    "location_name": "<string>",
    "location_code": 123,
    "location_coordinate": "<string>",
    "language_name": "<string>",
    "language_code": "<string>",
    "date_interval": "<string>",
    "sort_by": "<string>",
    "postback_url": "<string>",
    "pingback_url": "<string>",
    "tag": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    keywords: ['<string>'],
    bid: 123,
    match: '<string>',
    date_from: '<string>',
    date_to: '<string>',
    search_partners: true,
    location_name: '<string>',
    location_code: 123,
    location_coordinate: '<string>',
    language_name: '<string>',
    language_code: '<string>',
    date_interval: '<string>',
    sort_by: '<string>',
    postback_url: '<string>',
    pingback_url: '<string>',
    tag: '<string>'
  })
};

fetch('https://api.aisa.one/apis/v1/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'keywords' => [
        '<string>'
    ],
    'bid' => 123,
    'match' => '<string>',
    'date_from' => '<string>',
    'date_to' => '<string>',
    'search_partners' => true,
    'location_name' => '<string>',
    'location_code' => 123,
    'location_coordinate' => '<string>',
    'language_name' => '<string>',
    'language_code' => '<string>',
    'date_interval' => '<string>',
    'sort_by' => '<string>',
    'postback_url' => '<string>',
    'pingback_url' => '<string>',
    'tag' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post"

	payload := strings.NewReader("{\n  \"keywords\": [\n    \"<string>\"\n  ],\n  \"bid\": 123,\n  \"match\": \"<string>\",\n  \"date_from\": \"<string>\",\n  \"date_to\": \"<string>\",\n  \"search_partners\": true,\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"location_coordinate\": \"<string>\",\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"date_interval\": \"<string>\",\n  \"sort_by\": \"<string>\",\n  \"postback_url\": \"<string>\",\n  \"pingback_url\": \"<string>\",\n  \"tag\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"keywords\": [\n    \"<string>\"\n  ],\n  \"bid\": 123,\n  \"match\": \"<string>\",\n  \"date_from\": \"<string>\",\n  \"date_to\": \"<string>\",\n  \"search_partners\": true,\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"location_coordinate\": \"<string>\",\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"date_interval\": \"<string>\",\n  \"sort_by\": \"<string>\",\n  \"postback_url\": \"<string>\",\n  \"pingback_url\": \"<string>\",\n  \"tag\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"keywords\": [\n    \"<string>\"\n  ],\n  \"bid\": 123,\n  \"match\": \"<string>\",\n  \"date_from\": \"<string>\",\n  \"date_to\": \"<string>\",\n  \"search_partners\": true,\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"location_coordinate\": \"<string>\",\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"date_interval\": \"<string>\",\n  \"sort_by\": \"<string>\",\n  \"postback_url\": \"<string>\",\n  \"pingback_url\": \"<string>\",\n  \"tag\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "version": "<string>",
  "status_code": 123,
  "status_message": "<string>",
  "time": "<string>",
  "cost": 123,
  "tasks_count": 123,
  "tasks_error": 123,
  "tasks": [
    "<string>"
  ],
  "tasks.id": "<string>",
  "tasks.status_code": 123,
  "tasks.status_message": "<string>",
  "tasks.time": "<string>",
  "tasks.cost": 123,
  "tasks.result_count": 123,
  "tasks.path": [
    "<string>"
  ],
  "tasks.data": {},
  "tasks.result": [
    "<string>"
  ]
}

请注意，Google Ads Keywords Data API 基于最新版本的 Google Ads API，该版本已取代旧版 Google AdWords API。如果您正在使用 DataForSEO Google AdWords API，则需要升级到 DataForSEO Google Ads API。

示例

curl -X POST "https://api.aisa.one/apis/v1/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '[{"keywords": "...", "bid": "...", "match": "..."}]'

授权

Authorization

string

header

必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json

keywords

string[]

必填

keywords 必填字段最多可指定的关键词数量：1000 每个关键词的最大字符数：80 每个关键词短语的最大单词数：10 您指定的关键词将转换为小写格式注意 #1：Google Ads 可能不会返回某些关键词组的数据；注意 #2：Google Ads 会为相似关键词组提供合并的搜索量值；要获取相似关键词各自的搜索量，建议在不同请求中分别提交这些关键词；注意 #3：Google Ads 不允许使用某些符号和字符（例如 UTF 符号、表情符号），因此设置任务时不能使用这些内容；有关可使用哪些符号和字符的更多信息，请参阅此文章有关 DataForSEO API 中 keyword 和 keywords 字段的规则和限制，请参阅此帮助中心文章

bid

number

必填

最高自定义出价；必填字段；所采集的数据将基于此值；它表示您愿意为广告支付的价格；此处指定的值越高，返回指标中的值也会越高；有关更多信息，请参阅此帮助中心文章

match

string

必填

keywords match-type 必填字段可取以下值：exact、broad、phrase

date_from

string

必填

预测时间范围的开始日期；如果指定 date_to，则为必填字段。如果设置了 date_from 和 date_to，则无需指定 date_interval。最小值为明天的日期。date_from 指定的值不应晚于 date_to。日期格式："yyyy-mm-dd"。示例："2021-10-30"。如果 Status 端点在 actual_data 字段中返回 false，则 date_from 可以设置为上上个月或更早；如果 Status 端点在 actual_data 字段中返回 true，则 date_from 可以设置为上个月或更早

date_to

string

必填

预测时间范围的结束日期；如果指定 date_from，则此字段为必填字段；如果指定 date_from 和 date_to，则无需指定 date_interval；最小值为 date_from +1 天；最大值为下一年的当前日期（同月同日）；日期格式："yyyy-mm-dd"；示例："2022-10-30"

search_partners

boolean

是否包含 Google 搜索合作伙伴可选字段如果指定 true，将返回 Google 自有、运营及联合网络，以及托管 Google 搜索的合作伙伴网站的结果；默认值：false – 仅返回 Google 搜索网站的结果

location_name

string

搜索引擎位置的完整名称可选字段如果未指定位置，您将收到全球结果，即所有可用位置的结果；如果使用此字段，则无需指定 location_code 或 location_coordinate 可通过向 https://api.dataforseo.com/v3/keywords_data/google_ads/locations 发出单独请求，获取搜索引擎可用位置及其 location_name 的列表示例：London,England,United Kingdom

location_code

integer

搜索引擎位置代码，可选字段。如果不指定位置，您将收到全球结果，即所有可用位置的结果；如果使用此字段，则无需指定 location_name 或 location_coordinate；您可以单独向 https://api.dataforseo.com/v3/keywords_data/google_ads/locations 发出请求，以获取搜索引擎可用位置及其 location_code 的列表。示例：2840

location_coordinate

string

位置的 GPS 坐标，可选字段。如果不指定位置，您将收到全球结果，即所有可用位置的结果；如果使用此字段，则无需指定 location_name 或 location_code；location_coordinate 参数应以“latitude,longitude”格式指定；将提供指定坐标所属国家/地区的数据；示例：52.6178549,-155.352142

language_name

string

搜索引擎语言的完整名称可选字段可通过向 https://api.dataforseo.com/v3/keywords_data/google_ads/languages 单独发出请求，获取搜索引擎可用语言及其 language_name 的列表示例：English

language_code

string

搜索引擎语言代码，可选字段；你可以通过向 https://api.dataforseo.com/v3/keywords_data/google_ads/languages 单独发起请求，获取搜索引擎可用语言及其 language_code 的列表；示例：en

date_interval

string

预测日期区间。可选字段。如果指定 date_interval，则无需指定 date_from 和 date_to。可选值：next_week、next_month、next_quarter。默认值：next_month

sort_by

string

结果排序参数。可选字段。使用这些参数可按 relevance、impressions、ctr、average_cpc、cost 或 clicks 对结果进行降序排序。默认值：relevance

postback_url

string

用于发送任务结果的 URL，可选字段；任务完成后，我们会向指定的 postback_url 发送 POST 请求，其结果采用 gzip 格式压缩；可以使用字符串 ‘$id’ 作为 $id 变量，并使用 ‘$tag’ 作为经过 URL 编码的 $tag 变量。我们会在发送请求前设置必要的值。示例：http://your-server.com/postbackscript?id=$id http://your-server.com/postbackscript?id=$id&tag=$tag 注意：postback_url 中的特殊字符将经过 URL 编码；例如，# 字符将被编码为 %23；有关更多信息，请参阅我们的帮助中心

pingback_url

string

已完成任务的通知 URL。可选字段。任务完成后，我们将通过向您指定的 URL 发送 GET 请求来通知您。您可以使用字符串 ‘$id’ 作为 $id 变量，并使用 ‘$tag’ 作为经过 urlencoded 编码的 $tag 变量。我们会在发送请求前设置必要的值。示例：http://your-server.com/pingscript?id=$id http://your-server.com/pingscript?id=$id&tag=$tag 注意：pingback_url 中的特殊字符将经过 urlencoded 编码；例如，# 字符将被编码为 %23。请在我们的帮助中心了解更多信息

tag

string

用户定义的任务标识符。可选字段。字符数限制为 255。您可以使用此参数标识任务并将其与结果匹配；您将在响应的 data 对象中找到指定的 tag 值

响应

成功响应

version

string

API 的当前版本

status_code

integer

通用状态码；您可以在此处查看完整的响应码列表。注意：我们强烈建议设计必要的系统来处理相关异常或错误情况

status_message

string

常规信息消息；可在此处查看常规信息消息的完整列表

time

string

执行时间（秒）

cost

number

任务总成本（美元）

tasks_count

integer

tasksarray 中的任务数量

tasks_error

integer

返回错误的 tasks 数组中的任务数量

tasks

string[]

任务数组

tasks.id

string

系统中采用通用唯一标识符（UUID）格式的唯一任务标识符

tasks.status_code

integer

DataForSEO 生成的任务状态码；取值范围为：10000-60000，完整的响应码列表可在此处查看

tasks.status_message

string

任务的信息性消息，你可以在此处查看通用信息性消息的完整列表

tasks.time

string

执行时间（秒）

tasks.cost

number

任务成本（美元）

tasks.result_count

integer

结果数组中的元素数量

tasks.path

string[]

URL 路径

tasks.data

object

包含您在 POST 请求中指定的相同参数

tasks.result

string[]

结果数组；在此情况下，该值将为 null

概览

聊天 API

Embeddings 与重排序

搜索 API

Perplexity API

金融 API

Twitter API

Reddit API

Instagram API

Pinterest API

学术搜索 API

WaveInflu API

预测市场 API

CoinGecko

DataForSEO

AgentMail

Apollo

基础功能

设置“按关键词划分的广告流量”任务

示例

授权

请求体

响应

​示例

授权

请求体

响应

示例