v0.2.0-beta

OpenAPI 3.1.0

LLM Mentions（ライブ）

Felo API Support

MIT

サーバー

https://openapi.felo.ai

クライアントライブラリ

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO 操作

post/v1/beta/dataforseo/ai_optimization/llm_mentions/search/live

LLM Mentions（ライブ）

アシスタントがターゲットに言及した個々の回答です。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 の請求記録に従います。

リクエストボディ

必須

application/json

型: array object[]
- target
  型: array object[]
  必須
  
  対象エンティティを含むオブジェクトの配列必須フィールド 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"]}]
  
  domain
  型: string
  必須
  
  対象ドメイン keyword を指定しない場合は必須フィールド domain フィールドには最大 63 文字を指定できます。ドメインは https:// と www. を含めずに指定してください。
  
  include_subdomains
  型: boolean
  
  対象ドメインのサブドメインを検索に含めるかどうかを示します任意フィールド true に設定すると、サブドメインが検索に含まれますデフォルト値: false
  
  keyword
  型: string
  
  対象キーワード domain を指定しない場合は必須フィールド keyword フィールドには最大 250 文字を指定できますすべての %## はデコードされます（また、‘+’ 文字は空白文字にデコードされます） keyword に “%” 文字を使用する必要がある場合は、“%25” として指定してください。keyword に “+” 文字を使用する必要がある場合は、“%2B” として指定してください。DataForSEO API の keyword フィールドと keywords フィールドのルールと制限については、こちらのヘルプセンター記事を参照してください
  
  match_type
  型: string
  
  対象キーワードのマッチタイプ指定したキーワードのマッチ方法を定義します任意フィールド指定可能な値：word_match - 指定したシードキーワードに一致し、キーフレーズの前後または中央に追加の語を含む用語を全文検索します（例：「light」で検索すると「light bulb」「light switch」を含む結果が返ります）。partial_match - 指定した文字シーケンスを含むすべての出現箇所を、より長い単語の内部に含まれる場合でも検索する部分文字列検索です（例：「light」で検索すると「lighting」「highlight」を含む結果が返ります）。デフォルト値：word_match
  
  search_filter
  型: string
  
  エンティティ検索フィルター: include または exclude。デフォルトは include です。
  
  search_scope
  型: array string[]
  
  検索範囲。ドメインエンティティ: any、sources、search_results。キーワードエンティティ: any、question、answer、brand_entities、fan_out_queries。デフォルト: any。
- filters
  型: array
  
  結果フィルターパラメーターの配列任意フィールド複数のフィルターを同時に追加できます（最大 8 個）条件の間には論理演算子 and、or を設定してください次の演算子がサポートされています：=, , in, not_in, like, not_like, ilike, not_ilike, match, not_match like と not_like で % 演算子を使用すると、0 文字以上の任意の文字列に一致させられます例：["ai_search_volume",">","1000"]使用可能なフィルターの完全なリストはこちらで確認できます。
- language_code
  型: string
  
  検索言語コード任意フィールドこのフィールドを使用する場合、language_name を指定する必要はありません。別途 https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages にリクエストを送信すると、検索エンジンがサポートする言語とその language_code の一覧を取得できますデフォルト値: en 注意: chat_gpt データは en のみで利用できます
- language_name
  型: string
  
  検索言語の正式名称任意フィールドこのフィールドを使用する場合、language_code を指定する必要はありません。このフィールドを指定しない場合、値 en の language_code がデフォルトで使用されます。別途 https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages にリクエストを送信すると、検索エンジンがサポートする言語とその language_name の一覧を取得できます注意: chat_gpt データは英語のみで利用できます
- limit
  型: integer
  
  返されるオブジェクトの最大数任意フィールドデフォルト値：100 最大値：1000
- location_code
  型: integer
  
  検索ロケーションコード任意フィールドこのフィールドを使用する場合、location_name を指定する必要はありません別途 https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages にリクエストを送信すると、検索エンジンの利用可能なロケーションとその location_code の一覧を取得できますデフォルト値: 2840 注意: chat_gpt データは 2840 のみで利用できます
- location_name
  型: string
  
  検索ロケーションの正式名称任意フィールドこのフィールドを使用する場合、location_code を指定する必要はありませんこのフィールドを指定しない場合、値 2840 の location_code がデフォルトで使用されます。別途 https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages にリクエストを送信すると、検索エンジンの利用可能なロケーションとその location_name の一覧を取得できます注意: chat_gpt データは米国のみで利用できます
- offset
  型: integer
  
  返される言及データの結果配列内のオフセット任意フィールドデフォルト値：0 例：値 10 を指定すると、結果配列内の最初の 10 個の言及オブジェクトが省略され、後続のオブジェクトのデータが提供されます。注意：最大値は 9,000 です。さらに多くの結果をオフセットする場合は search_after_token を使用してください
- order_by
  型: array string[]
  
  結果の並べ替えルール任意フィールド filters 配列と同じ値を使用して結果を並べ替えられます指定可能な並べ替えの種類：asc - 結果は昇順で並べ替えられます desc - 結果は降順で並べ替えられます並べ替えの種類を設定するにはカンマを使用してください例：["ai_search_volume,desc"] 1 回のリクエストで設定できる並べ替えルールは 3 つまでです複数の並べ替えルールはカンマで区切ってください
- platform
  型: string
  
  対象プラットフォーム任意フィールド使用可能な値: chat_gpt, google デフォルト値: google 注意: 返されるデータは選択したプラットフォームによって異なります注意 2: chat_gpt データは米国と英語のみで利用できます
- search_after_token
  型: string
  
  後続リクエスト用のトークン任意フィールド各リクエストのレスポンスの同一フィールドで提供されます。このパラメーターを使用すると、1 回のリクエストで 20,000 件を超える結果を取得しようとしたときのタイムアウトを回避できます。レスポンス配列の一意の search_after_token 値を指定すると、最初のタスクの後続結果を取得できます。search_after_token の値は後続タスクごとに一意です。注意：リクエストで search_after_token を指定する場合、他のすべてのパラメーターは前回のリクエストと同一である必要があります
- tag
  型: string
  
  ユーザー定義のタスク識別子任意フィールド文字数上限は 255 ですこのパラメーターを使ってタスクを識別し、結果と照合できます指定した tag の値は、レスポンスの data オブジェクトに含まれます

レスポンス

200
型: object

成功レスポンス
cost
型: number

タスクの総コスト（USD）

status_code
型: integer

一般的なステータスコードレスポンスコードの完全な一覧はこちらです注意: 関連する例外やエラー条件を処理するための必要なシステムを設計することを強く推奨します

status_message
型: string

一般的な情報メッセージ一般的な情報メッセージの完全な一覧はこちらです

tasks
型: array string[]

タスクの配列

tasks_count
型: integer

tasks 配列内のタスク数

tasks_error
型: integer

エラーで返された tasks 配列内のタスク数

tasks.cost
型: number

タスクのコスト（USD）

tasks.data
型: object

POST リクエストで指定したものと同じパラメーターを含みます

tasks.id
型: string

タスク識別子当社システム内で UUID 形式の一意のタスク識別子

tasks.path
型: array string[]

URL パス

tasks.result
型: array string[]

結果の配列

tasks.result_count
型: integer

result 配列内の要素数

tasks.result.current_offset
型: integer

items 配列で省略される言及オブジェクトの数

tasks.result.items
型: array string[]

関連する言及データを含みます

tasks.result.items_count
型: integer

items 配列で返される結果の数

tasks.result.items.ai_search_volume
型: integer

キーワードの現在の AI 検索量この指標の詳細についてはこちらを参照してください

tasks.result.items.answer
型: string

markdown 形式の関連する回答 markdown マークアップ言語でフォーマットされた結果の内容

tasks.result.items.brand_entities
型: array string[]

ブランドエンティティの配列レスポンスで言及されたブランドに関する情報を含みます

tasks.result.items.brand_entities.category
型: string

ブランドのカテゴリ

tasks.result.items.brand_entities.position
型: integer

結果内の位置

tasks.result.items.brand_entities.title
型: string

ブランド名

tasks.result.items.fan_out_queries
型: array string[]

ファンアウトクエリの配列より包括的な回答を提供するために、メインクエリから派生した関連検索クエリを含みます

tasks.result.items.first_response_at
型: string

レスポンスデータが最初に記録された日時（UTC 形式）：“yyyy-mm-dd hh-mm-ss +00:00” 例：2025-10-21 06:25:30 +00:00

tasks.result.items.language_code
型: string

POST 配列の言語コード

tasks.result.items.last_response_at
型: string

レスポンスデータが最後に更新された日時（UTC 形式）：“yyyy-mm-dd hh-mm-ss +00:00” 例：2025-10-21 06:25:30 +00:00

tasks.result.items.location_code
型: integer

POST 配列の所在地コード

tasks.result.items.model_name
型: string

データの取得元である AI モデルの名前注意：google プラットフォームタイプの場合、値は常に google_ai_overview です

tasks.result.items.monthly_searches
型: array string[]

月別 AI 検索ボリュームレートある年の特定の月における AI 検索ボリュームレートを含むオブジェクトの配列

tasks.result.items.monthly_searches.month
型: integer

月

tasks.result.items.monthly_searches.search_volume
型: integer

ある年の特定の月における AI 検索ボリュームレートこの指標の詳細はこちら

tasks.result.items.monthly_searches.year
型: integer

年

tasks.result.items.platform
型: string

POST 配列で受け取るプラットフォーム

tasks.result.items.question
型: string

関連する質問

tasks.result.items.search_results
型: array string[]

検索結果の配列モデルが情報を調べるときに取得したすべてのウェブ検索出力（重複や未使用のエントリを含む）

tasks.result.items.search_results.breadcrumb
型: string

パンくずリスト

tasks.result.items.search_results.description
型: string

結果の説明

tasks.result.items.search_results.domain
型: string

結果のドメイン

tasks.result.items.search_results.position
型: integer

結果内の位置

tasks.result.items.search_results.publication_date
型: string

結果が公開された日時（形式）：“year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes” 例：2019-11-15 12:57:46 +00:00

tasks.result.items.search_results.title
型: string

結果のタイトル

tasks.result.items.search_results.url
型: string

結果の URL

tasks.result.items.sources
型: array string[]

ソースの配列モデルが最終回答で引用または依拠したソース

tasks.result.items.sources.domain
型: string

ソースドメイン

tasks.result.items.sources.markdown
型: string

要素の markdown 形式の内容 markdown マークアップ言語でフォーマットされた結果の内容

tasks.result.items.sources.position
型: integer

結果内の位置

tasks.result.items.sources.publication_date
型: string

結果が公開された日時（形式）：“year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes” 例：2019-11-15 12:57:46 +00:00

tasks.result.items.sources.snippet
型: string

ソースの説明

tasks.result.items.sources.source_name
型: string

ソース名

tasks.result.items.sources.thumbnail
型: string

ソースのサムネイル

tasks.result.items.sources.title
型: string

ソースのタイトル

tasks.result.items.sources.url
型: string

ソースの URL

tasks.result.search_after_token
型: string

後続リクエスト用のトークン新しいタスクを設定するときに一意の search_after_token を指定すると、最初のタスクの後続結果を取得できます。search_after_token の値は後続タスクごとに一意です

tasks.result.total_count
型: integer

リクエストに関連する結果の総数

tasks.status_code
型: integer

DataForSEO によって生成されたタスクのステータスコード。次の範囲内になります: 10000-60000 レスポンスコードの完全な一覧はこちらです

tasks.status_message
型: string

タスクの情報メッセージ一般的な情報メッセージの完全な一覧はこちらです

tasks.time
型: string

実行時間（秒）

time
型: string

実行時間（秒）

version
型: string

API の現在のバージョン
application/json
400

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

有効な Felo API キーが必要です。
402

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

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

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

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

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

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

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

application/json

post/v1/beta/dataforseo/ai_optimization/llm_mentions/search/live

curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/llm_mentions/search/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": [
      {}
    ],
    "location_name": "",
    "location_code": 1,
    "language_name": "",
    "language_code": "",
    "platform": "",
    "filters": [],
    "order_by": [
      ""
    ],
    "offset": 1,
    "search_after_token": "",
    "limit": 1,
    "tag": ""
  }
]'

スキーマを表示

{
  "version": "string",
  "status_code": 1,
  "status_message": "string",
  "time": "string",
  "cost": 1,
  "tasks_count": 1,
  "tasks_error": 1,
  "tasks": [
    "string"
  ],
  "tasks.id": "string",
  "tasks.status_code": 1,
  "tasks.status_message": "string",
  "tasks.time": "string",
  "tasks.cost": 1,
  "tasks.result_count": 1,
  "tasks.path": [
    "string"
  ],
  "tasks.data": {},
  "tasks.result": [
    "string"
  ],
  "tasks.result.total_count": 1,
  "tasks.result.current_offset": 1,
  "tasks.result.search_after_token": "string",
  "tasks.result.items_count": 1,
  "tasks.result.items": [
    "string"
  ],
  "tasks.result.items.platform": "string",
  "tasks.result.items.model_name": "string",
  "tasks.result.items.location_code": 1,
  "tasks.result.items.language_code": "string",
  "tasks.result.items.question": "string",
  "tasks.result.items.answer": "string",
  "tasks.result.items.sources": [
    "string"
  ],
  "tasks.result.items.sources.snippet": "string",
  "tasks.result.items.sources.source_name": "string",
  "tasks.result.items.sources.thumbnail": "string",
  "tasks.result.items.sources.markdown": "string",
  "tasks.result.items.sources.position": 1,
  "tasks.result.items.sources.title": "string",
  "tasks.result.items.sources.domain": "string",
  "tasks.result.items.sources.url": "string",
  "tasks.result.items.sources.publication_date": "string",
  "tasks.result.items.search_results": [
    "string"
  ],
  "tasks.result.items.search_results.description": "string",
  "tasks.result.items.search_results.breadcrumb": "string",
  "tasks.result.items.search_results.position": 1,
  "tasks.result.items.search_results.title": "string",
  "tasks.result.items.search_results.domain": "string",
  "tasks.result.items.search_results.url": "string",
  "tasks.result.items.search_results.publication_date": "string",
  "tasks.result.items.ai_search_volume": 1,
  "tasks.result.items.monthly_searches": [
    "string"
  ],
  "tasks.result.items.monthly_searches.year": 1,
  "tasks.result.items.monthly_searches.month": 1,
  "tasks.result.items.monthly_searches.search_volume": 1,
  "tasks.result.items.first_response_at": "string",
  "tasks.result.items.last_response_at": "string",
  "tasks.result.items.brand_entities": [
    "string"
  ],
  "tasks.result.items.brand_entities.position": 1,
  "tasks.result.items.brand_entities.title": "string",
  "tasks.result.items.brand_entities.category": "string",
  "tasks.result.items.fan_out_queries": [
    "string"
  ]
}

成功レスポンス

ヘルプが必要ですか？

API・請求・アカウントのご質問はサポートへ。
Discord で Felo の開発者と交流できます。
更新履歴をご覧ください。
ボリューム価格や購買についてのご相談は営業窓口へ。
LLM での構築をお考えですか？llms.txt をご覧ください。

LLM Mentions（ライブ）

認証Required

DataForSEO

LLM Mentions（ライブ）

料金の参考情報

ヘルプが必要ですか？