Google Ads Search SERP POST

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. This is the Standard method of data retrieval. It requires making separate POST and GET requests. Using this method, you can retrieve the results after our system collects them.

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

{ "version": "0.1.20241227", "status_code": 20000, "status_message": "Ok.", "time": "0.0832 sec.", "cost": 0.0006, "tasks_count": 1, "tasks_error": 0, "tasks": [ { "id": "03311238-8029-0066-0000-a68eaa5442ac", "status_code": 20100, "status_message": "Task Created.", "time": "0.0044 sec.", "cost": 0.0006, "result_count": 0, "path": [ "v3", "serp", "google", "ads_search", "task_post" ], "data": { "api": "serp", "function": "task_post", "se": "google", "se_type": "ads_search", "location_name": "united states", "platform": "google_search", "advertiser_ids": [ "AR04459448256920813569" ], "device": "desktop", "os": "windows" }, "result": null } ] }

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.

postback_url

string

optional

Return URL for sending task results.

postback_data

enum<string>

optional

Postback_url datatype. Required field if you specify postback_url.

Allowed value:

advanced

pingback_url

string

optional

Notification URL of a completed task. When a task is completed we will notify you by GET request sent to the URL you have specified.

Examples

Request

Responses