DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
ライブ ChatGPT LLM Scraper
ユーザーと同じように ChatGPT に keyword を尋ね、解析済みの回答を返します。keyword、location_code、language_code、model、datetime、markdown、sources、fan_out_queries、brand_entities を返します。markdown はアシスタントが表示した回答、sources は引用したページ、brand_entities は言及したブランドです。force_web_search を指定すると、学習データから答えるのではなくブラウジングします。DataForSEO のエンベロープでラップされます。データは tasks[0].result、結果は tasks[0].status_code にあり、拒否されたリクエストでも HTTP 200 が返ります。「ChatGPT は我々について何と言っているか」を知るためのエンドポイントです。多数の回答にわたる言及回数を数えるには、繰り返しスクレイピングするのではなく post_dataforseo_ai_llm_mentions_aggregated_metrics_live を使ってください。生の形式は post_dataforseo_ai_chat_gpt_llm_scraper_live_html です。
料金の参考情報
- 計測方法：報告されたレスポンスコスト。
- 参考リクエスト見積もり：USD 0.004。
- 参照用の顧客乗数：1.0。確定済みの顧客金額には再適用しないでください。
参考情報のメタデータであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。
- 型: array (object | null)[]
- force型: boolean | null
_web _search AI エージェントにウェブ検索を強制
任意フィールド
有効にすると、AI モデルは現在のウェブ情報にアクセスして引用することが強制されます
デフォルト値:false
注意: パラメーターをtrueに設定しても、レスポンスでウェブソースが引用される保証はありません - keyword型: string
- language型: string
_code 検索エンジンの言語コード
language_nameを指定しない場合は必須フィールド
このフィールドを使用する場合、language_nameを指定する必要はありません
別途https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/languagesにリクエストを送信すると、検索エンジンがサポートする言語とそのlanguage_codeの一覧を取得できます - language型: string
_name 検索エンジンの言語の正式名称
language_codeを指定しない場合は必須フィールド
このフィールドを使用する場合、language_codeを指定する必要はありません
別途https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/languagesにリクエストを送信すると、検索エンジンがサポートする言語とそのlanguage_nameの一覧を取得できます - location型: integer
_code 検索エンジンのロケーションコード
location_nameを指定しない場合は必須フィールド
このフィールドを使用する場合、location_nameを指定する必要はありません
別途https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/locationsにリクエストを送信すると、検索エンジンの利用可能なロケーションとそのlocation_codeの一覧を取得できます
例:2840 - location型: string
_name 検索エンジンのロケーションの正式名称
location_codeを指定しない場合は必須フィールド
このフィールドを使用する場合、location_codeを指定する必要はありません
別途https://api.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/locationsにリクエストを送信すると、検索エンジンの利用可能なロケーションとそのlocation_nameの一覧を取得できます
例:United States - tag型: string | null
ユーザー定義のタスク識別子
任意フィールド
文字数上限は 255 です
このパラメーターを使ってタスクを識別し、結果と照合できます
指定したtagの値は、レスポンスのdataオブジェクトに含まれます
- 型: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmScraperLiveAdvancedResponseInfo200
- 型: number | null 形式: doublecost
タスクの総コスト（USD）
- 型: integer | nullstatus
_code 一般的なステータスコード レスポンスコードの完全な一覧はこちらです
- 型: string | nullstatus
_message 一般的な情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- 型: array (object | null)[] | nulltasks
タスクの配列
- 型: object | null · Response36Afe1097B20_AiOptimizationChatGptLlmScraperLiveAdvancedTaskInfo
- cost型: number | null 形式: double
タスクの総コスト（USD）
- data型: object | null
POST リクエストで指定したものと同じパラメーターを含みます
- property型: object | null
Name
- id型: string | null
タスク識別子 当社システム内で UUID 形式の一意のタスク識別子
- path型: array (string | null)[] | null
URL パス
- result型: array (object | null)[] | null
結果の配列
- brand型: array (object | null)[] | null
_entities ブランドエンティティの配列
レスポンスで言及されたブランドの情報を含みます - check型: string | null
_url 検索エンジン結果への直接 URL
正確な結果が提供されていることを確認するために使用できます - datetime型: string | null
結果を受信した日時
UTC 形式：“yyyy-mm-dd hh-mm-ss +00:00”
例：2019-11-15 12:57:46 +00:00 - fan型: array (string | null)[] | null
_out _queries ファンアウトクエリの配列
より包括的な回答を提供するために、メインクエリから導出された関連検索クエリを含みます - item型: array (string | null)[] | null
_types 検索結果のタイプ
SERP で見つかった検索結果のタイプ（items）を含みます。
指定可能なアイテムタイプ:chat_gpt_text、chat_gpt_table、chat_gpt_navigation_list、chat_gpt_images、chat_gpt_local_businesses、chat_gpt_products - items型: array (object | null)[] | null
ChatGPT 結果の要素
- rank型: integer | null
_absolute SERP の絶対ランク
すべての要素の中での絶対位置 - rank型: integer | null
_group SERP のグループ順位
同じtype値を持つ要素のグループ内での位置type値が異なる要素の位置はrank_groupから除外されます - type型: string | null
要素の種類
- items型: integer | null 形式: int64
_count items配列で返された結果数 - keyword型: string | null
POST 配列で受け取ったキーワード
キーワードはデコードされた %## とともに返されます（プラス記号「+」は空白文字にデコードされます） - language型: string | null
_code POST 配列内の言語コード
- location型: integer | null
_code POST 配列内のロケーションコード
- markdown型: string | null
- model型: string | null
モデルバージョンを示します
- se型: integer | null 形式: int64
_results _count 結果の総数
- search型: array (object | null)[] | null
_results 検索結果の配列
モデルが情報を調べるときに取得したすべてのウェブ検索出力（重複や未使用のエントリを含む）- breadcrumb型: string | null
パンくずリスト
- description型: string | null
結果の説明
- domain型: string | null
結果のドメイン
- title型: string | null
結果のタイトル
- type型: string | null
要素の種類
- url型: string | null
結果 URL
- sources型: array (object | null)[] | null
ソースの配列
モデルが最終回答で実際に引用または依拠したソース- domain型: string | null
SERP のソースドメイン
- markdown型: string | null
- publication型: string | null
_date 結果が公開された日時
形式：“year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”
例：2019-11-15 12:57:46 +00:00 - snippet型: string | null
ソースの説明
- source型: string | null
_name ソース名
- thumbnail型: string | null
ソースのサムネイル
- title型: string | null
ソースのタイトル
- type型: string | null
要素の種類
- url型: string | null
ソース URL
- result型: integer | null 形式: int64
_count result 配列内の要素数
- status型: integer | null
_code タスクのステータスコード DataForSEO によって生成され、次の範囲の値になります: 10000-60000 レスポンスコードの完全な一覧はこちらです
- status型: string | null
_message タスクの情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- time型: string | null
実行時間（秒）
- 型: integer | null 形式: int64tasks
_count tasks 配列内のタスク数
- 型: integer | null 形式: int64tasks
_error エラーで返された tasks 配列内のタスク数
- 型: string | nulltime
合計実行時間（秒）
- 型: string | nullversion
API の現在のバージョン
application/json - 400
リクエストを処理できませんでした。リクエストパラメータを確認してください。
- 401
有効な Felo API キーが必要です。
- 402
請求要件が満たされていないため、リクエストを続行できません。
- 403
このアカウントにはこの操作を行う権限がありません。
- 429
リクエストまたは支出の上限に達しました。
- 502
サービスがリクエストを完了できませんでした。
- 503
API または請求サービスが一時的に利用できません。
- 504
リクエストの処理中にサービスがタイムアウトしました。
- default
エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/chat_gpt/llm_scraper/live/advanced \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"keyword": "albert einstein"
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"keyword": null,
"location_code": null,
"language_code": null,
"model": null,
"check_url": null,
"datetime": null,
"markdown": null,
"search_results": [
{
"type": null,
"url": null,
"domain": null,
"title": null,
"description": null,
"breadcrumb": null
}
],
"sources": [
{
"type": null,
"title": null,
"snippet": null,
"domain": null,
"url": null,
"thumbnail": null,
"source_name": null,
"publication_date": null,
"markdown": null
}
],
"fan_out_queries": [
null
],
"brand_entities": [
{
"type": null,
"title": null,
"category": null,
"markdown": null,
"urls": null
}
],
"se_results_count": null,
"item_types": [
null
],
"items_count": null,
"items": [
{
"type": null,
"rank_group": null,
"rank_absolute": null
}
]
}
]
}
]
}