SERP API AI Summary

curl --request POST \ --url https://api.aisa.one/apis/v1/dataforseo/serp/ai_summary \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "task_id": "<string>", "prompt": "<string>", "support_extra": true, "fetch_content": true, "include_links": true } '

{ "version": "<string>", "status_code": 123, "status_message": "<string>", "time": "<string>", "cost": 123, "tasks": [ "<string>" ], "tasks[].id": "<string>", "tasks[].status_code": 123, "tasks[].status_message": "<string>", "tasks[].result_count": 123, "tasks[].path": [ "<string>" ], "tasks[].data": {}, "tasks[].result": [ "<string>" ], "tasks[].result[].items_count": 123, "tasks[].result[].items": [ "<string>" ], "tasks[].result[].items[].summary": "<string>" }

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

task_id

string

required

Unique identifier of the associated task in UUID format; can be used within 30 days

prompt

string

Additional AI prompt; maximum 2000 characters

support_extra

boolean

Whether to consider extra SERP features such as answer_box, knowledge_graph, and featured_snippet; default true

fetch_content

boolean

Whether to fetch content from pages in SERPs; default false

include_links

boolean

Whether to include source links in the summary; default false

Response

Successful response

version

string

The current version of the API

status_code

integer

General status code

status_message

string

General informational message

time

string

Execution time, seconds

cost

number

Total task cost, USD

tasks

string[]

Array of tasks

tasks[].id

string

Task identifier in UUID format

tasks[].status_code

integer

Task status code

tasks[].status_message

string

Task status message

tasks[].result_count

integer

Number of elements in the result array

tasks[].path

string[]

URL path

tasks[].data

object

Contains the same parameters specified in the POST request

tasks[].result

string[]

Array of results

tasks[].result[].items_count

integer

Number of items in the result array

tasks[].result[].items

string[]

Items array

tasks[].result[].items[].summary

string

Generated summary