设置“Keywords For Keywords”任务

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

import requests

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

payload = {
    "keywords": ["<string>"],
    "target": "<string>",
    "location_name": "<string>",
    "location_code": 123,
    "location_coordinate": "<string>",
    "language_name": "<string>",
    "language_code": "<string>",
    "search_partners": True,
    "date_from": "<string>",
    "date_to": "<string>",
    "sort_by": "<string>",
    "include_adult_keywords": True,
    "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>'],
    target: '<string>',
    location_name: '<string>',
    location_code: 123,
    location_coordinate: '<string>',
    language_name: '<string>',
    language_code: '<string>',
    search_partners: true,
    date_from: '<string>',
    date_to: '<string>',
    sort_by: '<string>',
    include_adult_keywords: true,
    postback_url: '<string>',
    pingback_url: '<string>',
    tag: '<string>'
  })
};

fetch('https://api.aisa.one/apis/v1/dataforseo/keywords_data/google_ads/keywords_for_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/keywords_for_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>'
    ],
    'target' => '<string>',
    'location_name' => '<string>',
    'location_code' => 123,
    'location_coordinate' => '<string>',
    'language_name' => '<string>',
    'language_code' => '<string>',
    'search_partners' => true,
    'date_from' => '<string>',
    'date_to' => '<string>',
    'sort_by' => '<string>',
    'include_adult_keywords' => true,
    '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/keywords_for_keywords/task_post"

	payload := strings.NewReader("{\n  \"keywords\": [\n    \"<string>\"\n  ],\n  \"target\": \"<string>\",\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"location_coordinate\": \"<string>\",\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"search_partners\": true,\n  \"date_from\": \"<string>\",\n  \"date_to\": \"<string>\",\n  \"sort_by\": \"<string>\",\n  \"include_adult_keywords\": true,\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/keywords_for_keywords/task_post")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"keywords\": [\n    \"<string>\"\n  ],\n  \"target\": \"<string>\",\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"location_coordinate\": \"<string>\",\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"search_partners\": true,\n  \"date_from\": \"<string>\",\n  \"date_to\": \"<string>\",\n  \"sort_by\": \"<string>\",\n  \"include_adult_keywords\": true,\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/keywords_for_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  \"target\": \"<string>\",\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"location_coordinate\": \"<string>\",\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"search_partners\": true,\n  \"date_from\": \"<string>\",\n  \"date_to\": \"<string>\",\n  \"sort_by\": \"<string>\",\n  \"include_adult_keywords\": true,\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

keywords_for_keywords

task_post

设置“Keywords For Keywords”任务

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

import requests

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

payload = {
    "keywords": ["<string>"],
    "target": "<string>",
    "location_name": "<string>",
    "location_code": 123,
    "location_coordinate": "<string>",
    "language_name": "<string>",
    "language_code": "<string>",
    "search_partners": True,
    "date_from": "<string>",
    "date_to": "<string>",
    "sort_by": "<string>",
    "include_adult_keywords": True,
    "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>'],
    target: '<string>',
    location_name: '<string>',
    location_code: 123,
    location_coordinate: '<string>',
    language_name: '<string>',
    language_code: '<string>',
    search_partners: true,
    date_from: '<string>',
    date_to: '<string>',
    sort_by: '<string>',
    include_adult_keywords: true,
    postback_url: '<string>',
    pingback_url: '<string>',
    tag: '<string>'
  })
};

fetch('https://api.aisa.one/apis/v1/dataforseo/keywords_data/google_ads/keywords_for_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/keywords_for_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>'
    ],
    'target' => '<string>',
    'location_name' => '<string>',
    'location_code' => 123,
    'location_coordinate' => '<string>',
    'language_name' => '<string>',
    'language_code' => '<string>',
    'search_partners' => true,
    'date_from' => '<string>',
    'date_to' => '<string>',
    'sort_by' => '<string>',
    'include_adult_keywords' => true,
    '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/keywords_for_keywords/task_post"

	payload := strings.NewReader("{\n  \"keywords\": [\n    \"<string>\"\n  ],\n  \"target\": \"<string>\",\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"location_coordinate\": \"<string>\",\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"search_partners\": true,\n  \"date_from\": \"<string>\",\n  \"date_to\": \"<string>\",\n  \"sort_by\": \"<string>\",\n  \"include_adult_keywords\": true,\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/keywords_for_keywords/task_post")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"keywords\": [\n    \"<string>\"\n  ],\n  \"target\": \"<string>\",\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"location_coordinate\": \"<string>\",\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"search_partners\": true,\n  \"date_from\": \"<string>\",\n  \"date_to\": \"<string>\",\n  \"sort_by\": \"<string>\",\n  \"include_adult_keywords\": true,\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/keywords_for_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  \"target\": \"<string>\",\n  \"location_name\": \"<string>\",\n  \"location_code\": 123,\n  \"location_coordinate\": \"<string>\",\n  \"language_name\": \"<string>\",\n  \"language_code\": \"<string>\",\n  \"search_partners\": true,\n  \"date_from\": \"<string>\",\n  \"date_to\": \"<string>\",\n  \"sort_by\": \"<string>\",\n  \"include_adult_keywords\": true,\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/keywords_for_keywords/task_post" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '[{"keywords": "...", "target": "...", "location_name": "..."}]'

授权

Authorization

string

header

必填

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

请求体

application/json

keywords

string[]

必填

keywords，必填字段。最多可以指定 20 个关键词，每个关键词最多包含 80 个字符。您指定的关键词将转换为小写格式。注意：Google Ads 可能不会返回某些关键词组的数据，请访问我们的帮助中心了解更多信息。另请注意，Google Ads 不允许使用某些符号和字符（例如 UTF 符号、表情符号），因此设置任务时不能使用它们；有关可用符号和字符的更多信息，请参阅此文章。有关 DataForSEO API 中 keyword 和 keywords 字段的规则与限制，请参阅此帮助中心文章

target

string

目标网站。可选字段。指定网站或 URL，以获取与其相关的关键词列表。注意：如果指定网站 URL，您仍将获得与整个网站相关的关键词。

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

search_partners

boolean

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

date_from

string

时间范围的开始日期可选字段日期格式："yyyy-mm-dd" 最小值：当前日期往前 4 年默认返回过去 12 个月的数据；注意：指定日期不得晚于 date_to 指定的日期和/或昨天；如果 Status 端点在 actual_data 字段中返回 false，则 date_from 可设置为上上个月或更早；如果 Status 端点在 actual_data 字段中返回 true，则 date_from 可设置为上个月或更早

date_to

string

时间范围的结束日期；可选字段。注意：指定的日期不能晚于昨天；如果不指定此字段，将默认使用昨天的日期。日期格式："yyyy-mm-dd"；示例："2022-11-30"。

sort_by

string

结果排序参数，可选字段。使用这些参数按 relevance、search_volume、competition_index、low_top_of_page_bid 或 high_top_of_page_bid 对结果进行降序排序；默认值：relevance

include_adult_keywords

boolean

包含与成人内容相关的关键词，可选字段。如果设置为 true，响应中将包含成人关键词，默认值：false。请注意，由于 Google Ads 的限制，API 可能不会返回此类关键词的数据

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

tasks 数组中的任务数量

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

基础功能

设置“Keywords For Keywords”任务

示例

授权

请求体

响应

​示例

授权

请求体

响应

示例