Keywords relevant to a domain in Google
dataforseo.x.dataforseo-labs-google-keywords-for-site-liveThe Keywords For Site endpoint will provide you with a list of keywords relevant to the target domain.
- 価格
- $0.01236/callカタログ価格で提供
- 成功率
- —成功率データはまだありません成功率データはまだありません
- レイテンシ p50
- ——
- 最終確認
- 2026/07/28動作確認済み
POSThttps://toolswitch.dev/v1/tools/dataforseo.x.dataforseo-labs-google-keywords-for-site-liveBeta- プラットフォームのクォータを使用
- 同期レスポンス
- 公開データを読み取る
パラメータ
the POST body is a JSON array holding exactly one task object with these fields; a live route rejects extra tasks with status 40000 "You can set only one task at a time"
| パラメータ | 型 | 必須 | 説明 | 例 |
|---|---|---|---|---|
| リクエストボディ（JSON） | ||||
tag | 文字列 | 任意 | user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified tag value in the data object of the response | |
limit | 整数 | 任意 | the maximum number of keywords in the results array optional field default value: 100 maximum value: 1000 | 3 |
offset | 整数 | 任意 | offset in the results array of returned keywords optional field default value: 0 if you specify the 10 value, the first ten keywords in the results array will be omitted and the data will be provided for the successive keywords Note: we recommend using this parameter only when retrieving up to 10,00 | |
target | 文字列 | 任意 | target domain required field the domain name of the target website the domain should be specified without https:// | apple.com |
filters | 配列 | 任意 | array of results filtering parameters optional field you can add several filters at once (8 filters maximum) you should set a logical operator and, or between the conditions the following operators are supported: regex, not_regex, <, <=, >, >=, =, <>, in, not_in, match, not_match, ilike, not_ilike, | ["serp_info.se_results_count",">",0] |
order_by | 配列 | 任意 | results sorting rules optional field you can use the same values as in the filters array to sort the results possible sorting types: asc – results will be sorted in the ascending order desc – results will be sorted in the descending order you should use a comma to set up a sorting parameter default | |
offset_token | 文字列 | 任意 | offset token for subsequent requests optional field provided in the identical filed of the response to each request; use this parameter to avoid timeouts while trying to obtain over 10,000 results in a single request; by specifying the unique offset_token value from the response array, you will get | |
language_code | 文字列 | 任意 | language code optional field if you use this field, you don’t need to specify language_name you can receive the list of available languages with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages example: en Note: if omitted, | en |
language_name | 文字列 | 任意 | full name of the language optional field if you use this field, you don’t need to specify language_code you can receive the list of available languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages example: English | |
location_code | 整数 | 任意 | unique location identifier required field if you don’t specify location_name Note: it is required to specify either location_name or location_code you can receive the list of available locations with their location_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_lab | 2840 |
location_name | 文字列 | 任意 | full name of the location required field if you don’t specify location_code Note: it is required to specify either location_name or location_code you can receive the list of available locations with their location_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs | |
include_serp_info | 真偽値 | 任意 | include data from SERP for each keyword optional field if set to true, we will return a serp_info array containing SERP data (number of search results, relevant URL, and SERP features) for every keyword in the response default value: false | true |
include_subdomains | 真偽値 | 任意 | indicates if the subdomains will be included in the search optional field if set to false, the subdomains will be ignored default value: true | true |
include_clickstream_data | 真偽値 | 任意 | include or exclude data from clickstream-based metrics in the result optional field if the parameter is set to true, you will receive clickstream_keyword_info, keyword_info_normalized_with_clickstream, and keyword_info_normalized_with_bing fields in the response default value: false with this parame | |
- リクエストボディ（JSON）
tag文字列任意user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified tag value in the data object of the response
limit整数任意the maximum number of keywords in the results array optional field default value: 100 maximum value: 1000
例：
3offset整数任意offset in the results array of returned keywords optional field default value: 0 if you specify the 10 value, the first ten keywords in the results array will be omitted and the data will be provided for the successive keywords Note: we recommend using this parameter only when retrieving up to 10,00
target文字列任意target domain required field the domain name of the target website the domain should be specified without https://
例：
apple.comfilters配列任意array of results filtering parameters optional field you can add several filters at once (8 filters maximum) you should set a logical operator and, or between the conditions the following operators are supported: regex, not_regex, <, <=, >, >=, =, <>, in, not_in, match, not_match, ilike, not_ilike,
例：
["serp_info.se_results_count",">",0]order_by配列任意results sorting rules optional field you can use the same values as in the filters array to sort the results possible sorting types: asc – results will be sorted in the ascending order desc – results will be sorted in the descending order you should use a comma to set up a sorting parameter default
offset_token文字列任意offset token for subsequent requests optional field provided in the identical filed of the response to each request; use this parameter to avoid timeouts while trying to obtain over 10,000 results in a single request; by specifying the unique offset_token value from the response array, you will get
language_code文字列任意language code optional field if you use this field, you don’t need to specify language_name you can receive the list of available languages with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages example: en Note: if omitted,
例：
enlanguage_name文字列任意full name of the language optional field if you use this field, you don’t need to specify language_code you can receive the list of available languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages example: English
location_code整数任意unique location identifier required field if you don’t specify location_name Note: it is required to specify either location_name or location_code you can receive the list of available locations with their location_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_lab
例：
2840location_name文字列任意full name of the location required field if you don’t specify location_code Note: it is required to specify either location_name or location_code you can receive the list of available locations with their location_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs
include_serp_info真偽値任意include data from SERP for each keyword optional field if set to true, we will return a serp_info array containing SERP data (number of search results, relevant URL, and SERP features) for every keyword in the response default value: false
例：
trueinclude_subdomains真偽値任意indicates if the subdomains will be included in the search optional field if set to false, the subdomains will be ignored default value: true
例：
trueinclude_clickstream_data真偽値任意include or exclude data from clickstream-based metrics in the result optional field if the parameter is set to true, you will receive clickstream_keyword_info, keyword_info_normalized_with_clickstream, and keyword_info_normalized_with_bing fields in the response default value: false with this parame
コード例
$TOOLSWITCH_KEY をコンソールで作成したキーに置き換えてください。
curl -X POST 'https://toolswitch.dev/v1/tools/dataforseo.x.dataforseo-labs-google-keywords-for-site-live' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY" \
-H "Content-Type: application/json" \
--data-raw '[{"limit":3,"target":"apple.com","filters":["serp_info.se_results_count",">",0],"language_code":"en","location_code":2840,"include_serp_info":true,"include_subdomains":true}]'import os
import json
import requests
response = requests.request(
"POST",
"https://toolswitch.dev/v1/tools/dataforseo.x.dataforseo-labs-google-keywords-for-site-live",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
json=json.loads("[{\"limit\":3,\"target\":\"apple.com\",\"filters\":[\"serp_info.se_results_count\",\">\",0],\"language_code\":\"en\",\"location_code\":2840,\"include_serp_info\":true,\"include_subdomains\":true}]"),
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/dataforseo.x.dataforseo-labs-google-keywords-for-site-live", {
method: "POST",
headers: {
"X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
"Content-Type": "application/json",
},
body: JSON.stringify(JSON.parse("[{\"limit\":3,\"target\":\"apple.com\",\"filters\":[\"serp_info.se_results_count\",\">\",0],\"language_code\":\"en\",\"location_code\":2840,\"include_serp_info\":true,\"include_subdomains\":true}]")),
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());このゲートウェイ API は Beta です。URL や認証方式は変更される場合があります。 パラメータはサンプルデータです。 呼び出し料金は $0.01236/call です。サービス料を含みます。