# LLM Mentions 集計メトリクス（ライブ）

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/ai_optimization/llm_mentions/aggregated_metrics/live`

**Tags:** DataForSEO

アシスタントがターゲットに言及する頻度を、個々の回答ではなく合計として示します：`total` と `items`。⚠️ `target` は**オブジェクトの配列**で、各要素は `{"domain": "..."}` または `{"keyword": "..."}` です。文字列をそのまま渡すと型が違うとして拒否され、文字列の配列を渡すと「Each target item must be an object」と返されます。フィルターフィールドは `get_dataforseo_ai_llm_mentions_available_filters` から取得します。DataForSEO のエンベロープに包まれます。データは `tasks[0].result`、結果は `tasks[0].status_code` に格納され、拒否されたリクエストでも HTTP 200 が返ります。これが可視性を示す中心的な数値です。`post_dataforseo_ai_llm_mentions_search_live` はその背景となる回答を示し、`post_dataforseo_ai_llm_mentions_cross_metrics_live` は複数のターゲットを一度に比較します。

### 料金の参考情報

- 計測方法: 報告されたレスポンスコスト。
- 参考リクエスト見積もり: 0.101 USD。
- 参照用の顧客乗数: 1.0。確定済みの顧客金額に再度適用しないでください。

参照用のメタデータのみであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **yes**

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "target": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "domain": {
              "type": "string",
              "description": "対象ドメイン keyword を指定しない場合は必須フィールド domain フィールドには最大 63 文字を指定できます。ドメインは https:// と www. を含めずに指定してください。"
            },
            "keyword": {
              "type": "string",
              "description": "対象キーワード domain を指定しない場合は必須フィールド keyword フィールドには最大 250 文字を指定できます すべての %## はデコードされます（また、‘+’ 文字は空白文字にデコードされます） keyword に “%” 文字を使用する必要がある場合は、“%25” として指定してください。keyword に “+” 文字を使用する必要がある場合は、“%2B” として指定してください。DataForSEO API の keyword フィールドと keywords フィールドのルールと制限については、こちらのヘルプセンター記事を参照してください"
            },
            "search_filter": {
              "type": "string",
              "description": "エンティティ検索フィルター: include または exclude。デフォルトは include です。"
            },
            "search_scope": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "検索範囲。ドメインエンティティ: any、sources、search_results。キーワードエンティティ: any、question、answer、brand_entities、fan_out_queries。デフォルト: any。"
            },
            "include_subdomains": {
              "type": "boolean",
              "description": "対象ドメインのサブドメインを検索に含めるかどうかを示します 任意フィールド true に設定すると、サブドメインが検索に含まれます デフォルト値: false"
            },
            "match_type": {
              "type": "string",
              "description": "対象キーワードの一致タイプ 任意フィールド word_match - 指定したシードキーワードに一致し、その前後または中間に追加の単語を含む用語を全文検索します（例: “light” を検索すると、“light bulb”、“light switch” を含む結果が返されます）。partial_match - 指定した文字シーケンスを含むすべての出現箇所を検索する部分文字列検索です（より長い単語の内部に現れる場合も含みます）（例: “light” を検索すると、“lighting”、“highlight” を含む結果が返されます）。使用可能な値: word_match, partial_match デフォルト値: word_match"
            }
          },
          "oneOf": [
            {
              "required": [
                "domain"
              ]
            },
            {
              "required": [
                "keyword"
              ]
            }
          ]
        },
        "description": "対象エンティティを含むオブジェクトの配列 必須フィールド target フィールドには最大 10 個のエンティティ（オブジェクト）を指定できます 1 つの対象エンティティには、1 つのドメインまたは 1 つのキーワードと関連パラメーターを含めることができます例: ドメインエンティティを含む target 配列 [{\"domain\": \"en.wikipedia.org\", \"search_filter\": \"exclude\"}] キーワードエンティティを含む target 配列 [{\"keyword\": \"bmw\", \"search_scope\": [\"question\"], \"match_type \": \"partial_match\"}] 複数のエンティティを含む target 配列 [{\"domain\": \"en.wikipedia.org\", \"search_filter\": \"exclude\"}, {\"keyword\": \"bmw\", \"match_type \": \"partial_match\", \"search_scope\": [\"answer\"]}]"
      },
      "location_name": {
        "type": "string",
        "description": "検索ロケーションの正式名称 任意フィールド このフィールドを使用する場合、location_code を指定する必要はありません このフィールドを指定しない場合、値 2840 の location_code がデフォルトで使用されます。別途 https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages にリクエストを送信すると、検索エンジンの利用可能なロケーションとその location_name の一覧を取得できます 注意: chat_gpt データは米国のみで利用できます"
      },
      "location_code": {
        "type": "integer",
        "description": "検索ロケーションコード 任意フィールド このフィールドを使用する場合、location_name を指定する必要はありません 別途 https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages にリクエストを送信すると、検索エンジンの利用可能なロケーションとその location_code の一覧を取得できます デフォルト値: 2840 注意: chat_gpt データは 2840 のみで利用できます"
      },
      "language_name": {
        "type": "string",
        "description": "検索言語の正式名称 任意フィールド このフィールドを使用する場合、language_code を指定する必要はありません。このフィールドを指定しない場合、値 en の language_code がデフォルトで使用されます。別途 https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages にリクエストを送信すると、検索エンジンがサポートする言語とその language_name の一覧を取得できます 注意: chat_gpt データは英語のみで利用できます"
      },
      "language_code": {
        "type": "string",
        "description": "検索言語コード 任意フィールド このフィールドを使用する場合、language_name を指定する必要はありません。別途 https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages にリクエストを送信すると、検索エンジンがサポートする言語とその language_code の一覧を取得できます デフォルト値: en 注意: chat_gpt データは en のみで利用できます"
      },
      "platform": {
        "type": "string",
        "description": "対象プラットフォーム 任意フィールド 使用可能な値: chat_gpt, google デフォルト値: google 注意: 返されるデータは選択したプラットフォームによって異なります 注意 2: chat_gpt データは米国と英語のみで利用できます"
      },
      "initial_dataset_filters": {
        "type": "array",
        "items": {},
        "description": "集計前に適用されるフィルター式の配列 任意フィールド この配列を使用して、集計前に生の言及データベースに適用される式をフィルタリングし、結果に寄与する行を制限できます。複数のフィルターを一度に追加できます（最大 8 個）条件の間には論理演算子 and、or を設定してください 次の演算子がサポートされています: =, , in, not_in, like, not_like, ilike, not_ilike, match, not_match like と not_like で % 演算子を使用すると、0 文字以上の任意の文字列に一致させられます 例: [\"ai_search_volume\",\">\",\"1000\"]使用可能なフィルターの完全な一覧はこちらです。初期データセットのフィルターの詳細については、こちらのヘルプセンター記事を参照してください。"
      },
      "internal_list_limit": {
        "type": "integer",
        "description": "内部配列内の最大要素数 任意フィールド このフィールドを使用して、次の配列内の要素数を制限できます: sources_domain search_results_domain 最小値: 1 最大値: 20 デフォルト値: 10"
      },
      "tag": {
        "type": "string",
        "description": "ユーザー定義のタスク識別子 任意フィールド 文字数上限は 255 です このパラメーターを使ってタスクを識別し、結果と照合できます 指定した tag の値は、レスポンスの data オブジェクトに含まれます"
      }
    },
    "required": [
      "target"
    ]
  }
}
```

Example:

```json
[
  {
    "target": [
      {
        "domain": "en.wikipedia.org"
      }
    ]
  }
]
```

## Responses

### 200 — 成功レスポンス

Headers:
- `X-Request-Id` (string) — Felo サポートに問い合わせる際に伝えるリクエスト識別子。

**application/json**

Schema: object

```json
{
  "type": "object",
  "properties": {
    "version": {
      "type": "string",
      "description": "API の現在のバージョン"
    },
    "status_code": {
      "type": "integer",
      "description": "一般的なステータスコード レスポンスコードの完全な一覧はこちらです 注意: 関連する例外やエラー条件を処理するための必要なシステムを設計することを強く推奨します"
    },
    "status_message": {
      "type": "string",
      "description": "一般的な情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです"
    },
    "time": {
      "type": "string",
      "description": "実行時間（秒）"
    },
    "cost": {
      "type": "number",
      "description": "タスクの総コスト（USD）"
    },
    "tasks_count": {
      "type": "integer",
      "description": "tasks 配列内のタスク数"
    },
    "tasks_error": {
      "type": "integer",
      "description": "エラーで返された tasks 配列内のタスク数"
    },
    "tasks": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "タスクの配列"
    },
    "tasks.id": {
      "type": "string",
      "description": "タスク識別子 当社システム内で UUID 形式の一意のタスク識別子"
    },
    "tasks.status_code": {
      "type": "integer",
      "description": "DataForSEO によって生成されたタスクのステータスコード。次の範囲内になります: 10000-60000 レスポンスコードの完全な一覧はこちらです"
    },
    "tasks.status_message": {
      "type": "string",
      "description": "タスクの情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです"
    },
    "tasks.time": {
      "type": "string",
      "description": "実行時間（秒）"
    },
    "tasks.cost": {
      "type": "number",
      "description": "タスクのコスト（USD）"
    },
    "tasks.result_count": {
      "type": "integer",
      "description": "result 配列内の要素数"
    },
    "tasks.path": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "URL パス"
    },
    "tasks.data": {
      "type": "object",
      "description": "POST リクエストで指定したものと同じパラメーターを含みます"
    },
    "tasks.result": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "結果の配列"
    },
    "tasks.result.total": {
      "type": "object",
      "description": "集計された言及メトリクスの概要 見つかったすべてのドメインにわたる全体的な集計 LLM 言及メトリクスを、さまざまなディメンションでグループ化して含みます"
    },
    "tasks.result.total.location": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "ロケーションベースのグループ化 地理的なロケーションごとに分割された言及メトリクスを含むオブジェクトの配列"
    },
    "tasks.result.total.location.type": {
      "type": "string",
      "description": "要素のタイプ = 'group_element'"
    },
    "tasks.result.total.location.key": {
      "type": "string",
      "description": "グループ化識別子 グループ化ディメンションの特定の識別子"
    },
    "tasks.result.total.location.mentions": {
      "type": "integer",
      "description": "LLM 言及の合計数 対象のキーワードまたはドメインがこの特定のグループ化キーに関連して言及された回数"
    },
    "tasks.result.total.location.ai_search_volume": {
      "type": "integer",
      "description": "キーワードの現在の AI 検索量 この指標の詳細についてはこちらを参照してください"
    },
    "tasks.result.total.location.impressions": {
      "type": "integer",
      "description": "キーワードの現在の AI インプレッション数"
    },
    "tasks.result.total.language": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "言語別のグループ化 コンテンツ言語ごとに分割された言及メトリクスを含むオブジェクトの配列"
    },
    "tasks.result.total.language.type": {
      "type": "string",
      "description": "要素のタイプ = 'group_element'"
    },
    "tasks.result.total.language.key": {
      "type": "string",
      "description": "グループ化識別子 グループ化ディメンションの特定の識別子"
    },
    "tasks.result.total.language.mentions": {
      "type": "integer",
      "description": "LLM 言及の合計数 対象のキーワードまたはドメインがこの特定のグループ化キーに関連して言及された回数"
    },
    "tasks.result.total.language.ai_search_volume": {
      "type": "integer",
      "description": "キーワードの現在の AI 検索量 この指標の詳細についてはこちらを参照してください"
    },
    "tasks.result.total.language.impressions": {
      "type": "integer",
      "description": "キーワードの現在の AI インプレッション数"
    },
    "tasks.result.total.platform": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "プラットフォームベースのグループ化 AI プラットフォームごとに分割された言及メトリクスを含むグループ要素の配列"
    },
    "tasks.result.total.platform.type": {
      "type": "string",
      "description": "要素のタイプ = 'group_element'"
    },
    "tasks.result.total.platform.key": {
      "type": "string",
      "description": "グループ化識別子 グループ化ディメンションの特定の識別子"
    },
    "tasks.result.total.platform.mentions": {
      "type": "integer",
      "description": "LLM 言及の合計数 対象のキーワードまたはドメインがこの特定のグループ化キーに関連して言及された回数"
    },
    "tasks.result.total.platform.ai_search_volume": {
      "type": "integer",
      "description": "キーワードの現在の AI 検索量 この指標の詳細についてはこちらを参照してください"
    },
    "tasks.result.total.platform.impressions": {
      "type": "integer",
      "description": "キーワードの現在の AI インプレッション数"
    },
    "tasks.result.total.sources_domain": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "対象に関連するトップソースドメイン LLM レスポンスでソースとして引用されるトップドメインのデータを含むオブジェクトの配列"
    },
    "tasks.result.total.sources_domain.type": {
      "type": "string",
      "description": "要素のタイプ = 'group_element'"
    },
    "tasks.result.total.sources_domain.key": {
      "type": "string",
      "description": "グループ化識別子 グループ化ディメンションの特定の識別子 この場合、フィールドには見つかったドメイン名が表示されます"
    },
    "tasks.result.total.sources_domain.mentions": {
      "type": "integer",
      "description": "LLM 言及の合計数 対象のキーワードまたはドメインが特定のドメインに関連して言及された回数"
    },
    "tasks.result.total.sources_domain.ai_search_volume": {
      "type": "integer",
      "description": "キーワードの現在の AI 検索量 この指標の詳細についてはこちらを参照してください"
    },
    "tasks.result.total.sources_domain.impressions": {
      "type": "integer",
      "description": "キーワードの現在の AI インプレッション数"
    },
    "tasks.result.total.search_results_domain": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "対象に関連する検索結果のトップドメイン LLM クエリに関連する検索結果に表示されるトップドメインのデータを含むオブジェクトの配列"
    },
    "tasks.result.total.search_results_domain.type": {
      "type": "string",
      "description": "要素のタイプ = 'group_element'"
    },
    "tasks.result.total.search_results_domain.key": {
      "type": "string",
      "description": "グループ化識別子 グループ化ディメンションの特定の識別子 この場合、フィールドには見つかったドメイン名が表示されます"
    },
    "tasks.result.total.search_results_domain.mentions": {
      "type": "integer",
      "description": "LLM 言及の合計数 対象のキーワードまたはドメインが特定のドメインに関連して言及された回数"
    },
    "tasks.result.total.search_results_domain.ai_search_volume": {
      "type": "integer",
      "description": "キーワードの現在の AI 検索量 この指標の詳細についてはこちらを参照してください"
    },
    "tasks.result.total.search_results_domain.impressions": {
      "type": "integer",
      "description": "キーワードの現在の AI インプレッション数"
    },
    "tasks.result.total.brand_entities_title": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "対象に関連するブランドエンティティのデータ LLM クエリに関連する検索結果に表示されるブランドエンティティのタイトルのデータを含むオブジェクトの配列"
    },
    "tasks.result.total.brand_entities_title.type": {
      "type": "string",
      "description": "要素のタイプ = 'group_element'"
    },
    "tasks.result.total.brand_entities_title.key": {
      "type": "string",
      "description": "グループ化識別子 グループ化ディメンションの特定の識別子 この場合、フィールドには見つかったブランドエンティティのタイトルが表示されます"
    },
    "tasks.result.total.brand_entities_title.mentions": {
      "type": "integer",
      "description": "LLM 言及の合計数 対象のキーワードまたはドメインが特定のドメインに関連して言及された回数"
    },
    "tasks.result.total.brand_entities_title.ai_search_volume": {
      "type": "integer",
      "description": "キーワードの現在の AI 検索量 この指標の詳細についてはこちらを参照してください"
    },
    "tasks.result.total.brand_entities_title.impressions": {
      "type": "integer",
      "description": "キーワードの現在の AI インプレッション数"
    },
    "tasks.result.total.brand_entities_category": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "対象に関連するブランドエンティティのデータ LLM クエリに関連する検索結果に表示されるブランドエンティティカテゴリのデータを含むオブジェクトの配列"
    },
    "tasks.result.total.brand_entities_category.type": {
      "type": "string",
      "description": "要素のタイプ = 'group_element'"
    },
    "tasks.result.total.brand_entities_category.key": {
      "type": "string",
      "description": "グループ化識別子 グループ化ディメンションの特定の識別子 この場合、フィールドには見つかったブランドエンティティのカテゴリが表示されます"
    },
    "tasks.result.total.brand_entities_category.mentions": {
      "type": "integer",
      "description": "LLM 言及の合計数 対象のキーワードまたはドメインが特定のドメインに関連して言及された回数"
    },
    "tasks.result.total.brand_entities_category.ai_search_volume": {
      "type": "integer",
      "description": "キーワードの現在の AI 検索量 この指標の詳細についてはこちらを参照してください"
    },
    "tasks.result.total.brand_entities_category.impressions": {
      "type": "integer",
      "description": "キーワードの現在の AI インプレッション数"
    },
    "tasks.result.items": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "個々のページ結果配列。見つかった各トップページの詳細な言及メトリクスを含みます この場合、null と等しくなります"
    }
  }
}
```

### 400 — リクエストを処理できませんでした。リクエストパラメータを確認してください。

### 401 — 有効な Felo API キーが必要です。

### 402 — 請求要件が満たされていないため、リクエストを続行できません。

### 403 — このアカウントにはこの操作を行う権限がありません。

### 429 — リクエストまたは支出の上限に達しました。

### 502 — サービスがリクエストを完了できませんでした。

### 503 — API または請求サービスが一時的に利用できません。

### 504 — リクエストの処理中にサービスがタイムアウトしました。

### default — エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります

**application/json**

Schema:

```json
{}
```