DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
id で「キーワード別広告トラフィック」の結果を取得
id でキューの Google Ads トラフィック予測を取得します。指定した入札に対する推定インプレッション、クリック、コスト、平均ポジションです。DataForSEO のエンベロープに包まれます。データは tasks[0].result、結果は tasks[0].status_code に格納され、拒否されたリクエストでも HTTP 200 が返ります。ボリューム系のエンドポイントと異なり、これは実測ではなく予測です。数値は bid と match によって変わります。
料金の参考情報
- 計量方式：報告されたレスポンスコスト。
- 参考リクエスト見積もり：0.012 USD。
- 参照用の顧客乗数：1.0。確定済みの顧客金額に再適用しないでください。
参照用のメタデータのみであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。
- 型: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskGetResponseInfo200
- 型: number | null 形式: doublecost
タスクの総コスト（USD）
- 型: integer | nullstatus
_code 一般的なステータスコード レスポンスコードの完全な一覧はこちらです
- 型: string | nullstatus
_message 一般的な情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- 型: array (object | null)[] | nulltasks
タスクの配列
- 型: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskGetTaskInfo
- 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
結果の配列
- average型: number | null 形式: double
_cpc 平均クリック単価の値
指定した期間と履歴データに基づいて推定されたキーワードのクリック単価（USD）を表します。
データがない場合、値はnullです - bid型: number | null
カスタム入札額の上限
タスク設定時に指定した入札額
広告に対して支払ってもよい価格を表します
指定する値が大きいほど、レスポンスで得られる指標と費用も大きくなります
こちらのヘルプセンター記事で詳しく確認できます - clicks型: number | null
広告クリック数
指定した期間内に広告が獲得すると予測されるクリック数
データがない場合、値はnullです - cost型: number | null
広告費用
指定した期間内に広告を配信するために請求される金額
データがない場合、値はnullです - ctr型: number | null 形式: double
広告の予測クリック率（CTR）
広告が獲得すると予測されるクリック数を広告インプレッション数で割った値。
注意：このパラメーターは非推奨です。値は常にnullです - date型: string | null
_interval POST 配列内の予測日付期間
- impressions型: integer | null
予測広告インプレッション数
指定した期間内に広告が獲得すると予測されるインプレッション数
注意：このパラメーターは非推奨です。値は常にnullです - keyword型: string | null
POST 配列内のキーワード
POST 配列で指定したすべてのキーワードの指標が提供されます - language型: string | null
_code POST 配列内の言語コード
データがない場合、値はnullになります - location型: integer | null
_code POST 配列内のロケーションコード
データがない場合、値はnullになります - match型: string | null
キーワードのマッチタイプ
次の値を取ることができます：exact、broad、phrase - search型: boolean | null
_partners Google 検索パートナーを含める
値は常にfalseです
- 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/ad_traffic_by_keywords/task_get/00000000-0000-0000-0000-000000000000 \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"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,
"location_code": null,
"language_code": null,
"date_interval": null,
"search_partners": null,
"bid": null,
"match": null,
"impressions": null,
"ctr": null,
"average_cpc": null,
"cost": null,
"clicks": null
}
]
}
]
}