# LLM Mentions（ライブ） **API:** Data API **Endpoint:** `POST /v1/beta/dataforseo/ai_optimization/llm_mentions/search/live` **Tags:** DataForSEO アシスタントがターゲットに言及した個々の回答です。`total_count`、`current_offset`、`search_after_token`、`items` を返します。最初の数ページを超えたら `offset` ではなくトークンでページングしてください。⚠️ `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_aggregated_metrics_live` を使用してください。 ### 料金の参考情報 - 計測方法: 報告されたレスポンスコスト。 - 参考リクエスト見積もり: 0.701 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" } }, "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 データは米国と英語のみで利用できます" }, "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\"]使用可能なフィルターの完全なリストはこちらで確認できます。" }, "order_by": { "type": "array", "items": { "type": "string" }, "description": "結果の並べ替えルール 任意フィールド filters 配列と同じ値を使用して結果を並べ替えられます 指定可能な並べ替えの種類：asc - 結果は昇順で並べ替えられます desc - 結果は降順で並べ替えられます 並べ替えの種類を設定するにはカンマを使用してください 例：[\"ai_search_volume,desc\"] 1 回のリクエストで設定できる並べ替えルールは 3 つまでです 複数の並べ替えルールはカンマで区切ってください" }, "offset": { "type": "integer", "description": "返される言及データの結果配列内のオフセット 任意フィールド デフォルト値：0 例：値 10 を指定すると、結果配列内の最初の 10 個の言及オブジェクトが省略され、後続のオブジェクトのデータが提供されます。注意：最大値は 9,000 です。さらに多くの結果をオフセットする場合は search_after_token を使用してください" }, "search_after_token": { "type": "string", "description": "後続リクエスト用のトークン 任意フィールド 各リクエストのレスポンスの同一フィールドで提供されます。このパラメーターを使用すると、1 回のリクエストで 20,000 件を超える結果を取得しようとしたときのタイムアウトを回避できます。レスポンス配列の一意の search_after_token 値を指定すると、最初のタスクの後続結果を取得できます。search_after_token の値は後続タスクごとに一意です。注意：リクエストで search_after_token を指定する場合、他のすべてのパラメーターは前回のリクエストと同一である必要があります" }, "limit": { "type": "integer", "description": "返されるオブジェクトの最大数 任意フィールド デフォルト値：100 最大値：1000" }, "tag": { "type": "string", "description": "ユーザー定義のタスク識別子 任意フィールド 文字数上限は 255 です このパラメーターを使ってタスクを識別し、結果と照合できます 指定した tag の値は、レスポンスの data オブジェクトに含まれます" } }, "required": [ "target" ] } } ``` ## 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_count": { "type": "integer", "description": "リクエストに関連する結果の総数" }, "tasks.result.current_offset": { "type": "integer", "description": "items 配列で省略される言及オブジェクトの数" }, "tasks.result.search_after_token": { "type": "string", "description": "後続リクエスト用のトークン 新しいタスクを設定するときに一意の search_after_token を指定すると、最初のタスクの後続結果を取得できます。search_after_token の値は後続タスクごとに一意です" }, "tasks.result.items_count": { "type": "integer", "description": "items 配列で返される結果の数" }, "tasks.result.items": { "type": "array", "items": { "type": "string" }, "description": "関連する言及データを含みます" }, "tasks.result.items.platform": { "type": "string", "description": "POST 配列で受け取るプラットフォーム" }, "tasks.result.items.model_name": { "type": "string", "description": "データの取得元である AI モデルの名前 注意：google プラットフォームタイプの場合、値は常に google_ai_overview です" }, "tasks.result.items.location_code": { "type": "integer", "description": "POST 配列の所在地コード" }, "tasks.result.items.language_code": { "type": "string", "description": "POST 配列の言語コード" }, "tasks.result.items.question": { "type": "string", "description": "関連する質問" }, "tasks.result.items.answer": { "type": "string", "description": "markdown 形式の関連する回答 markdown マークアップ言語でフォーマットされた結果の内容" }, "tasks.result.items.sources": { "type": "array", "items": { "type": "string" }, "description": "ソースの配列 モデルが最終回答で引用または依拠したソース" }, "tasks.result.items.sources.snippet": { "type": "string", "description": "ソースの説明" }, "tasks.result.items.sources.source_name": { "type": "string", "description": "ソース名" }, "tasks.result.items.sources.thumbnail": { "type": "string", "description": "ソースのサムネイル" }, "tasks.result.items.sources.markdown": { "type": "string", "description": "要素の markdown 形式の内容 markdown マークアップ言語でフォーマットされた結果の内容" }, "tasks.result.items.sources.position": { "type": "integer", "description": "結果内の位置" }, "tasks.result.items.sources.title": { "type": "string", "description": "ソースのタイトル" }, "tasks.result.items.sources.domain": { "type": "string", "description": "ソースドメイン" }, "tasks.result.items.sources.url": { "type": "string", "description": "ソースの URL" }, "tasks.result.items.sources.publication_date": { "type": "string", "description": "結果が公開された日時（形式）：“year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes” 例：2019-11-15 12:57:46 +00:00" }, "tasks.result.items.search_results": { "type": "array", "items": { "type": "string" }, "description": "検索結果の配列 モデルが情報を調べるときに取得したすべてのウェブ検索出力（重複や未使用のエントリを含む）" }, "tasks.result.items.search_results.description": { "type": "string", "description": "結果の説明" }, "tasks.result.items.search_results.breadcrumb": { "type": "string", "description": "パンくずリスト" }, "tasks.result.items.search_results.position": { "type": "integer", "description": "結果内の位置" }, "tasks.result.items.search_results.title": { "type": "string", "description": "結果のタイトル" }, "tasks.result.items.search_results.domain": { "type": "string", "description": "結果のドメイン" }, "tasks.result.items.search_results.url": { "type": "string", "description": "結果の URL" }, "tasks.result.items.search_results.publication_date": { "type": "string", "description": "結果が公開された日時（形式）：“year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes” 例：2019-11-15 12:57:46 +00:00" }, "tasks.result.items.ai_search_volume": { "type": "integer", "description": "キーワードの現在の AI 検索量 この指標の詳細についてはこちらを参照してください" }, "tasks.result.items.monthly_searches": { "type": "array", "items": { "type": "string" }, "description": "月別 AI 検索ボリュームレート ある年の特定の月における AI 検索ボリュームレートを含むオブジェクトの配列" }, "tasks.result.items.monthly_searches.year": { "type": "integer", "description": "年" }, "tasks.result.items.monthly_searches.month": { "type": "integer", "description": "月" }, "tasks.result.items.monthly_searches.search_volume": { "type": "integer", "description": "ある年の特定の月における AI 検索ボリュームレート この指標の詳細はこちら" }, "tasks.result.items.first_response_at": { "type": "string", "description": "レスポンスデータが最初に記録された日時（UTC 形式）：“yyyy-mm-dd hh-mm-ss +00:00” 例：2025-10-21 06:25:30 +00:00" }, "tasks.result.items.last_response_at": { "type": "string", "description": "レスポンスデータが最後に更新された日時（UTC 形式）：“yyyy-mm-dd hh-mm-ss +00:00” 例：2025-10-21 06:25:30 +00:00" }, "tasks.result.items.brand_entities": { "type": "array", "items": { "type": "string" }, "description": "ブランドエンティティの配列 レスポンスで言及されたブランドに関する情報を含みます" }, "tasks.result.items.brand_entities.position": { "type": "integer", "description": "結果内の位置" }, "tasks.result.items.brand_entities.title": { "type": "string", "description": "ブランド名" }, "tasks.result.items.brand_entities.category": { "type": "string", "description": "ブランドのカテゴリ" }, "tasks.result.items.fan_out_queries": { "type": "array", "items": { "type": "string" }, "description": "ファンアウトクエリの配列 より包括的な回答を提供するために、メインクエリから派生した関連検索クエリを含みます" } } } ``` ### 400 — リクエストを処理できませんでした。リクエストパラメータを確認してください。 ### 401 — 有効な Felo API キーが必要です。 ### 402 — 請求要件が満たされていないため、リクエストを続行できません。 ### 403 — このアカウントにはこの操作を行う権限がありません。 ### 429 — リクエストまたは支出の上限に達しました。 ### 502 — サービスがリクエストを完了できませんでした。 ### 503 — API または請求サービスが一時的に利用できません。 ### 504 — リクエストの処理中にサービスがタイムアウトしました。 ### default — エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります **application/json** Schema: ```json {} ```