データ API / DataForSEO / SERP

SERP API AI Summary

Returns the AI overview Google shows above the results for a query on Google. Returns keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count and items. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200.

パラメータ

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

リクエストボディ

task_idstring必須
Unique identifier of the associated task in UUID format; can be used within 30 days
promptstring任意
Additional AI prompt; maximum 2000 characters
support_extraboolean任意
Whether to consider extra SERP features such as answer_box, knowledge_graph, and featured_snippet; default true
fetch_contentboolean任意
Whether to fetch content from pages in SERPs; default false
include_linksboolean任意
Whether to include source links in the summary; default false

リクエスト例

curl -X POST "https://openapi.felo.ai/v1/beta/dataforseo/serp/ai_summary" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "task_id": "<string>",
  "prompt": "<string>",
  "support_extra": false,
  "fetch_content": false,
  "include_links": false
}'

レスポンス

レスポンスのフィールド

versionstring任意
The current version of the API
status_codeinteger任意
General status code
status_messagestring任意
General informational message
timestring任意
Execution time, seconds
costnumber任意
Total task cost, USD
tasksstring[]任意
Array of tasks
idstring任意
Task identifier in UUID format
status_codeinteger任意
Task status code
status_messagestring任意
Task status message
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 results
items_countinteger任意
Number of items in the result array
itemsstring[]任意
Items array
summarystring任意
Generated summary