DataForSEO Labs API: Your Elaborate Search Analytics Equipment
Gathering data and assessing critical keyword metrics to work out an effective SEO strategy is alike a scientific investigation. Sure enough, proper research equipment helps to achieve timely progress and remain competitive. With this in mind, we have transformed Keywords Finder API v2 into DataForSEO Labs API v3 – sophisticated equipment for setting up your own search analytics laboratory.
This article will introduce you to DataForSEO Labs API functioning. In particular, you will learn what scope of data you can receive, understand parallels between v2 and v3, explore new advanced filtering, live method of data retrieval and pricing.
Contents
2 Drawing parallels: v2 vs. v3
3 Getting specific: advanced parameters
Checking the essentials
DataForSEO Labs API will connect you with over 3 billion keywords from our in-house Keyword database and over 470 million top-100 listings from our SERPs database. When developing the API, we focused on specific purposes for which the provided data will be used. Taking that perspective, we have segmented the endpoints according to the following SEO practices:
- Keyword research
- Market-specific keyword analysis
- Competitor research
Here is an outline of each endpoint’s renewed capacities, as well as a quick overview of several common improvements.
Keyword Research
The first set of endpoints comprises three powerful keyword research algorithms, which help to identify new keyword opportunities with the highest performance potential.
Related Keywords can supply you with up to 4680 queries that contain the specified seed keyword from the “searches related to” element of Google SERP operating on the depth-first search algorithm.
Using Keyword Ideas endpoint, you can specify up to 200 seed keywords, and get the search terms that are relevant to the product or service categories of the ones you specified.
Keyword Suggestions endpoint operates on the full-text search algorithm and will provide you with a list of long-tail keywords that match the specified terms.
Each keyword in the results comes with its search volume rate for the last month, search volume trend for the previous 12 months, as well as current cost-per-click and competition values. What’s more, you will obtain broader keyword info, and what we didn’t have in the previous version, now these endpoints also provide minimum, maximum and average values of daily impressions, clicks and CPC for each term.
Market-specific keyword analysis
With this set of endpoints, you will get highly specific niche keywords.
Based on in-market categories of Google Ads, you can get keyword ideas from the relevant Categories For Domain and discover relevant Keywords For Categories.
In the new version, the latter supplies broad keyword and impressions data for each term. The former endpoint now provides estimated traffic volume based on impressions in addition to ranking distribution and estimated traffic data from organic and paid search.
Competitor research
Endpoints from the last set provide comprehensive data for getting competitive SEO insights.
You will find eight well-rounded ways to scout the competitors:
- Specify a domain and get the list of its Ranked Keywords
- Specify up to 200 keywords and find your SERP Competitors for them
- Get rankings, impressions and traffic data on competitors’ Relevant Pages and Subdomains
- Compare your and competitor’s keyword rankings through Domain Intersection
- Get a full Domain Rank Overview of a competitor’s website
- Analyze search terms both competitor domains and your domain rank for within the same SERP using Competitors Domain endpoint
- Look into the keywords several webpages rank for, or your competitor’s pages rank for but yours do not with Page Intersection endpoint
On top of that, Ranked Keywords, Page Intersection, and Domain Intersection endpoints will furnish you with a full overview of the discovered SERP elements for each keyword. Organic, paid, local pack, and featured snippet results are supported.
Drawing parallels: v2 vs. v3
First off, version three introduced a new structure of URL requests. To generally harmonize the system, we have established a standardized order of parts in the URLs used for making POST and GET API calls. Let’s compare the structure.
Here is what v2 URL looked like:
https://api.dataforseo.com/v2/kwrd_finder_subdomains_get
It comprised of:
| https | HTTPS protocol |
| api.dataforseo.com | Hostname |
| v2 | API version |
| kwrd_finder_subdomains_get | The endpoint, to which the request is made |
In the third version, the URL looks as follows:
https://api.dataforseo.com/v3/dataforseo_labs/google/subdomains/live
The structure contains:
| https | HTTPS protocol |
| api.dataforseo.com | Hostname |
| v3 | API version |
| dataforseo_labs | The name of the API to which the request is made |
| subdomains | The name of the endpoint |
| live | Type of the task that you set |
As you already know, DataForSEO Labs API is a scaled-up version of Keywords Finder API, and their functionality is generally similar.
One of the notable changes is the deprecation of the Suggested Keywords v2 endpoint. It provided keywords based on the Google Autocomplete feature. This way of finding new long-tail keywords was not popular among our users. It left you with a long keyword list to go through but failed to provide data for evaluating the outcomes.
Overall, we renamed several endpoints and added a new one. You can review the main changes in the table below:
| Renamed endpoints | Similar keywords v2 ? Keyword Suggestions v3 Keywords for terms v2 ? Keyword Ideas v3 |
| Deprecated endpoints | Suggested keywords v2 |
| New endpoints | Domain Rank Overview v3 |
Also, you will find a new endpoint that provides a full list of Google product and service categories you can use – List of Categories for DataForSEO Labs API.
The full list of parallel endpoints of Keywords Finder API and DataForSEO Labs API is provided in the ‘Core v2/v3 parallels’ table of the Migration Guide.
Getting specific: advanced parameters
With DataForSEO Labs API you can get very specific in your keyword research. First and foremost, we have introduced new advanced filtering parameters that will help you to select the best-fitting terms easier and faster.
You can set up to eight filters in one request. Each filter should be structured as follows:
[$item_array.$results_array.$parameter_field, $filter_operator, $filter_value]
Check our docs to learn more >>
1For example, you are using Keyword Suggestions endpoint to find the right terms for efficiently setting up a pay-per-click ad campaign. Sure enough, you will be looking for keywords according to specific conditions. Let’s say, your best match would be the keywords that will help you to rank in the top-4 of paid SERP, and will bring you no less than 10 daily clicks for less than $0.5 per one.
If you apply the following filters, you can get a refined list of keywords meeting these conditions:
[["impressions_info.ad_position_average","<",5],
"and",
[["impressions_info.cpc_max","<",0.5],"or",["impressions_info.daily_clicks_min",">=",10]]]
Another handy feature we have in version three is improved sorting. In one request you can apply up to three sorting rules specifying them in the order_by field. Since here we need the keywords driving the maximum possible number of clicks, the most convenient sorting will be:
[impressions_info.daily_clicks_min,desc]
2Consider another example. Imagine that we know who our biggest competitors are, we want to check what keywords work best for them. We can do exactly that with the Ranked Keywords endpoint. However, we do not need the full long list of the keywords our competitor is using. We are interested in analyzing the terms that have higher organic rankings. So, it is only logical that we need to filter out paid keywords, and those ranking beyond page one:
["ranked_serp_element.serp_item.rank_group","<",11]
"and",
[["ranked_serp_element.serp_item.type","<>","paid"],"or",["ranked_serp_element.is_paid","=",false]]]
In addition to that, we want the keywords with higher search volume and positions to appear first, so this will be our sorting rule:
[“keyword_data.keyword_info.search_volume,desc”,”ranked_serp_element.serp_item.rank_group, asc”]
As you can see, such advanced filtering and sorting rules speed up the keyword research process a lot and help to get a refined keyword list. These are just several examples of what filters and orders can be set up, but you can find multiple options meeting your specific needs in our documentation.
Working in the live mode
Both when you do SEO for a website or run an SEO software, time is what remains the key factor to success. The easier and faster you can obtain data, the more timely decisions you or your customers can make.
In view of this, we have all DataForSEO Labs API endpoints functioning in the Live mode. This means you will be provided with the results in response right after sending the necessary parameters with a POST request.
The limit is 2000 API calls per minute, however, you can contact our support team if your project requires higher rates.
Learn more about the live method >>
Estimating the prices
For many businesses, the implementation of better solutions means a higher cost for them. However, this is not the case with DataForSEO. In fact, in version three we introduced a new pricing model and reduced the cost of our APIs.
In short, unlike version two, where prices were tied to credits, in the new version you will see that prices are stated in US dollars. With this change, we managed to make the pricing more simple and straightforward.
For DataForSEO Labs API (former Keywords Finder API) in particular, with the new pricing model, the cost decreased by 6%. Note, that in version three your account will be charged for setting a task to DataForSEO Labs API ($0.01), and for each data row (item) you will receive in the results array ($0.0001). Simply put, one task that returns you 1000 items will cost $0,11.
Summing up
In general, the transformation of Keywords Finder API v2 into DataForSEO Labs API v3 is:
- Broadened scope of provided data
- Far more specific filtering and sorting options
- 6% cost decrease
DataForSEO Labs API will be your elaborate search analytics equipment, which will help to effectively conduct keyword research, market-specific keyword analysis, and competitor research. With DataForSEO, you will always get up-to-date metrics to make timely decisions. Open the door to DataForSEO Labs and check it – we offer an unlimited free trial.
TRY NOW
