brand-monitoring/
mentions

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

Brand Mentions API

Web全体の言及
文章ごとの感情スコア
サイト種別で絞り込み
権威性とスパムスコア
1リクエストあたり10クレジット + 結果1件あたり0.02クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Brand Mentions

ブランド言及とは、レビュー、ニュース記事、掲示板のスレッド、商品ページなど、本文にそのブランド名が出てくる公開Webページのことで、名前の前後の文章、著者、言語、国、公開日がセットになっています。これに感情のスコアを付け、ページとドメインの権威性で並べると、ブランドがどこで語られ、話の流れがどちらに傾き、どの情報源が影響力を持つかが見え、評判の監視、広報の効果測定、競合調査に役立ちます。

Brand Mentions API の主な機能

  • キーワード検索と完全一致query には100文字以内のブランド、製品、トピックを指定でき、フレーズを二重引用符で囲むとその語句どおりに一致させられます。
  • サイトの種類で絞り込みcontent_type で news、blogs、message-boards、ecommerce、organization のいずれかに限定でき、各結果の page_types にもサイト種別が入ります。
  • 文章ごとの感情スコアsentiment は肯定・否定・中立の合計1になるスコア、emotions は喜び、愛着、楽しさ、共有、悲しみ、怒りの6つを0〜1で示します。
  • 権威性と品質の指標domain_rank と page_rank は0〜1000で権威性を示し、spam_score と content_quality_score で内容の薄いページやスパム的なページを除けます。
  • 言及の前後関係title、text の該当箇所、author_name、language、country、公開日がある場合の published_at、fetched_at で、言及がいつどこで書かれたかがわかります。
  • 1回で最大1,000ページresults_limit は1〜1000で指定でき、ブランドのWeb上の露出を一度に棚卸しできます。

Brand Mentions API のパラメータ

パラメータ必須説明
query必須探すブランド、製品、トピック(100文字以内)。フレーズを二重引用符で囲むと完全一致になります。
content_type任意言及を集めるサイトの種類:news、blogs、message-boards、ecommerce、organization。
results_limit任意返すページ数(1〜1000)。既定値は100です。

Brand Mentions API の使い方

ブランド名や製品名を送り、1行ずつ言及を読み取ります。

  1. {"query": "notion", "results_limit": 100} を /v1/brand-monitoring/mentions に POST します。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items からページを読み取り、has_more が true なら results.next_cursor で次のページを取得します。
curl -X POST "https://api.socq.ai/v1/brand-monitoring/mentions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"notion","results_limit":100}'

Brand Mentions API の主なユースケース

  • 評判の監視: sentiment.negative が肯定スコアを上回る文章を抜き出し、ページの domain_rank と合わせて優先度を付けて確認します。
  • メディア掲載の追跡: content_type を news にして author_name、published_at、domain_rank を記録し、どの媒体がどれだけの影響力で新製品を取り上げたかを把握します。
  • ブランド間の比較: 自社と競合で同じリクエストを実行し、言及のサイト種別、国、感情の分布を比べます。
  • 掲示板・コミュニティの声を集める: content_type を message-boards に絞り、ユーザーが自分の言葉で製品を語るスレッドを集めます。

Brand Mentions API 活用のヒント

  • 複数語のブランド名は "notion ai" のように二重引用符で囲むと、フレーズ全体で一致させられます。
  • 新しさの判断には published_at を優先し、ない場合は fetched_at を使いましょう。公開日が載っていないページも多くあります。
  • 感情を集計する前に、spam_score が高い行や content_quality_score が低い行を除くと、内容の薄いページに結果が引っ張られません。
  • ページ単位の明細と全体の割合の両方が必要なら、Brand Sentiment Analysis API と組み合わせましょう。

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

  • Brand Sentiment Analysis API — ブランドやトピックがWeb上でどう語られているかを1行で要約し、感情と感情カテゴリごとのページ数と、各グループの主要ドメイン、国、言語を返します。

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

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

Brand Mentions API — よくある質問

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

本文が検索語に一致するインデックス済みのWebページで、ニュース記事、ブログのレビュー、掲示板、ECの商品ページ、企業サイトなどが含まれます。content_type でそのうち1種類に絞れます。

言及の前後の文章を評価します。sentiment は合計1になる肯定・否定・中立の割合、emotions は6種類の感情それぞれの0〜1のスコアです。

できます。query の名前を二重引用符で囲むと、語句どおりに一致させられます。

1リクエストにつき10クレジットに加え、返されたページ1件ごとに0.02クレジットかかります。ページが見つからなかった場合も10クレジットはかかります。