データ API / DataForSEO / SERP

Get Ai Mode SERP Completed Tasks

Lists finished Google ai mode tasks awaiting collection. Free. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200. ⚠️ Rarely needed: a caller holds the id its own submit returned and can fetch directly. This answers what is ready across the whole account.

パラメータ

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

リクエスト例

curl -X GET "https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ai_mode/tasks_ready" \
  -H "Authorization: Bearer $FELO_API_KEY"

レスポンス

レスポンスのフィールド

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 in UUID format
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 parameters passed in the request URL
resultstring[]任意
Array of completed task references
idstring任意
Task identifier of the completed task
sestring任意
Search engine specified when setting the task
se_typestring任意
Type of search engine
date_postedstring任意
Date when the task was posted in UTC format
tagstring任意
User-defined task identifier
endpoint_advancedstring任意
URL for collecting SERP Advanced results
endpoint_htmlstring任意
URL for collecting SERP HTML results