Google Ads Search API: Overview
DataForSEO Google Ads Search API provides data on ads that are run by advertisers on the Google Ads platform. Data is based on the Google Ads Transparency platform.
The returned results are specific to the indicated advertiser_id (available in the Google Ads Advertisers endpoint) or target domain.
Note: Google Ads Search API provides results for desktop and windows only.
SERP API makes use of rank_group and rank_absolute parameters that show search engine result’s position among the group of elements or across all the elements in SERP respectively. Learn more about the difference between rank absolute and rank group in our help article.
Google Ads Search functions
Google Ads Search Advanced endpoint provides data on the top 40 search engine results for the specified parameters.
Methods
The cost of using Google Ads Search endpoints depends on the selected method and priority of task execution. Available methods and priorities are described below.
DataForSEO Ads Search API supports only the Standard method to deliver SERP results.
The Standard method of data retrieval requires making separate POST and GET requests to retrieve the results after our system collects them.
Alternatively, you can specify pingback_url or postback_url when setting a task, and we will notify you on completion of tasks or send the results to you respectively. Note that if you use the postback_url field, the only function that will be applied for data retrieval is advanced.
If you need to set several tasks, you can receive the list of id for all completed tasks using ‘Tasks Ready’ endpoint, and then collect the results of each separate task using ‘Task GET’ endpoint.
Learn more about task completion and obtaining a list of completed tasks in this help center article.
You can send up to 2000 POST and GET API calls per minute in total, with each POST call containing no more than 100 tasks. Contact us if you would like to raise the limit.
Priorities and cost
The Standard method has two different priorities that stand for the relative speed of task execution and have different prices:
1. Normal priority;
2. High priority.
Note: setting depth above the default value will increase the cost of the task. For example, if the default value is 40, you will be billed for every 40 results. So, if you specify "depth": 45, the price for the task will be multiplied by 2 and you will be billed as for 80 results.
The cost can be calculated on the Pricing page. To learn more about the cost of all SERP API methods, priorities, and additional parameters, please refer to this help article.
You can test Google Ads Search API for free using DataForSEO Sandbox.