{"id":3025,"date":"2020-01-16T13:47:02","date_gmt":"2020-01-16T13:47:02","guid":{"rendered":"https:\/\/docs_v3.dataforseo.com\/v3\/?page_id=3025"},"modified":"2025-12-02T14:56:07","modified_gmt":"2025-12-02T14:56:07","slug":"migration_guide_v3","status":"publish","type":"page","link":"https:\/\/docs.dataforseo.com\/v3\/migration_guide_v3\/","title":{"rendered":"DataForSEO v3 Migration Guide"},"content":{"rendered":"

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

DataForSEO v3 Migration Guide<\/h1>\n

Important note for current API v2 users:<\/strong> As of May 5, 2026, API v2 will no longer be supported. To make sure everything keeps running smoothly, we recommend moving to API v3 ahead of that date. This guide will help you get started.<\/p>\n

Version three is designed for improving, speeding up and simplifying the general experience of working with our APIs. We have incorporated a number of quality enhancements that allow scaling up your operations, while the cost for API requests was decreased.<\/p>\n

Migrating to the new version takes four simple but essential steps:
\n <\/p>\n

1. Log into the new dashboard<\/h3>\n

 
\nWe have created a new stand-alone account dashboard for version three. You can log into it by clicking “Login” on our website or “Sign in” button from v3 documentation.<\/p>\n

Log in now >><\/a><\/em>
\n <\/p>\n

2. Upgrade your examples<\/h3>\n

 
\nSame as we had it in the previous version, v3 runs on the REST technology and HTTP protocol, so you can apply our APIs to almost any programming language. We have prepared new examples for PHP, Python, and C#. You can download the necessary examples from the Introduction page of v3 and import them into your library. <\/p>\n

Download >><\/a><\/em>
\n <\/p>\n

3. Upgrade your code<\/h3>\n

 
\nAs you start working with the new version, you will quickly find out this is not an incremental upgrade and it will take some effort to implement it. The good news, however, is that we\u2019ve incorporated a number of new features and improved the overall usability of the API from the developer\u2019s standpoint. <\/p>\n

Before you start planning the migration, we recommend that you take some time to understand the difference between the versions. You can find a detailed explanation of changes in our blog.<\/p>\n

DataForSEO v3 Release: Doubling Down on Developer Experience >><\/a><\/em>
\n <\/p>\n

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

 
\nWhen you log into your new account for the first time, you will receive $1 for testing DataForSEO v3. <\/p>\n

You can also use the free Sandbox feature<\/a> to facilitate the migration process.<\/p>\n

Once you are prepared to switch to the new version, you might have some funds remaining on your account balance. We have thought of this beforehand, and we want to reassure you that the migration will not drag any money loss. Drop a line to our support team if you would like to transfer the funds from v2 to your new v3 account balance.<\/p>\n

Key improvements for a developer<\/h2>\n

<\/p>\n\n\n\n\n\n\n\n\n
Improvement<\/th>\nReference<\/th>\nNotes<\/th>\n<\/tr>\n<\/thead>\n
Standardized error\/status codes and messages<\/td>\nread more<\/a>
\nstatus\/error codes<\/a><\/td>\n		Version 3 has a new, standardized set of error and status codes.<\/td>\n<\/tr>\n
Streamlined URL structure of API calls<\/td>\nread more<\/a><\/td>\nURLs of the API endpoints now reflect its core parameters and functions.<\/td>\n<\/tr>\n
Simple task identifiers<\/td>\nread more<\/a><\/td>\nAll the parameters that you specified in the POST request are now reflected in the data<\/code> array of API responses. You can also use the custom task identifier tag<\/code> to match posted tasks with the returned results.<\/td>\n<\/tr>\n
New pricing model<\/td>\nread more<\/a>
\npricing<\/a><\/td>\n		We reduced the prices and tied them to the US dollar.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

New concepts<\/h2>\n

<\/p>\n\n\n\n\n\n\n\n\n\n\n
Concept<\/th>\nParent API<\/th>\nNotes<\/th>\n<\/tr>\n<\/thead>\n
Retrieving website rankings with SERP API<\/td>\nSERP API<\/td>\nYou can get website rankings by filtering out relevant SERP results or using the target<\/code> field
\nread more<\/a><\/td>\n<\/tr>\n
SERP functions in the GET request<\/td>\nSERP API<\/td>\nYour account will be charged for POST requests only.
\nBy sending GET requests to Organic, Advanced and HTML endpoints,
\nyou will get all three formats of the requested SERP at no additional cost<\/td>\n<\/tr>\n
New search engine types<\/td>\nSERP API<\/td>\nGoogle Organic\/Maps\/News\/Images and more;
\nBing Organic\/Local Pack;
\nYahoo Organic<\/td>\n<\/tr>\n
Device & OS<\/td>\nSERP API<\/td>\nwindows<\/code> and macos<\/code> for desktop<\/strong><\/code>
\nandroid<\/code> and ios<\/code> for mobile<\/strong><\/code><\/td>\n<\/tr>\n
Location coordinates<\/td>\nSERP API, Keywords Data API<\/td>\nYou can get data for a particular location by specifying its GPS coordinates
\nin the location_coordinate<\/code> field<\/td>\n<\/tr>\n
Bulk-only search volume<\/td>\nKeywords Data API<\/td>\nYou can get search volume for up to 700 keywords,
\nthe price for one or 700 keywords will be the same<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Core v2\/v3 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\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\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\n
v2 property<\/th>\nv3 equivalent<\/th>\n<\/tr>\n<\/thead>\n
SERP API<\/strong><\/td>\n<\/td>\n<\/tr>\n
Live SERP<\/a><\/td>\nLive Google Organic SERP Regular<\/a><\/td>\n<\/tr>\n
Setting SERP Tasks<\/a><\/td>\nSetting Google Organic SERP Tasks<\/a><\/td>\n<\/tr>\n
Get SERP Completed Tasks<\/a><\/td>\nGet Organic SERP Completed Tasks<\/a><\/td>\n<\/tr>\n
Get SERP Results by task_id<\/a><\/td>\nGet Google Organic SERP Results by id<\/a><\/td>\n<\/tr>\n
Setting SERP HTML Tasks<\/a><\/td>\nSetting Google Organic SERP Tasks<\/a><\/td>\n<\/tr>\n
Get SERP HTML Completed Tasks<\/a><\/td>\nGet Organic SERP Completed Tasks<\/a><\/td>\n<\/tr>\n
Get SERP HTML Results by task_id<\/a><\/td>\nGet Google Organic HTML Results by id<\/a><\/td>\n<\/tr>\n
Live Extra SERP<\/a><\/td>\nLive Google Organic SERP Advanced<\/a><\/td>\n<\/tr>\n
Setting Extra SERP Tasks<\/a><\/td>\nSetting Google Organic SERP Tasks<\/a><\/td>\n<\/tr>\n
Get Extra SERP Completed Tasks<\/a><\/td>\nGet Organic SERP Completed Tasks<\/a><\/td>\n<\/tr>\n
Get Extra SERP Results by task_id<\/a><\/td>\nGet Google Organic SERP Advanced Results by id<\/a><\/td>\n<\/tr>\n
Setting Google Images Tasks<\/a><\/td>\nSetting Google Images SERP Tasks<\/a><\/td>\n<\/tr>\n
Get Google Images Completed Tasks<\/a><\/td>\nGet Images SERP Completed Tasks<\/a><\/td>\n<\/tr>\n
Get Google Images Results by task_id<\/a><\/td>\nGet Google Images SERP Results by id<\/a><\/td>\n<\/tr>\n
List of Locations<\/a><\/td>\nList of Google Locations for SERP<\/a><\/td>\n<\/tr>\n
Keywords Data API<\/strong><\/td>\n<\/td>\n<\/tr>\n
Bulk Keyword Search Volume – Live<\/a><\/td>\nSetting Live \u2018Search Volume\u2019 Tasks<\/a><\/td>\n<\/tr>\n
Bulk Keyword Search Volume – Set Task<\/a><\/td>\nSetting \u2018Search Volume\u2019 Tasks<\/a><\/td>\n<\/tr>\n
Bulk Keyword Search Volume – Get Completed Tasks<\/a><\/td>\nGet \u2018Search Volume\u2019 Completed Tasks<\/a><\/td>\n<\/tr>\n
Bulk Keyword Search Volume – Get Results by task_id<\/a><\/td>\nGet \u2018Search Volume\u2019 Results by id<\/a><\/td>\n<\/tr>\n
Keywords for Domain – Live<\/a><\/td>\nSetting Live \u2018Keywords For Site\u2019 Tasks<\/a><\/td>\n<\/tr>\n
Keywords for Domain – Set Task<\/a><\/td>\nSetting \u2018Keywords For Site\u2019 Tasks<\/a><\/td>\n<\/tr>\n
Keywords for Domain – Get Completed Tasks<\/a><\/td>\nGet \u2018Keywords For Site\u2019 Completed Tasks<\/a><\/td>\n<\/tr>\n
Keywords for Domain – Get Results by task_id<\/a><\/td>\nGet \u2018Keywords For Site\u2019 Results by id<\/a><\/td>\n<\/tr>\n
Keywords for Keywords – Live Data<\/a><\/td>\nSetting Live \u2018Keywords For Keywords\u2019 Tasks<\/a><\/td>\n<\/tr>\n
Keywords for Keywords – Set Task<\/a><\/td>\nSetting \u2018Keywords For Keywords\u2019 Tasks<\/a><\/td>\n<\/tr>\n
Keywords for Keywords – Get Completed Tasks<\/a><\/td>\nGet \u2018Keywords For Keywords\u2019 Completed Tasks<\/a><\/td>\n<\/tr>\n
Keywords for Keywords – Get Results by task_id<\/a><\/td>\nGet \u2018Keywords For Keywords\u2019 Results by id<\/a><\/td>\n<\/tr>\n
Ads Traffic for Keywords – Live Data<\/a><\/td>\nSetting Live \u2018Ads Traffic By Keywords\u2019 Tasks<\/a><\/td>\n<\/tr>\n
Ads Traffic for Keywords – Set Task<\/a><\/td>\nSetting \u2018Ads Traffic By Keywords\u2019 Tasks<\/a><\/td>\n<\/tr>\n
Ads Traffic for Keywords – Get Completed Tasks<\/a><\/td>\nGet \u2018Ads Traffic By Keywords\u2019 Completed Tasks<\/a><\/td>\n<\/tr>\n
Ads Traffic for Keywords – Get Results by task_id<\/a><\/td>\nGet \u2018Ads Traffic By Keywords\u2019 Results by id<\/a><\/td>\n<\/tr>\n
DataForSEO Labs API<\/strong><\/td>\n<\/td>\n<\/tr>\n
Get Related Keywords<\/a><\/td>\nSetting Live ‘Related Keywords’ Tasks<\/a><\/td>\n<\/tr>\n
Get Similar Keywords<\/a><\/td>\nSetting Live ‘Keyword Suggestions’ Tasks<\/a><\/td>\n<\/tr>\n
Get Ranked Keywords<\/a><\/td>\nSetting Live ‘Ranked Keywords’ Tasks<\/a><\/td>\n<\/tr>\n
Get Keywords for Terms<\/a><\/td>\nSetting Live ‘Keyword Ideas’ Tasks<\/a><\/td>\n<\/tr>\n
Get SERP Competitors<\/a><\/td>\nSetting Live ‘SERP Competitors’ Tasks<\/a><\/td>\n<\/tr>\n
Get Relevant Pages<\/a><\/td>\nSetting Live ‘Relevant Pages’ Tasks<\/a><\/td>\n<\/tr>\n
Get Subdomains<\/a><\/td>\nSetting Live ‘Subdomains’ Tasks<\/a><\/td>\n<\/tr>\n
Get Competitors Domain<\/a><\/td>\nSetting Live ‘Competitors Domain’ Tasks<\/a><\/td>\n<\/tr>\n
Get Categories For Domain<\/a><\/td>\nSetting Live ‘Categories For Domain’ Tasks<\/a><\/td>\n<\/tr>\n
Get SERP Competitors<\/a><\/td>\nSetting Live ‘SERP Competitors’ Tasks<\/a><\/td>\n<\/tr>\n
Get Keywords For Categories<\/a><\/td>\nSetting Live ‘Keywords For Categories’ Tasks<\/a><\/td>\n<\/tr>\n
Get Domain Intersection<\/a><\/td>\nSetting Live ‘Domain Intersection’ Tasks<\/a><\/td>\n<\/tr>\n
List of Keywords Finder Locations<\/a><\/td>\nList of Locations and Languages for DataforSEO Labs API<\/a><\/td>\n<\/tr>\n
Reviews API<\/strong><\/td>\n<\/td>\n<\/tr>\n
Setting Google Reviews Tasks<\/a><\/td>\nSetting Google Reviews Tasks<\/a><\/td>\n<\/tr>\n
Get Google Reviews Completed Tasks<\/a><\/td>\nGet Google Reviews Completed Tasks<\/a><\/td>\n<\/tr>\n
Get Google Reviews Results by task_id<\/a><\/td>\nGet Google Reviews Results by id<\/a><\/td>\n<\/tr>\n
Merchant API<\/strong><\/td>\n<\/td>\n<\/tr>\n
Setting Google Shopping Tasks<\/a><\/td>\nSetting Google Shopping Products Tasks<\/a><\/td>\n<\/tr>\n
Get Google Shopping Completed Tasks<\/a><\/td>\nGet Google Shopping Products Completed Tasks<\/a><\/td>\n<\/tr>\n
Get Google Shopping Results by task_id<\/a><\/td>\nGet Google Shopping Products Results by id<\/a><\/td>\n<\/tr>\n
Setting Google Shopping HTML Tasks<\/a><\/td>\nSetting Google Shopping Products Tasks<\/a><\/td>\n<\/tr>\n
Get Google Shopping HTML Completed Tasks<\/a><\/td>\nGet Google Shopping Products Completed Tasks<\/a><\/td>\n<\/tr>\n
Get Google Shopping HTML Results by task_id<\/a><\/td>\nGet Google Shopping Products HTML Results by id<\/a><\/td>\n<\/tr>\n
Setting Google Shopping Sellers Tasks<\/a><\/td>\nSetting Google Shopping Sellers Tasks<\/a><\/td>\n<\/tr>\n
Get Google Shopping Sellers Completed Tasks<\/a><\/td>\nGet Google Shopping Sellers Completed Tasks<\/a><\/td>\n<\/tr>\n
Get Google Shopping Sellers Results by task_id<\/a><\/td>\nGet Google Shopping Sellers Results by id<\/a><\/td>\n<\/tr>\n
Setting Google Shopping Product Specification Tasks<\/a><\/td>\nSetting Google Shopping Product Specification Tasks<\/a><\/td>\n<\/tr>\n
Get Google Shopping Product Specification Completed Tasks<\/a><\/td>\nGet Google Shopping Product Specfication Completed Tasks<\/a><\/td>\n<\/tr>\n
Get Google Shopping Product Specification Results by task_id<\/a><\/td>\nGet Google Shopping Product Specification Results by id<\/a><\/td>\n<\/tr>\n
Get Google Shopping Sellers Ad URL<\/a><\/td>\nGet Google Shopping Sellers Ad URL<\/a><\/td>\n<\/tr>\n
Setting Amazon Tasks<\/a><\/td>\nSetting Amazon Products Tasks<\/a><\/td>\n<\/tr>\n
Get Amazon Completed Tasks<\/a><\/td>\nGet Amazon Products Completed Tasks<\/a><\/td>\n<\/tr>\n
Get Amazon Results by task_id<\/a><\/td>\nGet Amazon Products Results by id<\/a><\/td>\n<\/tr>\n
Setting Amazon HTML Tasks<\/a><\/td>\nSetting Amazon Products Tasks<\/a><\/td>\n<\/tr>\n
Get Amazon HTML Completed Tasks<\/a><\/td>\nGet Amazon Products Completed Tasks<\/a><\/td>\n<\/tr>\n
Get Amazon HTML Results by task_id<\/a><\/td>\nGet Amazon Products HTML Results by id<\/a><\/td>\n<\/tr>\n
Setting Amazon ASIN Tasks<\/a><\/td>\nSetting Amazon ASIN Tasks<\/a><\/td>\n<\/tr>\n
Get Amazon ASIN Completed Tasks<\/a><\/td>\nGet Amazon ASIN Completed Tasks<\/a><\/td>\n<\/tr>\n
Get Amazon ASIN Results by task_id<\/a><\/td>\nGet Amazon ASIN Results by id<\/a><\/td>\n<\/tr>\n<\/table>\n

Deprecated v2 endpoints<\/h2>\n


\nDataForSEO API v3 has parallels for most of the v2 functionality. There are, however, a few functions that have been deprecated. The main reason for this is that the majority of them were not popular among users. When planning your migration, you should either remove the following references from your code or implement the workarounds described here<\/a>.<\/p>\n

Deprecated \u2018List of Search Engines\u2019 endpoints for SERP API<\/strong>
\nhttps:\/\/api.dataforseo.com\/v2\/cmn_se
\nhttps:\/\/api.dataforseo.com\/v2\/cmn_se\/$country_iso_code<\/p>\n

SERP API v3 determines the search engine domain automatically according to the location and language parameters you set in the POST request.<\/em> <\/p>\n

Search Volume for Keyword<\/strong>
\nhttps:\/\/api.dataforseo.com\/v2\/kwrd_sv
\nhttps:\/\/api.dataforseo.com\/v2\/kwrd_sv_tasks_post
\nhttps:\/\/api.dataforseo.com\/v2\/kwrd_sv_tasks_get
\nhttps:\/\/api.dataforseo.com\/v2\/kwrd_sv_tasks_get\/$task_id<\/p>\n

In v3 you can get search volume for up to 700 keywords using Google Search Volume endpoints<\/a><\/em> <\/p>\n

Suggested Keywords<\/strong>
\nhttps:\/\/api.dataforseo.com\/v2\/kwrd_finder_suggest_tasks_post
\nhttps:\/\/api.dataforseo.com\/v2\/kwrd_finder_suggest_tasks_get
\nhttps:\/\/api.dataforseo.com\/v2\/kwrd_finder_suggest_tasks_get\/$task_id<\/p>\n

Ads Traffic by Platforms<\/strong>
\n https:\/\/api.dataforseo.com\/v2\/kwrd_ad_traffic_by_platforms
\nhttps:\/\/api.dataforseo.com\/v2\/kwrd_ad_traffic_by_platforms_tasks_post
\nhttps:\/\/api.dataforseo.com\/v2\/kwrd_ad_traffic_by_platforms_tasks_get
\nhttps:\/\/api.dataforseo.com\/v2\/kwrd_ad_traffic_by_platforms_tasks_get\/$task_id
\nReason: Platforms not supported in Google Ads API.<\/em>
\nAlternative: For now, there is no alternative solution.<\/em><\/p>\n

Keywords for Category<\/strong>
\nhttps:\/\/api.dataforseo.com\/v2\/kwrd_for_category
\nhttps:\/\/api.dataforseo.com\/v2\/kwrd_for_category_tasks_post
\nhttps:\/\/api.dataforseo.com\/v2\/kwrd_for_category_tasks_get
\nhttps:\/\/api.dataforseo.com\/v2\/kwrd_for_category_tasks_get\/$task_id
\nReason: Categories not supported in Google Ads API.<\/em>
\nAlternative: Keywords For Categories in DataForSEO Labs API<\/a><\/em><\/p>\n

Don’t hesitate to contact our support team if you have any questions or need assistance with the migration process.<\/strong> <\/p>\n

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

Instead of \u2018login\u2019 and \u2018password\u2019 use your credentials from https:\/\/app.dataforseo.com\/api-access<\/p><\/blockquote><\/div>","protected":false},"excerpt":{"rendered":"

[vc_row][vc_column][vc_column_text] DataForSEO v3 Migration Guide Important note for current API v2 users: As of May 5, 2026, API v2 will no longer be supported. To make sure everything keeps running smoothly, we recommend moving to API v3 ahead of that date. This guide will help you get started. Version three is designed for improving, speeding […]<\/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-3025","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/3025","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=3025"}],"version-history":[{"count":64,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/3025\/revisions"}],"predecessor-version":[{"id":23291,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/3025\/revisions\/23291"}],"wp:attachment":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/media?parent=3025"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}