# id で検索ボリュームの結果を取得 **API:** Data API **Endpoint:** `GET /v1/beta/dataforseo/keywords_data/google_ads/search_volume/task_get/{id}` **Tags:** DataForSEO `id` でキューの Google Ads 検索ボリュームタスクを取得します。形式は `post_dataforseo_keywords_gads_search_volume_live` と同じです。DataForSEO のエンベロープに包まれます。データは `tasks[0].result`、結果は `tasks[0].status_code` に格納され、拒否されたリクエストでも HTTP 200 が返ります。 ### 料金の参考情報 - 計量方式：報告されたレスポンスコスト。 - 参考リクエスト見積もり：0.012 USD。 - 参照用の顧客乗数：1.0。確定済みの顧客金額に再適用しないでください。 参照用のメタデータのみであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。 ## Base URL - `https://openapi.felo.ai` ## Authentication - `FeloBearerAuth` (http bearer, bearer format Felo API Key) - `FeloApiKey` (apiKey in header `X-API-Key`) ## Parameters | Name | In | Required | Type | Description | | --- | --- | --- | --- | --- | | `id` | path | yes | string | タスク識別子
当社システム内で UUID 形式の一意のタスク識別子
30 日以内であれば、いつでもこれを使ってタスクの結果をリクエストできます | ## Responses ### 200 — 操作成功 Headers: - `X-Request-Id` (string) — Felo サポートに問い合わせる際に伝えるリクエスト識別子。 **application/json** Schema: object | null ```json { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeTaskGetResponseInfo" } ] } ``` ### 400 — リクエストを処理できませんでした。リクエストパラメータを確認してください。 ### 401 — 有効な Felo API キーが必要です。 ### 402 — 請求要件が満たされていないため、リクエストを続行できません。 ### 403 — このアカウントにはこの操作を行う権限がありません。 ### 429 — リクエストまたは支出の上限に達しました。 ### 502 — サービスがリクエストを完了できませんでした。 ### 503 — API または請求サービスが一時的に利用できません。 ### 504 — リクエストの処理中にサービスがタイムアウトしました。 ### default — エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります **application/json** Schema: ```json {} ``` ## Schema definitions ### Response36Afe1097B20_BaseResponseInfo `#/components/schemas/Response36Afe1097B20_BaseResponseInfo` ```json { "properties": { "version": { "type": [ "string", "null" ], "description": "API の現在のバージョン" }, "status_code": { "type": [ "integer", "null" ], "description": "一般的なステータスコード\nレスポンスコードの完全な一覧はこちらです" }, "status_message": { "type": [ "string", "null" ], "description": "一般的な情報メッセージ\n一般的な情報メッセージの完全な一覧はこちらです" }, "time": { "type": [ "string", "null" ], "description": "合計実行時間（秒）" }, "cost": { "type": [ "number", "null" ], "description": "タスクの総コスト（USD）", "format": "double" }, "tasks_count": { "type": [ "integer", "null" ], "description": "tasks 配列内のタスク数", "format": "int64" }, "tasks_error": { "type": [ "integer", "null" ], "description": "エラーで返された tasks 配列内のタスク数", "format": "int64" } } } ``` ### Response36Afe1097B20_BaseResponseTaskInfo `#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo` ```json { "properties": { "id": { "type": [ "string", "null" ], "description": "タスク識別子\n当社システム内で UUID 形式の一意のタスク識別子" }, "status_code": { "type": [ "integer", "null" ], "description": "タスクのステータスコード\nDataForSEO によって生成され、次の範囲の値になります: 10000-60000\nレスポンスコードの完全な一覧はこちらです" }, "status_message": { "type": [ "string", "null" ], "description": "タスクの情報メッセージ\n一般的な情報メッセージの完全な一覧はこちらです" }, "time": { "type": [ "string", "null" ], "description": "実行時間（秒）" }, "cost": { "type": [ "number", "null" ], "description": "タスクの総コスト（USD）", "format": "double" }, "result_count": { "type": [ "integer", "null" ], "description": "result 配列内の要素数", "format": "int64" }, "path": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "URL パス" }, "data": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "object", "null" ] }, "description": "POST リクエストで指定したものと同じパラメーターを含みます" } } } ``` ### Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeTaskGetResponseInfo `#/components/schemas/Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeTaskGetResponseInfo` ```json { "type": "object", "allOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo" }, { "type": "object", "properties": { "tasks": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeTaskGetTaskInfo" } ] }, "description": "タスクの配列" } } } ] } ``` ### Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeTaskGetResultInfo `#/components/schemas/Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeTaskGetResultInfo` ```json { "type": "object", "properties": { "keyword": { "type": [ "string", "null" ], "description": "キーワード
キーワードは %## がデコードされた状態で返されます（プラス記号 '+' は空白文字にデコードされます）" }, "spell": { "type": [ "string", "null" ], "description": "キーワードの正しいスペル
注意：POST 配列内のキーワードのスペルが誤っている場合、正しいスペルのキーワードのデータが返されます。
キーワードのスペルを確認および検証するために Google Ads API の機能を使用しています。こちらのリンクで詳細を確認できます" }, "location_code": { "type": [ "integer", "null" ], "description": "POST 配列内のロケーションコード
データがない場合、値は null になります" }, "language_code": { "type": [ "string", "null" ], "description": "POST 配列内の言語コード
データがない場合、値は null になります" }, "search_partners": { "type": [ "boolean", "null" ], "description": "パートナー ネットワークからのデータがレスポンスに含まれるかどうかを示します" }, "competition": { "type": [ "string", "null" ], "description": "競合
指定したキーワードの有料 SERP における相対的な競合の程度のみを表します。
この値は Google Ads データに基づき、次の値を取ることができます：HIGH、MEDIUM、LOW。
データがない場合、値は null です。
この指標の詳細についてはこちらのヘルプセンター記事をご覧ください" }, "competition_index": { "type": [ "integer", "null" ], "description": "競合
指定したキーワードの有料 SERP における相対的な競合の程度のみを表します。
この値は Google Ads データに基づき、0 から 100 の範囲（両端を含む）です。
データがない場合、値は null です。
この指標の詳細についてはこちらのヘルプセンター記事をご覧ください" }, "search_volume": { "type": [ "integer", "null" ], "description": "月間平均検索ボリューム", "format": "int64" }, "low_top_of_page_bid": { "type": [ "number", "null" ], "description": "広告を検索結果の 1 ページ目上部に表示するための最低入札額
広告が表示された最低入札額の約 20% を上回る値を示します（Google Ads の広告主統計に基づく）。
この値は POST リクエストで指定した所在地によって異なる場合があります" }, "high_top_of_page_bid": { "type": [ "number", "null" ], "description": "広告を検索結果の 1 ページ目上部に表示するための最大入札額
広告が表示された最低入札額の約 80% を上回る値を示します（Google Ads の広告主統計に基づく）。
この値は POST リクエストで指定した所在地によって異なる場合があります" }, "cpc": { "type": [ "number", "null" ], "description": "クリック単価
指定したキーワードの広告が表示された際のクリックごとの支払額（USD）を示します" }, "monthly_searches": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_MonthlySearchesInfo" } ] }, "description": "月間検索数
指定した地理的位置を対象とした、このキーワード アイデアの（おおよその）検索数（既定では過去 12 か月分の利用可能なデータ）を表します。
データがない場合、値は null です" } } } ``` ### Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeTaskGetTaskInfo `#/components/schemas/Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeTaskGetTaskInfo` ```json { "type": "object", "allOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo" }, { "type": "object", "properties": { "result": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_KeywordsDataGoogleAdsSearchVolumeTaskGetResultInfo" } ] }, "description": "結果の配列" } } } ] } ``` ### Response36Afe1097B20_MonthlySearchesInfo `#/components/schemas/Response36Afe1097B20_MonthlySearchesInfo` ```json { "type": "object", "properties": { "year": { "type": [ "integer", "null" ], "description": "年" }, "month": { "type": [ "integer", "null" ], "description": "月" }, "search_volume": { "type": [ "integer", "null" ], "description": "月間平均検索ボリューム" } } } ```