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行ずつ言及を読み取ります。
- {"query": "notion", "results_limit": 100} を /v1/brand-monitoring/mentions に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- 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 と組み合わせましょう。
関連API
Brand Mentions API 以外に別の種類の公開Brand Monitoringデータが必要な場合は、これらのAPIをご利用ください。
- Brand Sentiment Analysis API — ブランドやトピックがWeb上でどう語られているかを1行で要約し、感情と感情カテゴリごとのページ数と、各グループの主要ドメイン、国、言語を返します。