Skip to main content
GET
Get Events SERP Completed Tasks
Lists finished Google events 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.

Example

Request contract

  • Method and path: GET /apis/v1/dataforseo/serp/google/events/tasks_ready
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/dataforseo/serp/google/events/tasks_ready
  • Runtime facts: 6ab8fec17df1d5dcdff2e036dd1eb40587752b774ec040ab4eb0cc6946c3dd3c
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

Usage-based billing; Default request estimate: $0.012 USD (not a fixed price). Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
  • Default request reference estimate (USD): 0.012
  • Cost contract: response_usd
  • Published reference multiplier: 1.0
  • Settlement evidence source: response_body

Authorizations

Authorization
string
header
required

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

Response

Successful response

cost
number

Total tasks cost, USD

status_code
integer

General status code

status_message
string

General informational message

tasks
string[]

Array of tasks

tasks[].result
string[]

Array of completed task references

tasks[].result[].date_posted
string

Date when the task was posted in UTC format

tasks[].result[].endpoint_advanced
string

URL for collecting SERP Advanced results

tasks[].result[].id
string

Task identifier of the completed task

tasks[].result[].se
string

Search engine specified when setting the task

tasks[].result[].se_type
string

Type of search engine

tasks[].result[].tag
string

User-defined task identifier

tasks_count
integer

The number of tasks in the tasks array

tasks_error
integer

The number of tasks in the tasks array returned with an error

time
string

Execution time, seconds

version
string

The current version of the API