DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
「Google Ads 検索ボリューム」ライブタスクの設定
keywords のリストの Google Ads 検索ボリュームです。keyword、location_code、language_code、search_partners、competition、competition_index、search_volume、low_top_of_page_bid、high_top_of_page_bid、cpc、monthly_searches を返し、Google が語句を修正した場合は spell も返します。DataForSEO のエンベロープに包まれます。データは tasks[0].result、結果は tasks[0].status_code に格納され、拒否されたリクエストでも HTTP 200 が返ります。これは従来型の検索ボリュームです。代わりにアシスタントへ質問する頻度を知りたい場合は post_dataforseo_ai_keyword_volume_live を使用してください。このエンドポイントの submit / fetch のペアは、待ちきれないほど大きなバッチ向けに、同じ価格で同じ処理を非同期に実行します。
料金の参考情報
- 計量方式：報告されたレスポンスコスト。
- 参考リクエスト見積もり：0.09 USD。
- 参照用の顧客乗数：1.0。確定済みの顧客金額に再適用しないでください。
参照用のメタデータのみであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。
- 型: array (object | null)[]
- date型: string | null
_from - date型: string | null
_to 期間の終了日
任意フィールド
注意：指定した日付は先月より後にできません。Google Ads は当月のデータを返しません；
このフィールドを指定しない場合、デフォルトで昨日の日付が使用されます
日付形式："yyyy-mm-dd"
例："2022-11-30" - include型: boolean | null
_adult _keywords - keywords型: array string[]
キーワード
必須フィールド
指定できるキーワードの最大数：1000
各キーワードの最大文字数：80
各キーワードフレーズの最大語数：10
指定したキーワードは小文字形式に変換されます
注意 1：Google Ads は特定のキーワードグループについてデータを返さない場合があります；
注意 2：Google Ads は類似したキーワードグループに対して合算された検索ボリューム値を提供します
類似キーワードの検索ボリュームを取得するには、それらのキーワードを個別のリクエストで送信することをお勧めします；
注意 3：Google Ads では特定の記号や文字（UTF 記号、絵文字など）を使用できないため、タスクを設定するときにこれらを使用できません；
使用できる記号や文字の詳細については、こちらの記事を参照してくださいDataForSEO API における
keywordおよびkeywordsフィールドのルールと制限については、こちらのヘルプセンター記事を参照してください - language型: string | null
_code 検索エンジンの言語コード
任意フィールド
別途https://api.dataforseo.com/v3/keywords_data/google_ads/languagesにリクエストを送信すると、検索エンジンの利用可能な言語とそのlanguage_codeの一覧を取得できます
例：en - language型: string | null
_name 検索エンジンの言語の正式名称
任意フィールド
別途https://api.dataforseo.com/v3/keywords_data/google_ads/languagesにリクエストを送信すると、検索エンジンの利用可能な言語とそのlanguage_nameの一覧を取得できます
例：English - location型: integer | null
_code 検索エンジンのロケーションコード
任意フィールド
ロケーションを指定しない場合、利用可能なすべてのロケーションを対象としたグローバルな結果が返されます；
このフィールドを使用する場合、location_nameまたはlocation_coordinateを指定する必要はありません；
別途https://api.dataforseo.com/v3/keywords_data/google_ads/locationsにリクエストを送信すると、検索エンジンの利用可能なロケーションとそのlocation_codeの一覧を取得できます
例：2840 - location型: string | null
_coordinate ロケーションの GPS 座標
任意フィールド
ロケーションを指定しない場合、利用可能なすべてのロケーションを対象としたグローバルな結果が返されます；
このフィールドを使用する場合、location_nameまたはlocation_codeを指定する必要はありません；location_coordinateパラメーターは "latitude,longitude" 形式で指定する必要があります；
指定した座標が属する国・地域のデータが提供されます；
例：52.6178549,-155.352142 - location型: string | null
_name 検索エンジンのロケーションの正式名称
任意フィールド
ロケーションを指定しない場合、利用可能なすべてのロケーションを対象としたグローバルな結果が返されます；
このフィールドを使用する場合、location_codeまたはlocation_coordinateを指定する必要はありません
別途https://api.dataforseo.com/v3/keywords_data/google_ads/locationsにリクエストを送信すると、検索エンジンの利用可能なロケーションとそのlocation_nameの一覧を取得できます
例：London,England,United Kingdom - search型: boolean | null
_partners - sort型: string | null
_by 結果の並べ替えパラメーター
任意フィールド
これらのパラメーターを使用して、relevance、search_volume、competition_index、low_top_of_page_bid、high_top_of_page_bidで結果を降順に並べ替えられます
デフォルト値：relevance - tag型: string | null
ユーザー定義のタスク識別子
任意フィールド
文字数上限は 255 です
このパラメーターを使ってタスクを識別し、結果と照合できます
指定したtagの値は、レスポンスのdata配列に含まれます
- 型: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeLiveResponseInfo200
- 型: number | null 形式: doublecost
タスクの総コスト（USD）
- 型: integer | nullstatus
_code 一般的なステータスコード レスポンスコードの完全な一覧はこちらです
- 型: string | nullstatus
_message 一般的な情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- 型: array (object | null)[] | nulltasks
タスクの配列
- 型: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeLiveTaskInfo
- cost型: number | null 形式: double
タスクの総コスト（USD）
- data型: object | null
POST リクエストで指定したものと同じパラメーターを含みます
- property型: object | null
Name
- id型: string | null
タスク識別子 当社システム内で UUID 形式の一意のタスク識別子
- path型: array (string | null)[] | null
URL パス
- result型: array (object | null)[] | null
結果の配列
- competition型: string | null
- competition型: integer | null
_index - cpc型: number | null
クリック単価
指定したキーワードの広告が表示された際のクリックごとの支払額（USD）を示します - high型: number | null
_top _of _page _bid 広告を検索結果の 1 ページ目上部に表示するための最大入札額
広告が表示された最低入札額の約 80% を上回る値を示します（Google Ads の広告主統計に基づく）。
この値は POST リクエストで指定した所在地によって異なる場合があります - keyword型: string | null
キーワード
キーワードは %## がデコードされた状態で返されます（プラス記号 '+' は空白文字にデコードされます） - language型: string | null
_code POST 配列内の言語コード
データがない場合、値はnullになります - location型: integer | null
_code POST 配列内のロケーションコード
データがない場合、値はnullになります - low型: number | null
_top _of _page _bid 広告を検索結果の 1 ページ目上部に表示するための最低入札額
広告が表示された最低入札額の約 20% を上回る値を示します（Google Ads の広告主統計に基づく）。
この値は POST リクエストで指定した所在地によって異なる場合があります - monthly型: array (object | null)[] | null
_searches 月間検索数
指定した地理的位置を対象とした、このキーワード アイデアの（おおよその）検索数（既定では過去 12 か月分の利用可能なデータ）を表します。
データがない場合、値はnullです- month型: integer | null
月
- search型: integer | null
_volume 月間平均検索ボリューム
- year型: integer | null
年
- search型: boolean | null
_partners パートナー ネットワークからのデータがレスポンスに含まれるかどうかを示します
- search型: integer | null 形式: int64
_volume 月間平均検索ボリューム。
ユーザーのターゲティングに応じた、google.com または google.com とパートナーの指定したキーワード アイデアの（おおよその）検索数を表します。
データがない場合、値はnullです - spell型: string | null
- result型: integer | null 形式: int64
_count result 配列内の要素数
- status型: integer | null
_code タスクのステータスコード DataForSEO によって生成され、次の範囲の値になります: 10000-60000 レスポンスコードの完全な一覧はこちらです
- status型: string | null
_message タスクの情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- time型: string | null
実行時間（秒）
- 型: integer | null 形式: int64tasks
_count tasks 配列内のタスク数
- 型: integer | null 形式: int64tasks
_error エラーで返された tasks 配列内のタスク数
- 型: string | nulltime
合計実行時間（秒）
- 型: string | nullversion
API の現在のバージョン
application/json - 400
リクエストを処理できませんでした。リクエストパラメータを確認してください。
- 401
有効な Felo API キーが必要です。
- 402
請求要件が満たされていないため、リクエストを続行できません。
- 403
このアカウントにはこの操作を行う権限がありません。
- 429
リクエストまたは支出の上限に達しました。
- 502
サービスがリクエストを完了できませんでした。
- 503
API または請求サービスが一時的に利用できません。
- 504
リクエストの処理中にサービスがタイムアウトしました。
- default
エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/google_ads/search_volume/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"location_code": 2840,
"keywords": [
"buy laptop",
"cheap laptops for sale",
"purchase laptop"
],
"date_from": "2021-08-01",
"search_partners": true
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"keyword": null,
"spell": null,
"location_code": null,
"language_code": null,
"search_partners": null,
"competition": null,
"competition_index": null,
"search_volume": null,
"low_top_of_page_bid": null,
"high_top_of_page_bid": null,
"cpc": null,
"monthly_searches": [
{
"year": null,
"month": null,
"search_volume": null
}
]
}
]
}
]
}