ブランドモニタリングは、たいてい2つの問いから始まります。ウェブのどこで自社が話題になっているのか、そして自社はどう受け止められているのか、です。1つ目の問いには、読んで担当者に振り分けられるページ単位のデータが必要です。2つ目の問いには、何百万ものページをダウンロードせずにグラフにできる集計データが必要です。
2026-11-17、SocQはそれぞれの問いに1つずつエンドポイントを用意したBrand Monitoringプラットフォームを公開しました。このガイドでは、各エンドポイントが返す内容、リクエスト、料金、使い分けを説明します。
結論: ブランド、製品、トピックを
queryに指定してPOST /v1/brand-monitoring/mentionsに送信すると、それに言及しているウェブページのリストが、それぞれ感情・エモーション・オーソリティのスコア付きで得られます。同じqueryをPOST /v1/brand-monitoring/sentimentに送信すると、すべての言及を感情とエモーションで分類した1行が得られます。結果はGET /v1/tasks/{task_id}をポーリングして取得します。
新しいBrand Monitoringエンドポイント
1 SocQクレジット = $0.005です。
| エンドポイント | 返される内容 | 料金 |
|---|---|---|
| Brand Mentions API | クエリに言及しているウェブページごとに1行:URL、タイトル、言及箇所の前後の文章、著者、言語、国、サイトの種類、感情とエモーションのスコア、ページとドメインのオーソリティ | 1リクエストあたり10クレジット($0.05)+ 1ページあたり0.02クレジット($0.0001) |
| Brand Sentiment Analysis API | クエリに言及しているすべてのページを、主な感情と最も強いエモーションでグループ化した1行。各グループのページ数と、上位のサイト、国、言語、サイトの種類を含む | 1回あたり10クレジット($0.05) |
Brand Mentionsでは、ページが1件も見つからなかった場合にも10クレジットの基本料金がかかります。
認証と非同期タスクの流れ
SocQのリクエストはすべてAPIキーで認証します。送信、タスクのステータス確認、結果の取得のいずれにも同じヘッダーを使います。
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
収集はすべてバックグラウンドのタスクとして実行されます。
submit -> task_id -> queued -> running -> succeeded
\-> failed
送信のレスポンスにはdata.task_idとdata.statusが含まれます。そのIDでタスクをポーリングします。
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
statusがsucceededになると、レスポンスのdata.results.itemsに正規化されたレコードの最初のページが含まれます。limitのデフォルトは50で、最大500まで指定できます。has_moreがtrueなら、results.next_cursorをcursorとして渡して次のページを読み取ります。タスクがqueued、running、failedの間は、エンドポイントはresultsなしでタスクのメタデータを返します。
送信ボディに任意のcallback_urlを指定すると、タスクの完了時にSocQがタスクの概要を1回POSTします。レコードはGET /v1/tasks/{task_id}で読み取ってください。クライアント側でタイムアウトしてもタスクはキャンセルされないため、重複して支払わないよう、同じタスクIDで再開してください。402はクレジット不足、429はキーがレート制限またはクレジットの上限に達したことを意味します。
Brand Mentions API:自社に言及しているすべてのページ
Brand Mentions APIは、ウェブ全体からクエリに言及しているページを返します。ブログのレビュー、ニュース記事、フォーラムのスレッド、商品ページなどです。queryには、最大100文字でブランド、製品、トピックを指定します。フレーズを完全一致で検索するには、ダブルクォートで囲みます。content_typeを使うと、結果をnews、blogs、message-boards、ecommerce、organizationのいずれかのサイトに限定できます。results_limitのデフォルトは100で、1〜1,000を指定できます。
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
}'
各行は1つのページを表します。
- どこで:
url、title、domain、language、country(2文字。WWは全世界を意味します)、そしてnews、blogs、ecommerceなどのpage_types。 - 何が:
text(言及箇所の前後の文章)と、記載がある場合はauthor_name。 - どう受け止められているか:
sentimentには合計が1になる0〜1のpositive、negative、neutralのスコアが、emotionsには0〜1の6つのスコアhappiness、love、fun、share、sadness、angerが入ります。 - どれだけ重要か:
content_quality_score(0〜100)、spam_score(0〜100で、高いほどスパムの兆候が多い)、domain_rankとpage_rank(0〜1,000)。 - いつ:
fetched_at。そのページが最後に読み取られた日時です。
オーソリティとスパムのスコアを使えば、大量の結果を並べ替えて、オーソリティが高くスパムの少ないページからチームが読めるようにできます。また、感情の内訳から、返信が必要なページを洗い出せます。100ページで12クレジット($0.06)、上限の1,000ページで30クレジット($0.15)です。フィールドの一覧:Brand Mentionsのドキュメント。
報道だけを追跡するには、フィルターを追加します。
{
"query": "\"notion ai\"",
"content_type": "news",
"results_limit": 200
}
Brand Sentiment Analysis API:数字の背後にある内訳
Brand Sentiment Analysis APIは、個々のページを返さずに「ウェブは自社をどう受け止めているか」に答えます。クエリに言及しているページは、主な感情ごとに、また別途、最も強いエモーションごとにグループ化されます。各グループには、含まれるページ数と、最も多く寄与しているサイト、国、言語、サイトの種類が示されます。
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"
}'
結果の1行には、2つの配列が含まれます。
sentiments:positive、negative、neutralごとに1グループ。emotions:happiness、love、fun、share、sadness、angerごとに1グループ。
各グループにはlabel、mentions_count、そしてtop_domains、countries、languages、page_typesがあり、いずれもnameとcountのリストで、多い順に並んでいます。この構造により、批判がニュースメディアから来ているのか1つのフォーラムから来ているのか、どの国が発信源になっているのかを判断できます。1リクエストあたり10クレジット($0.05)です。言及が何百万件もある非常に広い語句は、分析に最大で数分かかることがあるため、気長にポーリングしてください。Brand Sentiment Analysisのドキュメントを参照してください。
どのエンドポイントを使うべきか
- 週次の評判ダッシュボード: 自社ブランドと各競合についてBrand Sentiment Analysisを実行し、件数を保存して推移をグラフにします。4ブランドで1回あたり40クレジット($0.20)です。
- 広報チームの対応キュー:
content_typeをnewsまたはmessage-boardsにしてBrand Mentionsを実行し、negativeの感情とdomain_rankで並べ替えます。 - 急増の調査: 感情の件数が動いたら、ネガティブのグループの
top_domainsでどのサイトが原因かを確認し、Brand Mentionsでそれらのページを取得します。
どちらのエンドポイントも、前述の5種類のサイトのウェブページが対象です。SNSの投稿やコメントには、統合ソーシャルメディアAPIのガイドで紹介している各プラットフォームのエンドポイントを使ってください。AIアシスタントが自社ブランドについて何と言っているかは、AI検索APIガイドをご覧ください。
よくある質問(FAQ)
ブランドモニタリングAPIとは何ですか?
ブランド、製品、トピックがどこで言及されているか、そしてそれらの言及がどのように受け止められているかを調べるAPIです。SocQのブランドモニタリングAPIは、感情・エモーション・オーソリティのスコア付きのページ単位の言及と、感情とエモーションの集計された内訳を返します。
フレーズを完全一致で検索するにはどうすればよいですか?
queryの中でダブルクォートで囲みます。JSONでは、たとえば"\"notion ai\""のように書きます。クエリは最大100文字です。
どのような種類のサイトが対象ですか?
ページはnews、blogs、message-boards、ecommerce、organizationに分類されます。Brand Mentionsでは、content_typeでこれらのうち1種類に限定できます。
何も見つからなかった場合も課金されますか?
Brand Mentionsは、ページが1件も見つからなかった場合でも10クレジットの基本料金がかかり、返されたページ1件ごとに0.02クレジットが加算されます。Brand Sentiment Analysisは1リクエストあたり10クレジットです。
感情分析のタスクがまだ実行中なのはなぜですか?
言及が何百万件もある非常に広い語句は、分析に最大で数分かかることがあります。再送信せず、同じtask_idのポーリングを続けてください。
BRAND MONITORING API
公開Brand MonitoringのURLでワークフローを試す
公開データの入力を送信すると、取得元をたどれるコンテキスト付きの正規化レコードを受け取れます。
Brand MonitoringのAPIを見る