Google Ads Search SERP GET Advanced

GET

/serp/google/ads_search/task_get/advanced/{id}

This endpoint will provide you with Google Ads Search SERP Advanced results based on the unique task identifier you received in response to the POST request.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.dataforseo.com/v3/serp/google/ads_search/task_get/advanced/' \
--header 'Authorization: Basic Og=='

Response Example

{
    "version": "0.1.20241227",
    "status_code": 20000,
    "status_message": "Ok.",
    "time": "0.0733 sec.",
    "cost": 0,
    "tasks_count": 1,
    "tasks_error": 0,
    "tasks": [
        {
            "id": "03311712-8029-0066-0000-4ea422a16123",
            "status_code": 20000,
            "status_message": "Ok.",
            "time": "0.0186 sec.",
            "cost": 0,
            "result_count": 1,
            "path": [
                "v3",
                "serp",
                "google",
                "ads_search",
                "task_get",
                "advanced",
                "03311712-8029-0066-0000-4ea422a16123"
            ],
            "data": {
                "api": "serp",
                "function": "task_get",
                "se": "google",
                "se_type": "ads_search",
                "location_name": "united states",
                "advertiser_ids": [
                    "AR16309824155472101377"
                ],
                "device": "desktop",
                "os": "windows"
            },
            "result": [
                {
                    "keyword": "ids:AR16309824155472101377",
                    "type": "ads_search",
                    "se_domain": "adstransparency.google.com",
                    "location_code": 2840,
                    "language_code": "en",
                    "check_url": "https://adstransparency.google.com/?region=US",
                    "datetime": "2025-03-31 14:12:42 +00:00",
                    "spell": null,
                    "refinement_chips": null,
                    "item_types": [
                        "ads_search"
                    ],
                    "se_results_count": 3,
                    "items_count": 3,
                    "items": [
                        {
                            "type": "ads_search",
                            "rank_group": 1,
                            "rank_absolute": 1,
                            "advertiser_id": "AR16309824155472101377",
                            "creative_id": "CR02693121326985510913",
                            "title": "SOCIEDADE BENEFICENTE ISRAELITA BRASILEIRA HOSPITAL ALBERT EINSTEIN",
                            "url": "https://adstransparency.google.com/advertiser/AR16309824155472101377/creative/CR02693121326985510913?region=US",
                            "verified": false,
                            "format": "image",
                            "preview_image": {
                                "url": "https://s0.2mdn.net/simgad/17541360125438248718",
                                "height": 600,
                                "width": 300
                            },
                            "preview_url": null,
                            "first_shown": "2024-06-19 20:30:00 +00:00",
                            "last_shown": "2024-10-21 07:00:00 +00:00"
                        },
                        {
                            "type": "ads_search",
                            "rank_group": 2,
                            "rank_absolute": 2,
                            "advertiser_id": "AR16309824155472101377",
                            "creative_id": "CR01815711048020262913",
                            "title": "SOCIEDADE BENEFICENTE ISRAELITA BRASILEIRA HOSPITAL ALBERT EINSTEIN",
                            "url": "https://adstransparency.google.com/advertiser/AR16309824155472101377/creative/CR01815711048020262913?region=US",
                            "verified": false,
                            "format": "image",
                            "preview_image": {
                                "url": "https://s0.2mdn.net/simgad/9062316185748894904",
                                "height": 600,
                                "width": 300
                            },
                            "preview_url": null,
                            "first_shown": "2024-07-20 05:30:00 +00:00",
                            "last_shown": "2024-10-03 10:00:00 +00:00"
                        },
                        {
                            "type": "ads_search",
                            "rank_group": 3,
                            "rank_absolute": 3,
                            "advertiser_id": "AR16309824155472101377",
                            "creative_id": "CR16589099610710999041",
                            "title": "SOCIEDADE BENEFICENTE ISRAELITA BRASILEIRA HOSPITAL ALBERT EINSTEIN",
                            "url": "https://adstransparency.google.com/advertiser/AR16309824155472101377/creative/CR16589099610710999041?region=US",
                            "verified": false,
                            "format": "image",
                            "preview_image": {
                                "url": "https://s0.2mdn.net/simgad/200899062089504348",
                                "height": 90,
                                "width": 728
                            },
                            "preview_url": null,
                            "first_shown": "2022-09-01 03:00:00 +00:00",
                            "last_shown": "2024-08-01 02:30:00 +00:00"
                        }
                    ]
                }
            ]
        }
    ]
}

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 *****************

Path Params

string

required

Task identifier

Responses

🟢200Success

application/json

Body

object {0}

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

Google Ads Search SERP Completed Tasks

Google Ads Search SERP Live Advanced