DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
「DataForSEO Trends 探索」ライブタスクの設定
最大 5 つの keywords についての関心の推移、すなわち Google Trends の曲線です。keywords、type、location_code、language_code、datetime、items_count、items を返します。type で web、news、images、youtube、shopping を選択し、date_from/date_to で期間を設定します。DataForSEO のエンベロープに包まれます。データは tasks[0].result、結果は tasks[0].status_code に格納され、拒否されたリクエストでも HTTP 200 が返ります。Trends が返すのは絶対的なボリュームではなく相対的な関心です。件数が必要な場合は post_dataforseo_keywords_gads_search_volume_live を使用してください。
料金の参考情報
- 計量方式：報告されたレスポンスコスト。
- 参考リクエスト見積もり：0.0012 USD。
- 参照用の顧客乗数：1.0。確定済みの顧客金額に再適用しないでください。
参照用のメタデータのみであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。
- 型: array (object | null)[]
- date型: string | null
_from 期間の開始日
任意フィールド
このフィールドを指定しない場合、前年の同じ日付と月がデフォルトで使用されますwebタイプの最小値:2004-01-01
その他のタイプの最小値:2008-01-01
日付形式:"yyyy-mm-dd"
例:"2019-01-15" - date型: string | null
_to 期間の終了日
任意フィールド
このフィールドを指定しない場合、今日の日付がデフォルトで使用されます
日付形式:"yyyy-mm-dd"
例:"2019-01-15" - keywords型: array string[]
- location型: integer | null
_code 検索エンジンのロケーションコード
任意フィールド
このフィールドを使用しない場合、グローバルな結果が返されます
このフィールドを使用する場合、location_nameを指定する必要はありません
別途https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locationsにリクエストを送信すると、検索エンジンの利用可能なロケーションとそのlocation_codeの一覧を取得できます
指定したlocation_codeが属する国・地域のデータが提供されることに注意してください；
例：2840 - location型: string | null
_name 検索エンジンのロケーションの正式名称
任意フィールド
このフィールドを使用しない場合、グローバルな結果が返されます
このフィールドを使用する場合、location_codeを指定する必要はありません
別途https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locationsにリクエストを送信すると、検索エンジンの利用可能なロケーションとそのlocation_nameの一覧を取得できます
指定したlocation_nameが属する国・地域のデータが提供されることに注意してください；
例：United Kingdom - tag型: string | null
ユーザー定義のタスク識別子
任意フィールド
文字数上限は 255 です
このパラメーターを使ってタスクを識別し、結果と照合できます
指定したtagの値は、レスポンスのdataオブジェクトに含まれます - time型: string | null
_range プリセットの期間
任意フィールドdate_fromまたはdate_toパラメーターを指定した場合、タスクの設定時にこのフィールドは無視されます
すべてのtypeパラメーターで指定可能な値：past_4_hours、past_day、past_7_days、past_30_days、past_90_days、past_12_months、past_5_years - type型: string | null
要素の種類
- 型: object | null · Response36Afe1097B20_KeywordsDataDataforseoTrendsExploreLiveResponseInfo200
- 型: number | null 形式: doublecost
タスクの総コスト（USD）
- 型: integer | nullstatus
_code 一般的なステータスコード レスポンスコードの完全な一覧はこちらです
- 型: string | nullstatus
_message 一般的な情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- 型: array (object | null)[] | nulltasks
タスクの配列
- 型: object | null · Response36Afe1097B20_KeywordsDataDataforseoTrendsExploreLiveTaskInfo
- 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
結果の配列
- datetime型: string | null
結果を受信した日時
UTC 形式：“yyyy-mm-dd hh-mm-ss +00:00”
例：2019-11-15 12:57:46 +00:00 - items型: array (object | null)[] | null
キーワードの人気度と関連データを含みます
- 型: object | null · Response36Afe1097B20_DataforseoTrendsDataforseoTrendsGraphElementItem
- 型: object · Response36Afe1097B20_DataforseoTrendsDataforseoTrendsGraphElementItem
- type識別子型: string | null
要素の種類
- averages型: array (integer | null)[] | null
- data型: array (object | null)[] | null
POST リクエストで指定したものと同じパラメーターを含みます
- date型: string | null
_from 対応する期間の開始日
UTC 形式: "yyyy-mm-dd" - date型: string | null
_to 対応する期間の終了日
UTC 形式: "yyyy-mm-dd" - timestamp型: integer | null
- values型: array (integer | null)[] | null
特定のタイムスタンプにおけるキーワードの相対人気度
指定した期間のキーワード人気度を表します
複数のキーワードを指定した場合、値は指定したすべてのキーワードの最高値を基準に平均されます
値 100 はその用語のピーク人気度です。値 50 はその用語の人気度が半分であることを意味します。スコア 0 はその用語のデータが不十分であることを意味します
- keywords型: array (string | null)[] | null
POST 配列内のキーワード
- position型: integer | null
要素の配置
次の値を指定できます:1、2、3、4など
- items型: integer | null 形式: int64
_count items配列で返された結果数 - keywords型: array (string | null)[] | null
POST 配列内のキーワード
- language型: string | null
_code POST 配列内の言語コード
データがない場合、値はnullになります - location型: integer | null
_code POST 配列内のロケーションコード
データがない場合、値はnullになります - type型: 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/dataforseo_trends/explore/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keywords": [
"iphone 14",
"samsung s23"
],
"location_code": 2840
}
]'
{
"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": [
{
"keywords": [
null
],
"type": null,
"location_code": null,
"language_code": null,
"datetime": null,
"items_count": null,
"items": [
{
"type": "[Max Depth Exceeded]",
"position": "[Max Depth Exceeded]",
"keywords": "[Max Depth Exceeded]",
"data": "[Max Depth Exceeded]",
"averages": "[Max Depth Exceeded]"
}
]
}
]
}
]
}