LLM Mentions
LLMでの言及とは、GoogleのAI概要やChatGPTがある質問に答える中でドメインを引用したり、キーワードに触れたりしたもので、回答全文、引用されたページ、回答したモデル、その質問が毎月どれだけ聞かれているかに加え、ChatGPTでは回答に登場したブランドと追加で行った検索も記録されます。これらの回答を並べて読むと、どの質問でブランドがAIユーザーの目に触れているか、モデルがどの情報源に頼っているか、製品の説明が不正確な回答はどれかがわかり、LLMO(生成AI検索最適化)の監査、コンテンツ計画、競合比較に役立ちます。
LLM Mentions API の主な機能
- ドメインでもキーワードでも始められるtarget は notion.so のようなドメインを引用している回答を、query はキーワードやブランド名に触れている回答を探すため、自社サイトとカテゴリーの言い回しの両方を追えます。
- ユーザーが読んだままの回答answer は見出し、リスト、インラインリンクを含む回答全文をMarkdownで保持するので、モデルの表現をそのまま引用・確認できます。
- 回答が引用したすべてのページsources には引用ページごとに順位、タイトル、URL、ドメイン、サイト名、抜粋が入り、誰のコンテンツが回答を形作ったかがわかります。
- 質問ごとの需要ai_search_volume はその質問が月に何回聞かれているかの推定値で、需要の大きい質問での言及と、まれな質問での言及を区別できます。
- ChatGPTのブランド、参照ページ、追加検索platform を chat_gpt にすると、brands に回答中のブランドが登場順に、search_results に参照されたページが、fan_out_queries に追加で行われた検索が入ります。
- 回答が記録された時期first_seen_at と last_seen_at が回答ごとの記録日時を示し、以前からある回答と最近の回答を見分けられます。
LLM Mentions API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
target | 必須(いずれか1つ以上) | AIの回答で追跡するドメイン(例:hubspot.com)。ページのパスは付けません。target と query はどちらか一方を指定します。 |
query | 必須(いずれか1つ以上) | AIの回答で追跡するキーワードやブランド名(例:crm software)、250文字まで。target と query はどちらか一方を指定します。 |
platform | 任意 | google(既定)はGoogleのAI概要を、chat_gpt は米国・英語のChatGPTの回答を読み取ります。 |
location_code | 任意 | 市場のロケーションコード。既定は2840(米国)で、chat_gpt の回答もこの市場が対象です。 |
location_name | 任意 | location_code の代わりに使う市場名。指定すると location_code より優先されます。 |
language_code | 任意 | 回答の言語コード。既定は en で、chat_gpt の回答もこの言語です。 |
language | 任意 | language_code の代わりに使う言語名。指定すると language_code より優先されます。 |
results_limit | 任意 | 取得する回答の上限。1〜1000、既定は100です。 |
LLM Mentions API の使い方
ドメインかキーワードを送信し、AIの回答ごとに1行で読み取ります。
- {"target": "notion.so", "platform": "google", "results_limit": 100} を /v1/ai-search/llm-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/ai-search/llm-mentions" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"target":"notion.so","platform":"google","results_limit":100}'LLM Mentions API の主なユースケース
- AIの回答における自社ドメインの露出を監査: 自社ドメインを target にして ai_search_volume で並べ替え、answer と sources を読むと、需要の大きいどの質問で引用され、どう説明されているかがわかります。
- カテゴリーでAIが頼るページを特定: カテゴリーのキーワードを query にして sources のドメインとURLを集計し、寄稿や改善の対象にすべき記事のリストを作ります。
- ChatGPTの回答でブランドを比較: platform を chat_gpt にして自社と競合をそれぞれ調べ、同じ質問群での brands の顔ぶれと登場順を比べます。
- 取り上げられていない切り口からコンテンツを計画: 自社ブランドが出てこない回答の question と fan_out_queries を集め、モデルが引用できるページの企画にします。
LLM Mentions API 活用のヒント
- 同じブランドはドメインを target、ブランド名を query の両方で調べましょう。サイトの引用と名前の言及では返る回答の集合が異なります。
- 必要な回答は results_limit を大きめにして1回のリクエストでまとめて取得しましょう。40クレジットの基本料金はリクエストごとにかかります。
- 各行の id を保存しておき、次回は last_seen_at と照らし合わせると、新しい回答と確認済みの回答を区別できます。
関連API
LLM Mentions API 以外に別の種類の公開AI Searchデータが必要な場合は、これらのAPIをご利用ください。
- AI Search Visibility API — AIの回答がドメインやキーワードに言及した回数とAI検索ボリューム、よく引用されるドメイン、ChatGPTでは並んで登場するブランドを計測します。
- LLM Top Sources API — キーワードやドメインについて、AI概要とChatGPTの回答で最も引用される10件のドメインやページを、引用数とAI検索ボリュームで順位付けします。
- Google AI Mode API — 検索語に対するGoogle AIモードの回答全文をMarkdownで、すべての引用元とともに、国と言語を選んで取得します。