Google Ads Search SERP Completed Tasks

GET

/serp/google/ads_search/tasks_ready

The ‘Tasks Ready’ endpoint is designed to provide you with the list of completed tasks, which haven’t been collected yet.

Request

Authorization

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string username:password

Example:

Authorization: Basic *****************

Responses

🟢200Success

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.dataforseo.com/v3/serp/google/ads_search/tasks_ready' \
--header 'Authorization: Basic <encoded-value>'

Response Example

{
    "version": "0.1.20241227",
    "status_code": 20000,
    "status_message": "Ok.",
    "time": "0.8459 sec.",
    "cost": 0,
    "tasks_count": 1,
    "tasks_error": 0,
    "tasks": [
        {
            "id": "03311700-8029-0087-0000-db741a307715",
            "status_code": 20000,
            "status_message": "Ok.",
            "time": "0.1022 sec.",
            "cost": 0,
            "result_count": 2,
            "path": [
                "v3",
                "serp",
                "google",
                "ads_search",
                "tasks_ready"
            ],
            "data": {
                "api": "serp",
                "function": "tasks_ready",
                "se": "google",
                "se_type": "ads_search"
            },
            "result": [
                {
                    "id": "03311238-8029-0066-0000-a68eaa5442ac",
                    "se": "google",
                    "se_type": "ads_search",
                    "date_posted": "2025-03-31 09:38:13 +00:00",
                    "tag": "",
                    "endpoint_regular": null,
                    "endpoint_advanced": "/v3/serp/google/ads_search/task_get/advanced/03311238-8029-0066-0000-a68eaa5442ac",
                    "endpoint_html": null
                },
                {
                    "id": "03311239-8029-0066-0000-aafc47a45bb2",
                    "se": "google",
                    "se_type": "ads_search",
                    "date_posted": "2025-03-31 09:39:27 +00:00",
                    "tag": "",
                    "endpoint_regular": null,
                    "endpoint_advanced": "/v3/serp/google/ads_search/task_get/advanced/03311239-8029-0066-0000-aafc47a45bb2",
                    "endpoint_html": null
                }
            ]
        }
    ]
}

Modified at 2025-05-30 08:04:21

Google Ads Search SERP POST

Google Ads Search SERP GET Advanced