Brand Monitoring API
ブランド、製品、トピックに言及したWebページを探し、ページごとに感情をスコア化し、Web全体での語られ方を要約します。
利用できるBrand Monitoring API
ページ単位の根拠を感情・権威性スコア付きで見るなら Brand Mentions API、感情と感情カテゴリで分けた要約1行なら Brand Sentiment Analysis API を使います。
取得できるブランドモニタリングデータ
2つのAPIは同じインデックス済みWebページを対象にし、一方はページそのものを、もう一方はその要約を返します。
Webページ上の言及
ページタイトル、URL、言及の前後の文章、著者、ドメイン、言語、国、公開日または取得日。
感情と感情カテゴリ
合計1になる肯定・否定・中立の割合と、喜び、愛着、楽しさ、共有、悲しみ、怒りの0〜1のスコア。
権威性と品質
0〜1000のドメイン・ページランクと、0〜100のスパムスコアとコンテンツ品質スコア。
サイト種別
各ページがニュース、ブログ、掲示板、ECページ、組織サイトのどれにあたるか。
感情の内訳
感情グループ・感情カテゴリごとのページ数と、各グループの主要ドメイン、国、言語、ページ種別。
Brand Mentions と Brand Sentiment Analysis の使い分け
全体像とその背後のページの両方が必要なときは、同じ query で両方を実行します。
| 比較項目 | Brand Mentions API | Brand Sentiment Analysis API |
|---|---|---|
| 結果 | Webページごとに1行 | query ごとに要約1行 |
| 感情 | 各ページの該当箇所のスコア | 感情グループ・感情カテゴリごとのページ数 |
| 情報源 | ページごとのドメイン、著者、サイト種別、権威性 | グループごとの主要ドメイン、国、言語、ページ種別 |
| 指定できる条件 | query、content_type、最大1,000の results_limit | query |
| 料金 | 1リクエスト10クレジット+1ページ0.02クレジット | 1リクエスト10クレジット |
Brand Monitoring APIの仕組み
2つのAPIは同じ非同期タスクの流れで動きます。
1. query を送る
ブランド、製品、トピックを /v1/brand-monitoring/mentions または /v1/brand-monitoring/sentiment に POST します。
2. タスクを追う
status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。幅広い語では数分かかることがあります。
3. 結果を読む
results.items からページ一覧または要約行を読み取ります。
SocQ APIキーで認証し、ブランド名を送ります。1リクエスト10クレジットに加え、返されたページ1件ごとに0.02クレジットかかります。
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}'
# Poll GET /v1/tasks/{task_id}
# Read the mentions in results.itemsBrand Monitoring APIの主なユースケース
評判の監視
権威性の高いページにある否定的な文章を見つけ、優先して確認します。
メディア掲載の追跡
発表やリリースの後、ニュースでの言及を著者、日付、ドメインランク付きで集めます。
競合とのベンチマーク
自社と競合の感情、感情カテゴリ、情報源の構成を比べます。
コミュニティの声
ユーザーが自分の言葉で製品を語る掲示板のスレッドを集めます。
キャンペーンの振り返り
キャンペーン前後で感情グループと感情カテゴリを比べます。
リクエストのルールと料金
以下のルールは2つのBrand Monitoring APIに共通です。
- query には100文字以内のブランド、製品、トピックを指定し、フレーズを二重引用符で囲むと完全一致になります。
- Brand Mentions API の content_type は news、blogs、message-boards、ecommerce、organization から選べ、1回で1〜1,000ページ(既定は100)を返します。
- 感情の要約はほとんど1分以内に完了し、一致するページが数百万件に及ぶ幅広い語では数分かかることがあります。
- Brand Mentions API は1リクエスト10クレジット+返されたページ1件ごとに0.02クレジット、Brand Sentiment Analysis API は1リクエスト10クレジットです。
Brand Monitoring APIに関するよくある質問
Brand Monitoring APIとは何ですか?
Brand Monitoring API は、ブランド、製品、トピックに言及したWebページを探して感情を測るAPI群で、Brand Mentions API でページごとに、Brand Sentiment Analysis API で要約1行として取得できます。
どのBrand Monitoring APIが使えますか?
ページごとに感情、感情カテゴリ、権威性のスコアを返す Brand Mentions API と、一致したページ全体の感情と感情カテゴリの内訳を返す Brand Sentiment Analysis API です。
どのようなサイトが対象ですか?
ニュース記事、ブログ、掲示板、ECページ、組織サイトなど、インデックス済みの公開Webページです。
感情はどのように測定されますか?
各言及の前後の文章を肯定・否定・中立と6つの感情で評価し、感情の要約ではこのスコアでページをグループ分けします。
Brand Monitoringのリクエスト料金は?
Brand Mentions API は1リクエスト10クレジットに加えて返されたページ1件ごとに0.02クレジット、Brand Sentiment Analysis API は1リクエスト10クレジットです。
プラットフォームを横断してデータを組み合わせ、より包括的なビジネスインサイトを
さまざまなプラットフォームの公開プロフィール、コンテンツ、エンゲージメントデータを1つのワークフローに集約し、ブランド、クリエイター、トピックの追跡やクロスプラットフォームのモニタリング・分析をより効率的に行えます。
AI Search API
AI概要、ChatGPT、GoogleのAIモードが市場の質問にどう答えているかを追跡します。ブランドに触れた回答、可視性の高さ、引用されているドメインとページがわかります。
Instagram API
公開プロフィールを検索・照会し、フォロワーリストのレコード、フォロー関係、投稿、プロフィールがタグ付けされた投稿、ハッシュタグの検索結果、リール、文字起こし、コメント、アカウント数値、エンゲージメント指標、メディアのメタデータを、1つの非同期ワークフローで取得できます。
TikTok API
対応する公開TikTokプロフィール、個別動画のメタデータ、トップレベルコメント、動画の検索結果、指定したハッシュタグの動画を、正規化された1つの非同期ワークフローで取得できます。
YouTube API
対応する公開YouTubeのチャンネルプロフィール、動画の詳細、チャンネルの動画、コメント、ショート、キーワード・ハッシュタグの検索結果、取得可能な文字起こしを、正規化された1つの非同期ワークフローで取得できます。
Facebook API
公開Facebookページのプロフィール、投稿、グループ投稿、コメント、キーワードに一致するイベント、取得可能な動画の文字起こしを取得できます。アカウント情報、コンテンツ、取得元、形式、場所、メディア、リアクション、参加状況、エンゲージメントのフィールドは正規化されています。
X API
公開プロフィール、フォロワー・フォロー中の関係、ポスト、返信、引用、リツイートしたユーザー、検索結果、現在のトレンドを取得できます。一貫した形式の結果を調査やモニタリングに活用できます。

