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行で読み取ります。
- {"query": "notion"} を /v1/brand-monitoring/sentiment に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。幅広い語では数分かかることがあります。
- 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 を呼び出し、その背後のページを読んでみましょう。
関連API
Brand Sentiment Analysis API 以外に別の種類の公開Brand Monitoringデータが必要な場合は、これらのAPIをご利用ください。
- Brand Mentions API — ブランド、製品、トピックに言及したWebページを探し、該当箇所の文章、著者、日付、サイト種別、感情・感情カテゴリのスコア、ページとドメインの権威性を返します。