データ API / DataForSEO / SERP

Live Google Ai Mode SERP HTML

Returns Google's AI Mode answer for a query, with the sources it cites on Google, synchronously. Raw page source rather than parsed results. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200.

パラメータ

パス・クエリ・ヘッダーのパラメータはありません。

リクエストボディ

keywordstring必須
Keyword; you can specify up to 700 characters
location_namestring任意
Full name of search engine location; required if location_code or location_coordinate is not specified
location_codeinteger任意
Search engine location code; required if location_name or location_coordinate is not specified
location_coordinatestring任意
GPS coordinates of a location; required if location_name or location_code is not specified
language_namestring任意
Full name of search engine language; required if language_code is not specified
language_codestring任意
Search engine language code; required if language_name is not specified
devicestring任意
Device type: desktop or mobile

リクエスト例

curl -X POST "https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ai_mode/live/html" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "keyword": "<string>",
  "location_name": "<string>",
  "location_code": 0,
  "location_coordinate": "<string>",
  "language_name": "<string>",
  "language_code": "<string>",
  "device": "<string>"
}'

レスポンス

レスポンスのフィールド

versionstring任意
The current version of the API
status_codeinteger任意
General status code
status_messagestring任意
General informational message
timestring任意
Execution time, seconds
costnumber任意
Total tasks cost, USD
tasks_countinteger任意
The number of tasks in the tasks array
tasks_errorinteger任意
The number of tasks in the tasks array returned with an error
tasksstring[]任意
Array of tasks
idstring任意
Task identifier
status_codeinteger任意
Task status code
status_messagestring任意
Task status message
timestring任意
Execution time, seconds
costnumber任意
Cost of the task, USD
result_countinteger任意
Number of elements in the result array
pathstring[]任意
URL path
dataobject任意
Contains the same parameters specified in the POST request
resultstring[]任意
Array of HTML results
keywordstring任意
Keyword received in the POST array
typestring任意
Search engine type in the POST array
se_domainstring任意
Search engine domain in the POST array
location_codeinteger任意
Location code in the POST array
language_codestring任意
Language code in the POST array