DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Content Analysis – カテゴリトレンド API
post_dataforseo_content_phrase_trends_live と同じ期間ごとの指標を、単一のキーワードではなく製品カテゴリ全体について返します。category_code は get_dataforseo_content_categories から取得し、date_from、date_to、date_group が範囲と粒度を設定します。期間ごとに date に加えて total_count、rank、top_domains（各項目は domain と count）、sentiment_connotations（anger、happiness、love、sadness、share、fun）、connotation_types（positive、negative、neutral）、text_categories、page_categories、page_types、countries、languages を返します。単一のフレーズではなく市場の動きを見るのに使います。対象の正確な表現がすでに分かっている場合は、フレーズエンドポイントに切り替えてください。
料金の参考情報
- 計量方式：レスポンスで報告されるコスト。
- 参考リクエスト見積もり：0.0276 USD。
- 参考顧客乗数：1.0。確定済みの顧客金額に再適用しないでください。
参照用のメタデータのみであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。
- 型: array (object | null)[]
- category型: integer | null
_code - date型: string
_from 時間範囲の開始日
必須フィールド
最小値:2022-10-31
日付形式:"yyyy-mm-dd"
例:"2019-01-15" - date型: string | null
_group 結果のグループ化に使用する時間範囲
任意フィールド
デフォルト値:month
使用可能な値:day、week、month - date型: string | null
_to 時間範囲の終了日
任意フィールド
このフィールドを指定しない場合は、デフォルトで今日の日付が使用されます
日付形式:"yyyy-mm-dd"
例:"2019-01-15" - initial型: array (object | null)[] | null
_dataset _filters 初期データセットのフィルターパラメーター
任意フィールド
Search エンドポイントのフィールドに適用される初期フィルターパラメーター
複数のフィルターを同時に追加できます（最大 8 個）
条件の間には論理演算子and、orを設定してください
次の演算子がサポートされています:regex、not_regex、<、<=、>、>=、=、<>、in、not_in、like、not_like、has、has_not、match、not_matchlikeとnot_likeで%演算子を使用すると、0 文字以上の任意の文字列に一致させられます
例:["domain","<>", "logitech.com"][["domain","<>","logitech.com"],"and",["content_info.connotation_types.negative",">",1000]][["domain","<>","logitech.com"]],
"and",
[["content_info.connotation_types.negative",">",1000],
"or",["content_info.text_category","has",10994]]]
フィルターの詳細については、Content Analysis API のフィルターを参照してください
初期データセットフィルターの詳細については、こちらのヘルプセンター記事をご覧ください。空のオブジェクト - internal型: integer | null
_list _limit 内部配列内の要素の最大数
任意フィールド
このフィールドを使用して、次の配列内の要素数を制限できます:top_domainstext_categoriespage_categoriescountrieslanguages
デフォルト値:1
最大値:20 - page型: array string[] | null
_type ターゲットページタイプ
任意フィールド
このパラメーターを使用して、ページタイプでデータセットをフィルターします
使用可能な値:"ecommerce"、"news"、"blogs"、"message-boards"、"organization" - rank型: string | null
_scale - search型: string | null
_mode 結果のグループ化タイプ
任意フィールド
使用可能なグループ化タイプ:as_is- ターゲットcategory_codeのすべての引用に関するデータを返しますone_per_domain- ドメインごとにcategory_codeの引用 1 件に関するデータを返します
デフォルト値:as_is - tag型: string | null
ユーザー定義のタスク識別子
任意フィールド
文字数上限は 255 です
このパラメーターを使ってタスクを識別し、結果と照合できます
指定したtagの値は、レスポンスのdataオブジェクトに含まれます
- 型: object | null · Response36Afe1097B20_ContentAnalysisCategoryTrendsLiveResponseInfo200
- 型: number | null 形式: doublecost
タスクの総コスト（USD）
- 型: integer | nullstatus
_code 一般的なステータスコード レスポンスコードの完全な一覧はこちらです
- 型: string | nullstatus
_message 一般的な情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- 型: array (object | null)[] | nulltasks
タスクの配列
- 型: object | null · Response36Afe1097B20_ContentAnalysisCategoryTrendsLiveTaskInfo
- 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
結果の配列
- connotation型: object | null
_types 含意タイプ
カテゴリの引用に関連する感情のタイプ（感情の極性）と、感情タイプごとの引用数が含まれます
可能な含意タイプ:"positive"、"negative"、"neutral"- property型: integer | null 形式: int64
Name Signed 64-bit integers (long type).
- countries型: object | null
- property型: integer | null 形式: int64
Name Signed 64-bit integers (long type).
- date型: string | null
データが提供される日付
- languages型: object | null
- property型: integer | null 形式: int64
Name Signed 64-bit integers (long type).
- page型: array (object | null)[] | null
_categories - category型: array (integer | null)[] | null
- count型: integer | null 形式: int64
Signed 64-bit integers (long type).
- page型: object | null
_types ページタイプ
ページタイプと、ページタイプごとの引用数が含まれます- property型: integer | null 形式: int64
Name Signed 64-bit integers (long type).
- rank型: integer | null
keywordを引用しているすべての URL のランク
指定した日付に対象のkeywordを引用しているすべての URL のランクの正規化された合計 - sentiment型: object | null
_connotations 感情の含意
対象カテゴリの引用に関連する感情（感情的反応）と、感情ごとの引用数が含まれます
可能な含意:"anger"、"fear"、"happiness"、"love"、"sadness"、"share"、"neutral"、"fun"- property型: integer | null 形式: int64
Name Signed 64-bit integers (long type).
- text型: array (object | null)[] | null
_categories - category型: array (integer | null)[] | null
- count型: integer | null 形式: int64
Signed 64-bit integers (long type).
- top型: array (object | null)[] | null
_domains 対象キーワードを引用している上位ドメイン
対象カテゴリを引用している上位ドメインのオブジェクトと、ドメインごとの引用数が含まれます- count型: integer | null 形式: int64
Signed 64-bit integers (long type).
- domain型: string | null
- total型: integer | null 形式: int64
_count 当社データベース内のリクエストに関連する結果の総数
- 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/content_analysis/category_trends/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"category_code": 10994,
"search_mode": "as_is",
"date_from": "2022-09-01",
"date_group": "month"
}
]'
{
"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": [
{
"type": null,
"date": null,
"total_count": null,
"rank": null,
"top_domains": [
{
"domain": null,
"count": null
}
],
"sentiment_connotations": null,
"connotation_types": null,
"text_categories": [
{
"category": [
"[Max Depth Exceeded]"
],
"count": null
}
],
"page_categories": [
{
"category": [
"[Max Depth Exceeded]"
],
"count": null
}
],
"page_types": null,
"countries": null,
"languages": null
}
]
}
]
}