DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
過去のトラフィック一括推定
多数のドメインの推定自然検索トラフィックを、利用可能な履歴の各時点について示します。post_dataforseo_labs_google_bulk_traffic_estimation_live の背景にある時系列です。このエンドポイントは limit パラメータを受け付けませんが、項目単位ではなく呼び出し単位で課金されるため、リスト全体を一度に送信してください。DataForSEO のエンベロープに包まれます。データは tasks[0].result、結果は tasks[0].status_code に格納され、拒否されたリクエストでも HTTP 200 が返ります。⚠️ レスポンスサイズはドメイン数と日付数の積になります。両方のリストを短く保ってください。利用可能な日付は get_dataforseo_labs_google_available_history から取得します。
料金の参考情報
- 計量方式：レスポンスで報告されるコスト。
- 参考リクエスト見積もり：0.1356 USD。
- 参考顧客乗数：1.0。確定済みの顧客金額に再適用しないでください。
参照用のメタデータのみであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。
- 型: array (object | null)[]
- date型: string | null
_from 期間の開始日
任意フィールド
このフィールドを指定しない場合、過去 12 か月分のデータが提供されます
指定可能な最小値：2020-10-01
日付形式："yyyy-mm-dd" - date型: string | null
_to 期間の終了日
任意フィールド
このフィールドを指定しない場合、デフォルトで今日の日付が使用されます；
日付形式："yyyy-mm-dd"
例："2021-04-01" - ignore型: boolean | null
_synonyms 類似性の高いキーワードを無視
任意フィールドtrueに設定すると、コアキーワードのみが返され、類似性の高いキーワードはすべて除外されます；
デフォルト値：false - item型: array string[] | null
_types アイテムタイプ別に結果を表示
任意フィールド
レスポンスに含める検索結果のタイプを示します；
注意：item_types配列にorganic以外のアイテムタイプが含まれている場合、結果は配列内の最初のアイテムタイプ順に並べられます；
指定可能な値：["organic", "paid", "featured_snippet", "local_pack"]
デフォルト値：["organic", "paid"] - language型: string | null
_code 言語コード
このフィールドを使用する場合、language_nameを指定する必要はありません
別途https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languagesにリクエストを送信すると、利用可能な言語とそのlanguage_codeの一覧を取得できます
このフィールドを無視すると、利用可能なすべての言語の結果を取得できます
例：en - language型: string | null
_name 言語の正式名称
このフィールドを使用する場合、language_codeを指定する必要はありません
別途https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languagesにリクエストを送信すると、利用可能な言語とそのlanguage_nameの一覧を取得できます
このフィールドを無視すると、利用可能なすべての言語の結果を取得できます
例：English - location型: integer | null
_code ロケーションコード
このフィールドを使用する場合、location_nameを指定する必要はありません
別途https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languagesにリクエストを送信すると、利用可能なロケーションとそのlocation_codeの一覧を取得できます
このフィールドを無視すると、利用可能なすべてのロケーションの結果を取得できます
例：2840 - location型: string | null
_name ロケーションの正式名称
このフィールドを使用する場合、location_codeを指定する必要はありません
別途https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languagesにリクエストを送信すると、利用可能なロケーションとそのlocation_nameの一覧を取得できます
このフィールドを無視すると、利用可能なすべてのロケーションの結果を取得できます
例：United Kingdom - tag型: string | null
ユーザー定義のタスク識別子
任意フィールド
文字数上限は 255 です
このパラメーターを使ってタスクを識別し、結果と照合できます
指定したtagの値は、レスポンスのdataオブジェクトに含まれます - targets型: array string[]
ターゲットのドメインとサブドメイン
必須フィールド
このフィールドにはドメインとサブドメインを指定できます；
ドメインとサブドメインはhttps://とwww.を付けずに指定します；
最大 1000 個のドメインまたはサブドメインを設定できます
- 型: object | null · Response36Afe1097B20_DataforseoLabsGoogleHistoricalBulkTrafficEstimationLiveResponseInfo200
- 型: number | null 形式: doublecost
タスクの総コスト（USD）
- 型: integer | nullstatus
_code 一般的なステータスコード レスポンスコードの完全な一覧はこちらです
- 型: string | nullstatus
_message 一般的な情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- 型: array (object | null)[] | nulltasks
タスクの配列
- 型: object | null · Response36Afe1097B20_DataforseoLabsGoogleHistoricalBulkTrafficEstimationLiveTaskInfo
- 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
結果の配列
- items型: array (object | null)[] | null
関連するトラフィック推定データを含む項目の配列
- metrics型: object | null · Response36Afe1097B20_HistoricalMetricsBundleInfo
指定したドメインに関連するトラフィックデータ
- featured型: array (object | null)[] | null
_snippet Google SERP の注目スニペット結果のトラフィックデータ
- local型: array (object | null)[] | null
_pack SERP のローカルパック結果のトラフィックデータ
- organic型: array (object | null)[] | null
オーガニック検索のトラフィックデータ
- paid型: array (object | null)[] | null
有料検索のトラフィックデータ
- se型: string | null
_type 検索エンジンの種類
- target型: string | null
POST 配列のターゲットドメイン
- items型: integer | null 形式: int64
_count items配列で返される結果の数 - language型: string | null
_code POST 配列内の言語コード
データがない場合、値はnullになります - location型: integer | null
_code POST 配列内のロケーションコード
データがない場合、値はnullになります - se型: string | null
_type 検索エンジンの種類
- total型: integer | null 形式: int64
_count 当社データベース内のリクエストに関連する結果の総数
- 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/dataforseo_labs/google/historical_bulk_traffic_estimation/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"targets": [
"dataforseo.com",
"cnn.com",
"forbes.com"
],
"location_code": 2840,
"language_code": "en",
"date_from": "2021-01-01",
"date_to": "2021-03-29",
"item_types": [
"organic",
"paid"
]
}
]'
{
"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": [
{
"se_type": null,
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"items": [
{
"se_type": null,
"target": null,
"metrics": "[Max Depth Exceeded]"
}
]
}
]
}
]
}