ai-search/
llm-mentions

ドメインを引用している、またはキーワードに触れているAI概要とChatGPTの回答を探し、質問、Markdown形式の回答全文、引用元、質問の月間AI検索ボリュームを返します。

LLM Mentions API

AI概要とChatGPT
回答全文
引用元
AI検索ボリューム
1リクエストあたり40クレジット + 結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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行で読み取ります。

  1. {"target": "notion.so", "platform": "google", "results_limit": 100} を /v1/ai-search/llm-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/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 と照らし合わせると、新しい回答と確認済みの回答を区別できます。

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で、すべての引用元とともに、国と言語を選んで取得します。

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

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

LLM Mentions API — よくある質問

LLM Mentions APIは、ドメインまたはキーワードを1つ受け取り、それを引用している、または言及しているGoogleのAI概要とChatGPTの回答を返すAPIです。各行に質問、回答全文、引用元、モデル、質問の月間AI検索ボリュームが含まれます。

platform が google の場合は選んだ市場のGoogle AI概要を、chat_gpt の場合は米国・英語のChatGPTの回答を読み取ります。

サイトを引用している回答を探すなら target にドメインを、語句やブランド名に触れている回答を探すなら query を使います。1回のリクエストではどちらか一方です。

ブランド名、参照されたページ、追加検索はChatGPTの回答で記録されるため、受け取るには platform を chat_gpt にしてください。

1リクエストにつき40クレジットに、返された回答1件ごとに0.5クレジットが加算されます。該当する回答がない場合も40クレジットがかかります。