> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 获取 Ai Mode SERP 已完成任务

> 返回尚未领取的已完成任务列表。



## OpenAPI

````yaml openapi/zh/dataforseo.json GET /dataforseo/serp/google/ai_mode/tasks_ready
openapi: 3.0.3
info:
  title: DataForSEO API
  version: 1.0.0
  description: 通过 AIsa 统一网关提供的 DataForSEO API 端点。
servers:
  - url: https://api.aisa.one/apis/v1
security:
  - BearerAuth: []
paths:
  /dataforseo/serp/google/ai_mode/tasks_ready:
    get:
      summary: 获取 Ai Mode SERP 已完成任务
      description: >-
        返回尚未获取的已完成任务列表。如果指定了 postback_url，则仅当任务投递至您的服务器失败时，任务才会出现在此处。每分钟最多可调用
        API 20 次，每次调用最多可获取过去三天内完成的 1000 个任务。
      operationId: get_dataforseo_serp_google_ai_mode_tasks_ready
      responses:
        '200':
          description: 成功响应
          content:
            application/json:
              schema:
                type: object
                properties:
                  version:
                    type: string
                    description: API 的当前版本
                  status_code:
                    type: integer
                    description: 通用状态码
                  status_message:
                    type: string
                    description: 一般信息消息
                  time:
                    type: string
                    description: 执行时间（秒）
                  cost:
                    type: number
                    description: 任务总成本（美元）
                  tasks_count:
                    type: integer
                    description: tasks 数组中的任务数量
                  tasks_error:
                    type: integer
                    description: 返回错误的 tasks 数组中的任务数量
                  tasks:
                    type: array
                    items:
                      type: string
                    description: 任务数组
                  tasks[].id:
                    type: string
                    description: UUID 格式的任务标识符
                  tasks[].status_code:
                    type: integer
                    description: 任务状态码
                  tasks[].status_message:
                    type: string
                    description: 任务状态消息
                  tasks[].time:
                    type: string
                    description: 执行时间（秒）
                  tasks[].cost:
                    type: number
                    description: 任务成本（美元）
                  tasks[].result_count:
                    type: integer
                    description: 结果数组中的元素数量
                  tasks[].path:
                    type: array
                    items:
                      type: string
                    description: URL 路径
                  tasks[].data:
                    type: object
                    description: 包含请求 URL 中传递的参数
                  tasks[].result:
                    type: array
                    items:
                      type: string
                    description: 已完成任务引用的数组
                  tasks[].result[].id:
                    type: string
                    description: 已完成任务的任务标识符
                  tasks[].result[].se:
                    type: string
                    description: 设置任务时指定的搜索引擎
                  tasks[].result[].se_type:
                    type: string
                    description: 搜索引擎类型
                  tasks[].result[].date_posted:
                    type: string
                    description: 任务发布的日期，采用 UTC 格式
                  tasks[].result[].tag:
                    type: string
                    description: 用户定义的任务标识符
                  tasks[].result[].endpoint_advanced:
                    type: string
                    description: 用于收集 SERP Advanced 结果的 URL
                  tasks[].result[].endpoint_html:
                    type: string
                    description: 用于收集 SERP HTML 结果的 URL
        '400':
          description: 错误请求
        '401':
          description: 未授权
        '429':
          description: 超出速率限制
        '500':
          description: 内部服务器错误
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````