{"id":11597,"date":"2021-11-12T13:47:47","date_gmt":"2021-11-12T13:47:47","guid":{"rendered":"https:\/\/docs_v3.dataforseo.com\/v3\/?page_id=11597"},"modified":"2025-04-23T15:06:19","modified_gmt":"2025-04-23T15:06:19","slug":"google_ads-migration_guide","status":"publish","type":"page","link":"https:\/\/docs.dataforseo.com\/v3\/google_ads-migration_guide\/","title":{"rendered":"Google Ads Migration Guide"},"content":{"rendered":"

[vc_row][vc_column][vc_column_text]<\/p>\n

Google Ads Migration Guide<\/h1>\n

DataForSEO Google Ads API is based on the latest version of Google Ads API <\/a> that has replaced legacy Google AdWords API.<\/strong><\/p>\n

Google Ads API is the latest programmatic interface to the Google Ads platform that offers new features and improvements while also deprecating some of the concepts of the preceding Google AdWords API. This Migration Guide is aimed at helping you make sense of these changes and make the transition as smooth and convenient as possible. <\/p>\n

Preparing for migration takes three simple, but nonetheless crucial steps:
\n <\/p>\n

1. Configure the client<\/h3>\n

 
\nIf you’re using our recommended PHP client<\/a>, you have to change the search engine parameter in the URLs of POST and GET requests.
\nJust replace google<\/code> with google_ads<\/code> in the string. <\/p>\n

2. Modify your POST requests<\/h3>\n

 
\nAside from changing URL parameters, you may also have to modify parameters in your POST requests.
\nWhile all the required fields remain unchanged, there are a few new features you can implement.<\/p>\n

3. Check new and deprecated response fields<\/h3>\n

 
\nThe new version introduces a number of new fields in each endpoint. However, you will see that some fields from the old version are now deprecated.
\nYou will find more information in this guide, as well as on our blog<\/a> <\/p>\n

4. Test and iterate<\/h3>\n

 
\nThis is not an incremental update, so you may need to run a few tests and iterate the POST data parameters to achieve the desired results.
\nWe offer a free Sandbox feature<\/a> to facilitate the process.
\n 
\nBelow you will find the description of differences between the old DataForSEO Google Adwords API and its new Google Ads API counterpart.
\n <\/p>\n

Major changes<\/h2>\n

<\/p>\n\n\n\n\n\n\n\n\n\n
Change<\/th>\nReference<\/th>\nNotes<\/th>\n<\/tr>\n<\/thead>\n
Higher limits<\/td>\nread more<\/a><\/p>\nNew version allows getting from 1,000 to 20,000 keywords in a single request<\/td>\n<\/tr>\n
Date ranges<\/td>\nread more<\/a><\/td>\nSpecify the dates to get data for a certain period of time<\/td>\n<\/tr>\n
Strict keyword requirements<\/td>\nread more<\/a><\/td>\nThe new version has strict requirements for the keywords you can and cannot specify, e.g., keywords with UTF-8 symbols are not allowed<\/td>\n<\/tr>\n
Sorting parameters<\/td>\nread more<\/a><\/td>\nYou can now apply the sort_by<\/code> parameter to sort the results<\/td>\n<\/tr>\n
New traffic estimation<\/td>\nread more<\/a><\/td>\nAd Traffic By Keywords now returns stats for the specified forecasting time period<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Deprecated endpoints<\/h2>\n

<\/p>\n\n\n\n\n\n\n\n
Endpoint<\/th>\nReason<\/th>\nNotes<\/th>\n<\/tr>\n<\/thead>\n
Ad traffic by Platforms<\/a><\/td>\nPlatforms not supported<\/td>\nGoogle Ads API provides data aggregated for all platform types<\/td>\n<\/tr>\n
Keywords for Category<\/a><\/td>\nCategories not supported<\/td>\nGoogle Ads API has no alternative for categories<\/td>\n<\/tr>\n
Categories<\/a><\/td>\nCategories not supported<\/td>\nGoogle Ads API has no alternative for categories<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Deprecated Request Parameters<\/h2>\n

<\/p>\n\n\n\n\n\n\n
Parameter<\/th>\nEndpoint<\/th>\nNotes<\/th>\n<\/tr>\n<\/thead>\n
keywords_negative<\/code><\/td>\nKeywords For Site<\/a>,
\nKeywords For Keywords<\/a> <\/td>\n		negative keywords are not supported for now, but will be added in the nearest future<\/td>\n<\/tr>\n
closely_variants<\/code><\/td>\nKeywords For Keywords<\/a><\/td>\nclosely variants are not supported in the new version<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Deprecated Response Parameters<\/h2>\n

<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Parameter<\/th>\nEndpoint<\/th>\nNotes<\/th>\n<\/tr>\n<\/thead>\n
cpc<\/code><\/td>\nSearch Volume<\/a>
\nKeywords For Site<\/a>
\nKeywords For Keywords<\/a>\n<\/td>\n		cpc data is not supported in the new version<\/td>\n<\/tr>\n
categories<\/code><\/td>\nSearch Volume<\/a>
\nKeywords For Site<\/a>
\nKeywords For Keywords<\/a>\n<\/td>\n		categories are not supported in the new version<\/td>\n<\/tr>\n
ad_position_min<\/code><\/td>\nAd Traffic By Keywords<\/a><\/td>\nthe concept of ad positions is deprecated<\/td>\n<\/tr>\n
ad_position_max<\/code><\/td>\nAd Traffic By Keywords<\/a><\/td>\nthe concept of ad positions is deprecated<\/td>\n<\/tr>\n
ad_position_average<\/code><\/td>\nAd Traffic By Keywords<\/a><\/td>\nthe concept of ad positions is deprecated<\/td>\n<\/tr>\n
cpc_min<\/code><\/td>\nAd Traffic By Keywords<\/a><\/td>\nonly average cpc historically paid for the keyword is supported<\/td>\n<\/tr>\n
cpc_max<\/code><\/td>\nAd Traffic By Keywords<\/a><\/td>\nonly average cpc historically paid for the keyword is supported<\/td>\n<\/tr>\n
cpc_average<\/code><\/td>\nAd Traffic By Keywords<\/a><\/td>\naverage cpc historically paid for the keyword is represented by average_cpc<\/code><\/td>\n<\/tr>\n
daily_impressions_min<\/code><\/td>\nAd Traffic By Keywords<\/a><\/td>\nonly impressions for the specified time period are supported<\/td>\n<\/tr>\n
daily_impressions_max<\/code><\/td>\nAd Traffic By Keywords<\/a><\/td>\nonly impressions for the specified time period are supported<\/td>\n<\/tr>\n
daily_impressions_average<\/code><\/td>\nAd Traffic By Keywords<\/a><\/td>\nonly impressions for the specified time period are supported<\/td>\n<\/tr>\n
daily_clicks_min<\/code><\/td>\nAd Traffic By Keywords<\/a><\/td>\nonly clicks for the specified time period are supported<\/td>\n<\/tr>\n
daily_clicks_max<\/code><\/td>\nAd Traffic By Keywords<\/a><\/td>\nonly clicks for the specified time period are supported<\/td>\n<\/tr>\n
daily_clicks_average<\/code><\/td>\nAd Traffic By Keywords<\/a><\/td>\nonly clicks for the specified time period are supported<\/td>\n<\/tr>\n
daily_cost_min<\/code><\/td>\nAd Traffic By Keywords<\/a><\/td>\ncost for the specified time period is represented by cost_micros<\/code><\/td>\n<\/tr>\n
daily_cost_max<\/code><\/td>\nAd Traffic By Keywords<\/a><\/td>\ncost for the specified time period is represented by cost_micros<\/code><\/td>\n<\/tr>\n
daily_cost_average<\/code><\/td>\nAd Traffic By Keywords<\/a><\/td>\ncost for the specified time period is represented by cost_micros<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Core Google Ads\/Adwords API parallels<\/h2>\n

<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Google AdWords<\/th>\nGoogle Ads<\/th>\n<\/tr>\n<\/thead>\n
Search Volume<\/strong><\/td>\n<\/td>\n<\/tr>\n
Live Google Search Volume<\/a><\/td>\nLive Google Ads Search Volume<\/a><\/td>\n<\/tr>\n
Set Google Search Volume Tasks<\/a><\/td>\nSet Google Ads Search Volume Tasks<\/a><\/td>\n<\/tr>\n
Get Google Search Volume Completed Tasks<\/a><\/td>\nGet Google Ads Search Volume Completed Tasks<\/a><\/td>\n<\/tr>\n
Get Google Search Volume Results by id<\/a><\/td>\nGet Google Ads Search Volume Results by id<\/a><\/td>\n<\/tr>\n
Keywords For Keywords<\/strong><\/td>\n<\/td>\n<\/tr>\n
Live Google Keywords for Keywords<\/a><\/td>\nLive Google Ads Keywords for Keywords<\/a><\/td>\n<\/tr>\n
Set Google Keywords for Keywords Tasks<\/a><\/td>\nSet Google Ads Keywords for Keywords Tasks<\/a><\/td>\n<\/tr>\n
Get Google Keywords for Keywords Completed Tasks<\/a><\/td>\nGet Google Ads Keywords for Keywords Completed Tasks<\/a><\/td>\n<\/tr>\n
Get Google Keywords for Keywords Results by id<\/a><\/td>\nGet Google Ads Keywords for Keywords Results by id<\/a><\/td>\n<\/tr>\n
Keywords for Site<\/strong><\/td>\n<\/td>\n<\/tr>\n
Live Google Keywords for Site<\/a><\/td>\nLive Google Ads Keywords for Site<\/a><\/td>\n<\/tr>\n
Set Google Keywords for Site Tasks<\/a><\/td>\nSet Google Ads Keywords for Site Tasks<\/a><\/td>\n<\/tr>\n
Get Google Keywords for Site Completed Tasks<\/a><\/td>\nGet Google Ads Keywords for Site Completed Tasks<\/a><\/td>\n<\/tr>\n
Get Google Keywords for Site Results by id<\/a><\/td>\nGet Google Ads Keywords for Site Results by id<\/a><\/td>\n<\/tr>\n
Ad Traffic by Keywords<\/strong><\/td>\n<\/td>\n<\/tr>\n
Live Google Ad Traffic By Keywords<\/a><\/td>\nLive Google Ads Ad Traffic By Keywords<\/a><\/td>\n<\/tr>\n
Set Google Ad Traffic By Keywords Tasks<\/a><\/td>\nSet Google Ads Ad Traffic By Keywords Tasks<\/a><\/td>\n<\/tr>\n
Get Google Ad Traffic By Keywords Completed Tasks<\/a><\/td>\nGet Google Ads Ad Traffic By Keywords Completed Tasks<\/a><\/td>\n<\/tr>\n
Get Google Ad Traffic By Keywords Results by id<\/a><\/td>\nGet Google Ads Ad Traffic By Keywords Results by id<\/a><\/td>\n<\/tr>\n<\/table>\n

Note<\/h2>\n


\nIn order to keep your software functional and avoid any issues that might occur when Google sunsets its Google AdWords API, we recommend fully migrating by April 2022. DataForSEO is committed to helping all its customers transition to the new version as soon as possible. Please, don’t hesitate to contact our support team if you have any questions or require assistance with the migration process. <\/p>\n

\u200c[\/vc_column_text][\/vc_column][\/vc_row]<\/p>\n<\/div>","protected":false},"excerpt":{"rendered":"

[vc_row][vc_column][vc_column_text] Google Ads Migration Guide DataForSEO Google Ads API is based on the latest version of Google Ads API that has replaced legacy Google AdWords API. Google Ads API is the latest programmatic interface to the Google Ads platform that offers new features and improvements while also deprecating some of the concepts of the preceding […]<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"template.php","meta":{"apibase_doc_request_yaml":"","apibase_doc_request_additional_yaml":"","apibase_doc_response_yaml":"","footnotes":""},"class_list":["post-11597","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/11597","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/comments?post=11597"}],"version-history":[{"count":43,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/11597\/revisions"}],"predecessor-version":[{"id":21478,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/11597\/revisions\/21478"}],"wp:attachment":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/media?parent=11597"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}