Google Ads Search SERP Live Advanced

POST

/serp/google/ads_search/live/advanced

Google Ads Search provides information on ads that are run by advertisers on Google Ads. Information is based on the Ads Transparency platform and adapted for the convenience of DataForSEO users. ‌‌

Google Ads Search SERP API provides top search engine results specific to the specified location and other specified parameters. Live endpoint provides Google Ads Search SERP results in response to a single request.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.dataforseo.com/v3/serp/google/ads_search/live/advanced' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic Og==' \
--data-raw '[
    {
        "location_name": "united states",
        "platform": "google_search",
        "advertiser_ids": [
            "AR13752565271262920705",
            "AR02439908557932462081"
        ]
    }
]'

Response Example

{
    "version": "0.1.20241227",
    "status_code": 20000,
    "status_message": "Ok.",
    "time": "5.3696 sec.",
    "cost": 0.002,
    "tasks_count": 1,
    "tasks_error": 0,
    "tasks": [
        {
            "id": "03311723-8029-0139-0000-b7241a63cf54",
            "status_code": 20000,
            "status_message": "Ok.",
            "time": "5.2981 sec.",
            "cost": 0.002,
            "result_count": 1,
            "path": [
                "v3",
                "serp",
                "google",
                "ads_search",
                "live",
                "advanced"
            ],
            "data": {
                "api": "serp",
                "function": "live",
                "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": null,
                    "datetime": "2025-03-31 14:23:22 +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 *****************

Body Params application/json

array of:

target

string

optional

Domain name associated with an advertiser account. Required field if advertiser_ids is not specified.

advertiser_ids

string

optional

Advertiser identifiers. Required field if target is not specified. You can specify the maximum of 25 values in this array. Advertiser_ids values for this parameter can be found in the Google Ads Advertisers endpoin.

location_name

string

required

Full name of search engine location. You can find the supported locations in the DataForSEO documentation.

location_coordinate

string

optional

GPS coordinates of a location. If you use this field, you don’t need to specify location_name. location_coordinate parameter should be specified in the latitude,longitude,radius format. The maximum number of decimal digits for latitude and longitude: 7. The minimum value for “radius”: 199.9 (mm), the maximum value for “radius”: 199999 (mm). Example: 53.476225,-2.243572,200.

platform

enum<string>

optional

Advertising platform.

Allowed values:

allgoogle_playgoogle_mapsgoogle_searchgoogle_shoppingyoutube

Default:

all

format

enum<string>

optional

Ad format.

Allowed values:

alltextimagevideo

date_from

string

optional

Starting date of the time range. Required field if date_to is specified. Date format: yyyy-mm-dd. Minimum value: 2018-05-31. Maximum value: today’s date.

date_to

string

optional

Ending date of the time range. Required field if date_from is specified. Date format: yyyy-mm-dd. Minimum value: 2018-05-31. Maximum value: today’s date.

depth

integer

optional

Parsing depth. Number of results in SERP.

<= 700

Default:

100

priority

enum<integer>

optional

Task priority.

Allowed values:

Default:

tag

string

optional

User-defined task identifier. You can use this parameter to identify the task and match it with the result.

Examples

Responses

🟢200Success

application/json

Body

object {0}

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

Google Ads Search SERP GET Advanced

Google Ads Search Locations for SERP