DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Content Analysis – 検索 API
キーワードを引用している個々のページを、合計ではなく一覧します。各項目には url、domain、main_domain、url_rank、domain_rank、spam_score、fetch_time、country、language、score、page_category に加えて total_count と items_count が含まれます。filters は get_dataforseo_content_available_filters に一覧されたフィールドを受け付けます。ページではなく件数と分布が必要な場合は post_dataforseo_content_summary_live を使用してください。
料金の参考情報
- 計量方式：レスポンスで報告されるコスト。
- 参考リクエスト見積もり：0.0276 USD。
- 参考顧客乗数：1.0。確定済みの顧客金額に再適用しないでください。
参照用のメタデータのみであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。
- 型: array (object | null)[]
- filters型: array (object | null)[] | null
結果フィルターパラメーターの配列
任意フィールド
複数のフィルターを同時に追加できます（最大 8 個）
条件の間には論理演算子and、orを設定してください
次の演算子がサポートされています:regex、not_regex、<、<=、>、>=、=、<>、in、not_in、like、not_like、match、not_matchlikeとnot_likeで%演算子を使用すると、0 文字以上の任意の文字列に一致させられます
例:["country","=", "US"][["domain_rank",">",800],"and",["content_info.connotation_types.negative",">",0.9]][["domain_rank",">",800],
"and",
[["page_types","has","ecommerce"],
"or",["content_info.text_category","has",10994]]]
フィルターの詳細については、Content Analysis API のフィルターを参照してください空のオブジェクト - keyword型: string
- keyword型: object | null
_fields ターゲットキーワードフィールドとターゲットキーワード
任意フィールド
このパラメーターを使用して、特定のフィールドに含まれるキーワードでデータセットをフィルターします
指定できるフィールド:title、main_title、previous_title、snippet
複数のフィールドを指定できます
注意: 単独のキーワードではなく完全なフレーズに一致させるには、二重引用符とバックスラッシュを使用します
例:"keyword_fields": {<br>"snippet": "\"logitech mouse\"",<br>"main_title": "sale"<br>}"- property型: string | null
Name
- limit型: integer | null
返される引用の最大数
任意フィールド
デフォルト値:100
最大値:1000 - offset型: integer | null
返される引用の結果配列内のオフセット
任意フィールド
デフォルト値:010を指定すると、結果配列の最初の 10 件の引用がスキップされ、後続の引用のデータが返されます
注意: このパラメーターは最大 10,000 件の結果を取得する場合にのみ使用することをお勧めします
10,000 件を超える結果を取得する場合は、代わりにoffset_tokenを使用してください。 - offset型: string | null
_token - order型: array string[] | null
_by 結果の並び替えルール
任意フィールドfilters配列と同じ値を使用して結果を並び替えられます
指定可能な並び替えの種類:asc- 結果を昇順で並び替えますdesc- 結果を降順で並び替えます
並び替えの種類はカンマで設定します
例:["content_info.sentiment_connotations.anger,desc"]
デフォルトのルール:["content_info.sentiment_connotations.anger,desc"]
1 回のリクエストで設定できる並び替えルールは 3 つまでです
複数の並び替えルールはカンマで区切ります
例:["content_info.sentiment_connotations.anger,desc","keyword_data.keyword_info.cpc,desc"] - page型: array string[] | null
_type ターゲットページタイプ
任意フィールド
このパラメーターを使用して、ページタイプでデータセットをフィルターします
使用可能な値:"ecommerce"、"news"、"blogs"、"message-boards"、"organization" - rank型: string | null
_scale - search型: string | null
_mode 結果のグループ化タイプ
任意フィールド
使用可能なグループ化タイプ:as_is- ターゲットkeywordのすべての引用に関するデータを返しますone_per_domain- ドメインごとにkeywordの引用 1 件に関するデータを返します
デフォルト値:as_is - tag型: string | null
ユーザー定義のタスク識別子
任意フィールド
文字数上限は 255 です
このパラメーターを使ってタスクを識別し、結果と照合できます
指定したtagの値は、レスポンスのdataオブジェクトに含まれます
- 型: object | null · Response36Afe1097B20_ContentAnalysisSearchLiveResponseInfo200
- 型: number | null 形式: doublecost
タスクの総コスト（USD）
- 型: integer | nullstatus
_code 一般的なステータスコード レスポンスコードの完全な一覧はこちらです
- 型: string | nullstatus
_message 一般的な情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- 型: array (object | null)[] | nulltasks
タスクの配列
- 型: object | null · Response36Afe1097B20_ContentAnalysisSearchLiveTaskInfo
- 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
引用と関連データが含まれます
- content型: object | null · Response36Afe1097B20_AnalysisContentInfo
_info 指定された
urlからの引用に関するデータが含まれます- author型: string | null
コンテンツの作成者
- connotation型: object | null
_types 意味合いのタイプ
特定の引用に関連する感情のタイプ（感情の極性）と、感情タイプごとの確率指数を含みます
指定可能な感情の意味合いタイプ:positive、negative、neutral- property型: integer | null 形式: int64
Name Signed 64-bit integers (long type).
- content型: integer | null
_quality _score コンテンツ品質スコア
この値は、コンテンツに含まれる単語、文、文字数に基づいて計算されます - content型: string | null
_type コンテンツのタイプ
例:page_content、comment - date型: string | null
_published コンテンツが公開された日時
UTC 形式: "yyyy-mm-dd hh-mm-ss +00:00"
例:2017-01-24 13:20:59 +00:00 - group型: string | null
_date 引用グループの日時
コンテンツの公開日、またはクローラーが初めてページを訪問した日時を示します。
このフィールドは、引用を日付でグループ化し、引用トレンドを表示するために使用できます。
日時は UTC 形式で指定されます: "yyyy-mm-dd hh-mm-ss +00:00"
例:2017-01-24 13:20:59 +00:00 - highlighted型: string | null
_text snippetからのハイライトテキスト - language型: string | null
- level型: integer | null
title見出しレベル
h タグのレベルを1（最上位）から6（最下位）で示します - main型: string | null
_title ページタイトル
- previous型: string | null
_title 前のコンテンツブロックのタイトル
- rating型: object | null · Response36Afe1097B20_ContententRatingInfo
コンテンツ評価
content_infoに関連する評価- max型: number | null 形式: double
_rating _value 評価名の最大値
- name型: string | null
評価名 ここでは次の要素を確認できます: Max5、Percents、CustomMax
- rating型: integer | null 形式: int64
_count 投票数
- rating型: number | null 形式: double
_value 評価の値
- relative型: number | null 形式: double
_rating 相対評価
- semantic型: string | null
_location セマンティックな位置
対象キーワードの引用が存在する HTML のセマンティック要素を示します
例:article、header - sentiment型: object | null
_connotations 感情の意味合い
特定の引用に関連する感情（感情的反応）と、感情ごとの確率指数を含みます
指定可能な感情の意味合い:anger、happiness、love、sadness、share、fun- property型: integer | null 形式: int64
Name Signed 64-bit integers (long type).
- snippet型: string | null
コンテンツスニペット
- snippet型: integer | null
_length スニペットの文字数
- social型: array (object | null)[] | null
_metrics ソーシャルメディアのエンゲージメント指標
ソーシャルメディアプラットフォームが開発・サポートするウェブサイト埋め込みに基づく、コンテンツに関連するソーシャルメディアのインタラクションデータ- like型: integer | null 形式: int64
_count いいね数
- type型: string | null
要素の種類
- text型: array integer[] | null
_category - title型: string | null
結果のタイトル
- country型: string | null
- domain型: string | null
ドメイン名
- domain型: integer | null
_rank - fetch型: string | null
_time クローラーがページを訪問した日時
UTC 形式: "yyyy-mm-dd hh-mm-ss +00:00"
例:2017-01-24 13:20:59 +00:00 - language型: string | null
- main型: string | null
_domain メインドメイン
- page型: array integer[] | null
_category - page型: array string[] | null
_types ページタイプ
- ratings型: array (object | null)[] | null
ページ上で見つかった評価
マイクロデータに基づいてページ上で見つかったすべての評価- max型: number | null 形式: double
_rating _value 評価名の最大値
- name型: string | null
評価名 ここでは次の要素を確認できます: Max5、Percents、CustomMax
- rating型: integer | null 形式: int64
_count 投票数
- rating型: number | null 形式: double
_value 評価の値
- relative型: number | null 形式: double
_rating 相対評価
- score型: number | null
引用のプロミネンススコア
この値は、url_rank、domain_rank、keywordのtitle、main_title、url、snippetにおける出現状況に基づきますscoreが高いほど、関連する引用の価値が高くなります - social型: array (object | null)[] | null
_metrics ソーシャルメディアのエンゲージメント指標
ソーシャルメディアプラットフォームが開発・サポートするウェブサイト埋め込みに基づく、コンテンツに関連するソーシャルメディアのインタラクションデータ- like型: integer | null 形式: int64
_count いいね数
- type型: string | null
要素の種類
- spam型: integer | null
_score - type型: string | null
要素の種類
- url型: string | null
引用が見つかった URL
- url型: integer | null
_rank
- items型: integer | null 形式: int64
_count items配列で返される結果の数 - offset型: string | null
_token 後続リクエスト用のオフセットトークン
このフィールドで提供される文字列を使用して、最初のタスクの後続結果を取得できます；
注意:offset_tokenの値は後続のタスクごとに一意です - 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/content_analysis/search/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword_fields": {
"snippet": "logitech"
},
"keyword": "logitech",
"page_type": [
"ecommerce",
"news",
"blogs",
"message-boards",
"organization"
],
"search_mode": "as_is",
"filters": [
"main_domain",
"=",
"reviewfinder.ca"
],
"order_by": [
"content_info.sentiment_connotations.anger,desc"
],
"limit": 10
}
]'
{
"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": [
{
"offset_token": null,
"total_count": null,
"items_count": null,
"items": [
{
"type": null,
"url": null,
"domain": null,
"main_domain": null,
"url_rank": null,
"spam_score": null,
"domain_rank": null,
"fetch_time": null,
"country": null,
"language": null,
"score": null,
"page_category": [
"[Max Depth Exceeded]"
],
"page_types": [
"[Max Depth Exceeded]"
],
"ratings": [
"[Max Depth Exceeded]"
],
"social_metrics": [
"[Max Depth Exceeded]"
],
"content_info": "[Max Depth Exceeded]"
}
]
}
]
}
]
}