提供されるデータの種類およびAPIバージョン情報

データ区分：APIのレベル別の深さに応じて、Essential API、Intelligence APIの主要カテゴリーに分かれます。

提供データおよび機能：各APIカテゴリーが提供するデータの主な特徴と目的は以下の通りです。

• Essential API：意図および消費者行動に基づいた加工済みの高品質データを提供します。
• Intelligence API：独占的な分析と深層インサイトの抽出のための高付加価値データを提供します。

主要API：カテゴリー別のAPIエンドポイントは以下の通りです。

• Essential API：キーワード詳細情報（/keyword_info）、関連・拡張キーワードの探索（/intent_finder/keyword_list、/cluster_finder/keyword_list）などの加工済みデータを提供します。
• Intelligence API：顧客の実際の検索経路分析（/path_finder）および関係分析/意図クラスタリング（/cluster_finder）などの深層インサイト分析のためのデータを提供します。

APIバージョン情報：listeningmind-data-api（v0.0.20）

ListeningMind DaaS API構成

区分	提供データおよび機能	主要API
Essential API	意図/消費者行動基盤の高品質データ提供	Single Processed Data（単一結果データ、1:1構造） /keyword_info（検索量（average/total）、増減率（trend）、広告情報（CPC、competition）、検索意図（intents）、検索結果特性（features）、ユーザー特性（demography）、Google/Naver月別検索量詳細（monthly_volume）） Multiple Processed Data（複数結果データ、1:N構造） /intent_finder/keyword_list（関連キーワードの探索） /cluster_finder/keyword_list（拡張キーワードの探索） /path_finder/keyword_list（前後キーワードの探索）
Intelligence API	独占的分析およびインサイト抽出のための高付加価値データ提供	Deep Insight Data（深層消費者インサイト機能） /path_finder（顧客の実際の行動/意図の把握） /cluster_finder（関係分析/クラスタリング）

• Single Processed Data（単一結果加工データ）：自社収集した原本データを分析/加工し、キーワードの詳細指標（Intents、demographyなど）を構造化されたデータ（JSON）として提供します。
• Multiple Processed Data（複数結果加工データ）：検索APIのように、ひとつの入力値に対して複数の結果値（List）を返す2次加工データです。
• Deep Insight Data（深層消費者インサイト – 核心機能）：ListeningMind独占アルゴリズムを適用し、インサイト抽出のために精製/分析した高付加価値データを構造化されたデータ（JSON）形式で提供します。

Essential API

ターゲット：SEO専門家、コンテンツマーケター、ブランドストラテジスト

目的：市場と消費者に関する意図（Intent）と文脈（Context）を解釈する核心データを提供します。数千件の関連キーワードから消費者の関心トピックを分類し、検索結果の上位露出コンテンツの特徴を分析し、消費者の意図に最適化されたコンテンツを生成できる情報を提供します。

提供データ：提供されるデータは、マーケティングおよびビジネス戦略の策定に核心的な以下のデータポイントを含みます。

キーワードリストの照会

関連キーワードの抽出：インテントファインダー基準のキーワードリスト抽出
intent_finder/keyword_listは、特定のキーワードと関連性の高い他のキーワードを探す機能です。すなわち、人々が検索する際に一緒に検討したり、頻繁に組み合わせるキーワードを発掘するために使用されます。
例：チャーハン、チャーシュー麺、チャーシュー麺のおすすめ店、チャーシュー麺のレシピなど

拡張キーワードの抽出：クラスターファインダー基準のキーワードリスト抽出
cluster_finder/keyword_listは、特定のキーワードと消費者の検索行動の間の関係ネットワークを分析し、より広いトピッククラスターに拡張されたキーワードを発掘するために使用されます。
例：チャーハン、チャーシュー麺、チャーシュー麺のおすすめ店、ちゃんぽん、酢豚、中華料理店など

前後キーワードの抽出：パスファインダー基準のキーワードリスト抽出
path_finder/keyword_listは、特定のキーワードの前後の経路内にあるすべてのキーワードを抽出するために使用されます。
例：チャーハン、ちゃんぽん、チャーシュー麺、ちゃんぽんの作り方、ちゃんぽんのおすすめ店、酢豚、酢豚の作り方、酢豚のソースの作り方

検索量（Volume）

• 月平均検索量（volume_avg）
• 直近12ヶ月の総検索量（volume_total）
• 直近3ヶ月間の増減率（volume_trend：上昇/下落の有無）

広告関連データ

• 競合度（competition）：該当キーワードの広告競合レベル（LOW、MEDIUM、HIGH）
• 競合指数（competition_index）：数値化された競争強度
• クリックあたりのコスト（CPC、Cost Per Click）
• 入札価格の範囲（low_bid_micros〜high_bid_micros）

検索語の特徴

• 検索結果特性（Features）：表示されたOrganic SERP Featuresのリスト
• 検索意図（Intents）：情報型（Informational）、移動型（Navigational）、商業型（Commercial）、取引型（Transactional）
• ユーザー特性（Demography）：年齢、性別分布などの検索比率（%）

プラットフォーム別月別検索量の詳細（最大48ヶ月提供）

• Google検索量（gg_volume_avg、gg_volume_total、gg_volume_trend）
• Naver検索量（nv_volume_avg、nv_volume_total、nv_volume_trend）

Keyword_info API（/keyword_info）

個別キーワードに対する検索量、広告競合度、クリック単価（CPC）、トレンド変化（増減率）、検索意図（Intent）、検索結果の表示特徴（SERP Features）、ユーザー特性（Demography）などの詳細情報を総合的に照会するAPIです。

項目	主な内容
APIの目的	個別キーワードに対する検索量、広告競合度、クリック単価（CPC）、トレンド変化（増減率）、検索意図（Intent）、ユーザー特性（Demography）までを一度に提供する「複合データAPI」
詳細データ	Ads情報（検索量の平均および合計、増減率、CPC、広告競合度）、Organic SERPフィーチャー別の表示件数、Intent（情報型、移動型、商業型、取引型）、Demography（ユーザー特性と比率）、月別検索量（最大48ヶ月、Google/Naver/合計）
主な入力値	照会キーワード：複数入力可能（最大1,000個まで） 基準国（gl）："kr" "jp" "us" に限定

関連キーワードの探索：Intent_finder/keyword_list API（/intent_finder/keyword_list）

拡張キーワードの探索：Cluster_finder/keyword_list API（/cluster_finder/keyword_list）

前後キーワードの探索：Path_finder/keyword_list API（/path_finder/keyword_list）

シードキーワードを含む、特定の検索意図、経路および関係ネットワークを共有する関連キーワードグループを検索するAPIです。ListeningMind SaaS「インテントファインダー/クラスターファインダー/パスファインダー検索」と同じ機能です。（ただし、キーワード別の詳細情報は/keyword_info APIを別途呼び出す必要があります）

項目	主な内容
APIの目的	単純な関連語ではなく、シードキーワードを含み、特定の検索意図、経路および関係ネットワークを共有する関連キーワードを検索（インテントファインダー、クラスターファインダー、パスファインダー検索）
詳細データ	一般的なキーワード提案機能とは異なり、高付加価値機能である「特定の検索意図を共有するキーワードグループ」を検索します。結果は月平均検索量を基準に並び替えられます。【キーワードの配列】
主な入力値	照会キーワード：複数入力可能（個数制限なし） 基準国（gl）："kr" "jp" "us" に限定 検索量の閾値（volume_threshold）：最小検索量基準の出力制限設定が可能（デフォルト値: 100） 最大結果件数（limit）：最大10,000件まで出力（デフォルト値: 100） ソート基準："volume_avg"（月平均検索量）"volume_total"（年間検索量/直近12ヶ月の合計）"volume_trend"（増減率/直近3ヶ月基準）"cpc"（クリックあたり単価）"competition_index"（広告競合度）（デフォルト値: "volume_avg"） ソート順："desc"（降順）"asc"（昇順）（デフォルト値: "desc"）

Intelligence API

ターゲット：市場機会の発掘および戦略策定のために深層インサイトが必要な戦略アナリスト、AIベースのビジネス予測モデルに独占的な高付加価値データを活用したい開発者およびデータサイエンティスト

目的：ユーザーのリクエストに応じて膨大なデータをリアルタイムで演算し、関係を分析し、グループ化する独占的な価値を提供します。これにより市場トレンド、潜在ニーズに対する深層的な洞察力を提供し、潜在的な機会と脅威要因に対するビジネス予測、危機の検知、転換可能性などの分析に必要な多角的なデータインサイトを提供します。

提供データ：

検索経路（path）データ：特定キーワード入力の前後にユーザーが検索したキーワードの順序化された配列（Sequence）

• 以前の経路フロー：冷蔵 → 冷蔵庫 → LG冷蔵庫 → ユーザーが一般カテゴリー → ブランド製品へと検索を細分化
• ブランド連携フロー：「lg 冷蔵庫」→「サービスセンター」→「サービスセンター/ホームページ」など → AS・故障関連の情報検索フローが強い

コミュニティ（communities）分析：キーワード関係ベースのクラスターコミュニティ照会機能で、検索意図やテーマを共有するキーワードの集合

ノード間の接続（rels）分析：2つのキーワードで構成された配列のリストで、キーワードとキーワードの間の直接的な接続関係を示します。

Path_Finder API（/path_finder）

項目	主な内容
APIの目的	検索経路（関連キーワードシーケンス）の照会。ユーザーが特定の検索テーマについて探索する「ジャーニー」をシーケンス（経路）の形式で表示します。
詳細データ	各配列は個々のユーザーが特定の時点または期間にわたって検索した経路を表し、ユーザーの検索意図がどのように変化・深化するかを把握するために使用します。【キーワードの順序化された配列（Sequence）】
主な入力値	照会キーワード：単数入力 基準国（gl）："kr" "jp" "us" に限定 時点（time_point）：curr（現在）、3m（3ヶ月前）、6m（6ヶ月前）、9m（9ヶ月前）、12m（12ヶ月前）（デフォルト値: curr） 最大結果件数（limit）：最大1,000件まで出力（デフォルト値: 300）

Cluster_Finder API（/cluster_finder）

項目	主な内容
APIの目的	キーワード関係ベースのクラスターコミュニティの照会。特定のテーマに対して持つ集団的な関心事を把握できます。
詳細データ	検索意図やテーマを共有するキーワードの集合 クラスターグループ（communities）：キーワードの配列を値として持つJSONオブジェクト。各キーワードグループは数字のキー（例："1"、"2"）で区分 キーワードとキーワードの間の直接的な接続関係 ノード間の接続（rels）：2つのキーワードで構成された配列（["キーワードA"、"キーワードB"]）のリスト
主な入力値	照会キーワード：単数入力 基準国（gl）："kr" "jp" "us" に限定 時点（time_point）：curr（現在）、3m（3ヶ月前）、6m（6ヶ月前）、9m（9ヶ月前）、12m（12ヶ月前）（デフォルト値: curr） 拡張段階の範囲（hop）：1、2、3（デフォルト値: 2） 拡張方向（orientation）："UNDIRECTED" "NATURAL" "REVERSE"（デフォルト値: "UNDIRECTED"） 最大結果件数（limit）：最大10,000件まで出力（デフォルト値: 500） レスポンスオプション（response option）："communities"（コミュニティ）"rels"（関係）"all"（デフォルト値: "communities"）