brand-monitoring/
sentiment

Web上でブランドがどう語られているかを1回で要約します。ページを肯定・否定・中立と感情で分け、グループごとのページ数と主要なサイト・国を返します。

Brand Sentiment Analysis API

肯定・否定・中立
6つの感情
グループごとの主要サイト
国と言語の内訳
1リクエストあたり10クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

Brand Sentiment Analysis

ブランドの感情とは、そのブランドに触れたWebページ全体のトーンのことで、肯定・否定・中立にどれだけ分かれるか、喜びや愛着から悲しみや怒りまで、どの感情が多く表れているかで表されます。各グループを支えるサイト、国、言語、サイト種別まで分けて見ると、批判がニュース媒体から来ているのか、掲示板なのか、特定の市場なのかがわかり、評判のレポート、キャンペーンの振り返り、競合とのベンチマークに使えます。

Brand Sentiment Analysis API の主な機能

  • 3つの感情グループsentiments は肯定・否定・中立の3グループを返し、各グループの mentions_count はそこに分類されたページ数です。
  • 6つの感情カテゴリemotions は同じページを最も強い感情でグループ分けします:喜び、愛着、楽しさ、共有、悲しみ、怒り。
  • グループを支えるサイトtop_domains はグループ内のページが多いサイトを最大10件挙げ、肯定的・否定的な話題をどこが主導しているかがわかります。
  • 国、言語、サイト種別countries、languages、page_types で各グループのページの出どころを示します。WW は全世界向けサイト、種別には news、blogs、message-boards などがあります。
  • ブランドごとに1行1回のリクエストでその検索語の内訳全体が返るため、日付付きのスナップショットとしてそのまま保存できます。

Brand Sentiment Analysis API のパラメータ

パラメータ必須説明
query必須分析するブランド、製品、トピック(100文字以内)。フレーズを二重引用符で囲むと完全一致になります。

Brand Sentiment Analysis API の使い方

ブランドやトピックを送り、感情の内訳を1行で読み取ります。

  1. {"query": "notion"} を /v1/brand-monitoring/sentiment に POST します。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。幅広い語では数分かかることがあります。
  3. results.items から内訳を読み取ります。has_more と results.next_cursor は通常のページングルールに従い、この1行の結果では空になります。
curl -X POST "https://api.socq.ai/v1/brand-monitoring/sentiment" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"notion"}'

Brand Sentiment Analysis API の主なユースケース

  • 月次の評判スナップショット: 毎月、感情グループごとの mentions_count を記録し、否定的なページの割合の推移をグラフにします。
  • 批判の出どころを特定: 否定グループの top_domains、countries、page_types を見て、批判が一部のサイト、特定の国、掲示板のどこに集まっているかを判断します。
  • 競合とのベンチマーク: 自社と競合を同じ形式の検索語で分析し、肯定・否定・中立のページ数と主な感情を比べます。
  • キャンペーンの振り返り: 施策の前後で喜びや怒りなどの感情グループを比べ、話題の流れがどう変わったかを確認します。

Brand Sentiment Analysis API 活用のヒント

  • 一般的な単語ではなく、具体的な製品名やキャンペーン名を分析しましょう。言及が数百万件に及ぶ幅広い語は完了まで数分かかることがあります。
  • 競合の分析は自社と同じ日に実行すると、すべてのスナップショットが同じ時点のWebを反映します。
  • いずれかのグループの数値が大きく動いたら、同じ query で Brand Mentions API を呼び出し、その背後のページを読んでみましょう。

Brand Sentiment Analysis API 以外に別の種類の公開Brand Monitoringデータが必要な場合は、これらのAPIをご利用ください。

  • Brand Mentions API — ブランド、製品、トピックに言及したWebページを探し、該当箇所の文章、著者、日付、サイト種別、感情・感情カテゴリのスコア、ページとドメインの権威性を返します。

他のプラットフォームを見る

Brand Monitoringのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

Brand Sentiment Analysis API — よくある質問

Brand Sentiment Analysis API は、ブランド、製品、トピックに言及したWebページのトーンを要約するAPIで、肯定・否定・中立の3グループと6つの感情グループのページ数、各グループの主要サイト、国、言語、サイト種別を返します。

Brand Mentions API はページを1件ずつ、それぞれのスコア付きで返します。Brand Sentiment Analysis API は一致したページ全体を感情と感情カテゴリでグループ分けした要約を1行で返します。

喜び、愛着、楽しさ、共有、悲しみ、怒りの6つで、それぞれが独立したグループとしてページ数と出どころの内訳付きで返ります。

ほとんどの検索語は1分もかからずに完了します。一致するページが数百万件に及ぶ幅広い語では数分かかることがあります。

1リクエスト10クレジットで、1行を返します。