NAVNavbar
Logo
php python csharp java

DataForSEO v3 Migration Guide

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.

Migrating to the new version takes four simple but essential steps:
 

1. Log into the new dashboard

 
We have created a new stand-alone account dashboard for version three. You will notice that there are two options for logging in on our website. When you click on “Login”, choose DataForSEO API v3 from the dropdown menu to get into the new version’s dashboard.

Log in >>
 

2. Upgrade your examples

 
Same 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.

Download >>
 

3. Upgrade your code

 
As 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’ve incorporated a number of new features and improved the overall usability of the API from the developer’s standpoint.

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.

DataForSEO v3 Release: Doubling Down on Developer Experience >>
 

4. Test and iterate

 
When you log into your new account for the first time, you will receive $1 for testing DataForSEO v3.

You can also use the free Sandbox feature to facilitate the migration process.

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.

Key improvements for a developer

Improvement Reference Notes
Standardized error/status codes and messages read more
status/error codes
Version 3 has a new, standardized set of error and status codes.
Streamlined URL structure of API calls read more URLs of the API endpoints now reflect its core parameters and functions.
Simple task identifiers read more All the parameters that you specified in the POST request are now reflected in the data array of API responses. You can also use the custom task identifier tag to match posted tasks with the returned results.
New pricing model read more
pricing
We reduced the prices and tied them to the US dollar.

New concepts

Concept Parent API Notes
Retrieving website rankings with SERP API SERP API You can get website rankings by filtering out relevant SERP results
read more
SERP functions in the GET request SERP API Your account will be charged for POST requests only.
By sending GET requests to Organic, Advanced and HTML endpoints,
you will get all three formats of the requested SERP at no additional cost
New search engine types SERP API Google Organic/Maps/News/Images;
Bing Organic/Local Pack;
Yahoo Organic;
Yandex Organic
Device & OS SERP API windows and macos for desktop
android and ios for mobile
Location coordinates SERP API, Keywords Data API You can get data for a particular location by specifying its GPS coordinates
in the location_coordinate field
Bulk-only search volume Keywords Data API You can get search volume for up to 700 keywords,
the price for one or 700 keywords will be the same

Core v2/v3 parallels

v2 property v3 equivalent
SERP API
Live SERP Live Google Organic SERP Regular
Setting SERP Tasks Setting Google Organic SERP Tasks
Get SERP Completed Tasks Get Organic SERP Completed Tasks
Get SERP Results by task_id Get Google Organic SERP Results by id
Setting SERP HTML Tasks Setting Google Organic SERP Tasks
Get SERP HTML Completed Tasks Get Organic SERP Completed Tasks
Get SERP HTML Results by task_id Get Google Organic HTML Results by id
Live Extra SERP Live Google Organic SERP Advanced
Setting Extra SERP Tasks Setting Google Organic SERP Tasks
Get Extra SERP Completed Tasks Get Organic SERP Completed Tasks
Get Extra SERP Results by task_id Get Google Organic SERP Advanced Results by id
Setting Google Images Tasks Setting Google Images SERP Tasks
Get Google Images Completed Tasks Get Images SERP Completed Tasks
Get Google Images Results by task_id Get Google Images SERP Results by id
List of Locations List of Google Locations for SERP
Keywords Data API
Bulk Keyword Search Volume – Live Setting Live ‘Search Volume’ Tasks
Bulk Keyword Search Volume – Set Task Setting ‘Search Volume’ Tasks
Bulk Keyword Search Volume – Get Completed Tasks Get ‘Search Volume’ Completed Tasks
Bulk Keyword Search Volume – Get Results by task_id Get ‘Search Volume’ Results by id
Keywords for Domain – Live Setting Live ‘Keywords For Site’ Tasks
Keywords for Domain – Set Task Setting ‘Keywords For Site’ Tasks
Keywords for Domain – Get Completed Tasks Get ‘Keywords For Site’ Completed Tasks
Keywords for Domain – Get Results by task_id Get ‘Keywords For Site’ Results by id
Keywords for Keywords – Live Data Setting Live ‘Keywords For Keywords’ Tasks
Keywords for Keywords – Set Task Setting ‘Keywords For Keywords’ Tasks
Keywords for Keywords – Get Completed Tasks Get ‘Keywords For Keywords’ Completed Tasks
Keywords for Keywords – Get Results by task_id Get ‘Keywords For Keywords’ Results by id
Keywords for Category – Live Data Setting Live ‘Keywords For Category’ Tasks
Keywords for Category – Set Task Setting ‘Keywords For Category’ Tasks
Keywords for Category – Get Completed Tasks Get ‘Keywords For Category’ Completed Tasks
Keywords for Category – Get Results by task_id Get ‘Keywords For Category’ Results by id
Ads Traffic for Keywords – Live Data Setting Live ‘Ads Traffic By Keywords’ Tasks
Ads Traffic for Keywords – Set Task Setting ‘Ads Traffic By Keywords’ Tasks
Ads Traffic for Keywords – Get Completed Tasks Get ‘Ads Traffic By Keywords’ Completed Tasks
Ads Traffic for Keywords – Get Results by task_id Get ‘Ads Traffic By Keywords’ Results by id
Ads Traffic by Platforms – Live Data Setting Live ‘Ads Traffic By Platforms’ Tasks
Ads Traffic by Platforms – Set Task Setting ‘Ads Traffic By Platforms’ Tasks
Ads Traffic by Platforms – Get Completed Tasks Get ‘Ads Traffic By Platforms’ Completed Tasks
Ads Traffic by Platforms – Get Results by task_id Get ‘Ads Traffic By Platforms’ Results by id
Traffic Analytics API
Competitor Info Live SimilarWeb Traffic Analytics
DataForSEO Labs API
Get Related Keywords Setting Live ‘Related Keywords’ Tasks
Get Similar Keywords Setting Live ‘Keyword Suggestions’ Tasks
Get Ranked Keywords Setting Live ‘Ranked Keywords’ Tasks
Get Keywords for Terms Setting Live ‘Keyword Ideas’ Tasks
Get SERP Competitors Setting Live ‘SERP Competitors’ Tasks
Get Relevant Pages Setting Live ‘Relevant Pages’ Tasks
Get Subdomains Setting Live ‘Subdomains’ Tasks
Get Competitors Domain Setting Live ‘Competitors Domain’ Tasks
Get Categories For Domain Setting Live ‘Categories For Domain’ Tasks
Get SERP Competitors Setting Live ‘SERP Competitors’ Tasks
Get Keywords For Categories Setting Live ‘Keywords For Categories’ Tasks
Get Ranked Domains By Category Setting Live ‘Ranked Domains by Category’ Tasks
Get Domain Intersection Setting Live ‘Domain Intersection’ Tasks
List of Keywords Finder Locations List of Locations and Languages for DataforSEO Labs API
Reviews API
Setting Google Reviews Tasks Setting Google Reviews Tasks
Get Google Reviews Completed Tasks Get Google Reviews Completed Tasks
Get Google Reviews Results by task_id Get Google Reviews Results by id
Merchant API
Setting Google Shopping Tasks Setting Google Shopping Products Tasks
Get Google Shopping Completed Tasks Get Google Shopping Products Completed Tasks
Get Google Shopping Results by task_id Get Google Shopping Products Results by id
Setting Google Shopping HTML Tasks Setting Google Shopping Products Tasks
Get Google Shopping HTML Completed Tasks Get Google Shopping Products Completed Tasks
Get Google Shopping HTML Results by task_id Get Google Shopping Products HTML Results by id
Setting Google Shopping Sellers Tasks Setting Google Shopping Sellers Tasks
Get Google Shopping Sellers Completed Tasks Get Google Shopping Sellers Completed Tasks
Get Google Shopping Sellers Results by task_id Get Google Shopping Sellers Results by id
Setting Google Shopping Product Specification Tasks Setting Google Shopping Product Specification Tasks
Get Google Shopping Product Specification Completed Tasks Get Google Shopping Product Specfication Completed Tasks
Get Google Shopping Product Specification Results by task_id Get Google Shopping Product Specification Results by id
Get Google Shopping Sellers Ad URL Get Google Shopping Sellers Ad URL
Setting Amazon Tasks Setting Amazon Products Tasks
Get Amazon Completed Tasks Get Amazon Products Completed Tasks
Get Amazon Results by task_id Get Amazon Products Results by id
Setting Amazon HTML Tasks Setting Amazon Products Tasks
Get Amazon HTML Completed Tasks Get Amazon Products Completed Tasks
Get Amazon HTML Results by task_id Get Amazon Products HTML Results by id
Setting Amazon ASIN Tasks Setting Amazon ASIN Tasks
Get Amazon ASIN Completed Tasks Get Amazon ASIN Completed Tasks
Get Amazon ASIN Results by task_id Get Amazon ASIN Results by id

Deprecated v2 endpoints


DataForSEO 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.

Deprecated ‘List of Search Engines’ endpoints for SERP API
https://api.dataforseo.com/v2/cmn_se
https://api.dataforseo.com/v2/cmn_se/$country_iso_code

SERP API v3 determines the search engine domain automatically according to the location and language parameters you set in the POST request.

Search Volume for Keyword
https://api.dataforseo.com/v2/kwrd_sv
https://api.dataforseo.com/v2/kwrd_sv_tasks_post
https://api.dataforseo.com/v2/kwrd_sv_tasks_get
https://api.dataforseo.com/v2/kwrd_sv_tasks_get/$task_id

In v3 you can get search volume for up to 700 keywords using Google Search Volume endpoints

Suggested Keywords
https://api.dataforseo.com/v2/kwrd_finder_suggest_tasks_post
https://api.dataforseo.com/v2/kwrd_finder_suggest_tasks_get
https://api.dataforseo.com/v2/kwrd_finder_suggest_tasks_get/$task_id

Don’t hesitate to contact our support team if you have any questions or need assistance with the migration process.