version |
string |
the current version of the API |
status_code |
integer |
general status code
you can find the full list of the response codes here
Note: we strongly recommend designing a necessary system for handling related exceptional or error conditions |
status_message |
string |
general informational message
you can find the full list of general informational messages here |
time |
string |
execution time, seconds |
cost |
float |
total tasks cost, USD |
tasks_count |
integer |
the number of tasks in the tasks array |
tasks_error |
integer |
the number of tasks in the tasks array returned with an error |
tasks |
array |
array of tasks |
id |
string |
task identifier
unique task identifier in our system in the UUID format |
status_code |
integer |
status code of the task
generated by DataForSEO; can be within the following range: 10000-60000
you can find the full list of the response codes here |
status_message |
string |
informational message of the task
you can find the full list of general informational messages here |
time |
string |
execution time, seconds |
cost |
float |
cost of the task, USD |
result_count |
integer |
number of elements in the result array |
path |
array |
URL path |
data |
object |
contains the same parameters that you specified in the POST request |
result |
array |
array of results |
se_type |
string |
search engine type |
target |
string |
target domain in a POST array |
location_code |
integer |
location code in a POST array
if there is no data, then the value is null |
language_code |
string |
language code in a POST array
if there is no data, then the value is null |
total_count |
integer |
total number of results in our database relevant to your request |
items_count |
integer |
the number of results returned in the items array |
metrics |
object |
ranking data relevant to the specified domain
ranking data is provided by the rank_group parameters that show the result’s rank considering only equivalent SERP elements |
organic |
object |
ranking and traffic data from organic search |
pos_1 |
integer |
number of organic SERPs where the domain ranks #1 |
pos_2_3 |
integer |
number of organic SERPs where the domain ranks #2-3 |
pos_4_10 |
integer |
number of organic SERPs where the domain ranks #4-10 |
pos_11_20 |
integer |
number of organic SERPs where the domain ranks #11-20 |
pos_21_30 |
integer |
number of organic SERPs where the domain ranks #21-30 |
pos_31_40 |
integer |
number of organic SERPs where the domain ranks #31-40 |
pos_41_50 |
integer |
number of organic SERPs where the domain ranks #41-50 |
pos_51_60 |
integer |
number of organic SERPs where the domain ranks #51-60 |
pos_61_70 |
integer |
number of organic SERPs where the domain ranks #61-70 |
pos_71_80 |
integer |
number of organic SERPs where the domain ranks #71-80 |
pos_81_90 |
integer |
number of organic SERPs where the domain ranks #81-90 |
pos_91_100 |
integer |
number of organic SERPs where the domain ranks #91-100 |
etv |
float |
estimated traffic volume
estimated organic monthly traffic to the domain
calculated as the product of CTR (click-through-rate) and search volume values of all keywords the domain ranks for
learn more about how the metric is calculated in this help center article |
count |
integer |
total count of organic SERPs that contain the domain |
estimated_paid_traffic_cost |
float |
estimated cost of converting organic search traffic into paid
represents the estimated monthly cost of running ads for all keywords that a domain ranks for
the metric is calculated as the product of organic etv and paid cpc values and indicates the cost of driving the estimated volume of monthly organic traffic through PPC advertising in Bing Search
learn more about how the metric is calculated in this help center article |
is_new |
integer |
number of new ranked elements
indicates how many new ranked elements were found for this domain
|
is_up |
integer |
rank went up
indicates how many ranked elements of this domain went up in Bing Search
|
is_down |
integer |
rank went down
indicates how many ranked elements of this domain went down in Bing Search
|
is_lost |
integer |
lost ranked elements
indicates how many ranked elements of this domain were previously presented in SERPs, but weren’t found during the last check
|
paid |
object |
ranking and traffic data from paid search |
pos_1 |
integer |
number of paid SERPs where the domain ranks #1 |
pos_2_3 |
integer |
number of paid SERPs where the domain ranks #2-3 |
pos_4_10 |
integer |
number of paid SERPs where the domain ranks #4-10 |
pos_11_20 |
integer |
number of paid SERPs where the domain ranks #11-20 |
pos_21_30 |
integer |
number of paid SERPs where the domain ranks #21-30 |
pos_31_40 |
integer |
number of paid SERPs where the domain ranks #31-40 |
pos_41_50 |
integer |
number of paid SERPs where the domain ranks #41-50 |
pos_51_60 |
integer |
number of paid SERPs where the domain ranks #51-60 |
pos_61_70 |
integer |
number of paid SERPs where the domain ranks #61-70 |
pos_71_80 |
integer |
number of paid SERPs where the domain ranks #71-80 |
pos_81_90 |
integer |
number of paid SERPs where the domain ranks #81-90 |
pos_91_100 |
integer |
number of paid SERPs where the domain ranks #91-100 |
etv |
float |
estimated traffic volume
estimated paid monthly traffic to the domain
calculated as the product of CTR (click-through-rate) and search volume values of all keywords the domain ranks for
learn more about how the metric is calculated in this help center article |
count |
integer |
total count of paid SERPs that contain the domain |
estimated_paid_traffic_cost |
float |
estimated cost of monthly search traffic
represents the estimated cost of paid monthly traffic based on etv and cpc values
learn more about how the metric is calculated in this help center article |
is_new |
integer |
number of new ranked elements
indicates how many new ranked elements were found for this domain
|
is_up |
integer |
rank went up
indicates how many ranked elements of this domain went up in Bing Search
|
is_down |
integer |
rank went down
indicates how many ranked elements of this domain went down in Bing Search
|
is_lost |
integer |
lost ranked elements
indicates how many ranked elements of this domain were previously presented in SERPs, but weren’t found during the last check
|
featured_snippet |
object |
ranking and traffic data from the featured snippet results in Bing SERP |
pos_1 |
integer |
number of featured snippet items where the domain ranks #1 |
pos_2_3 |
integer |
number of featured snippet items where the domain ranks #2-3 |
pos_4_10 |
integer |
number of featured snippet items where the domain ranks #4-10 |
pos_11_20 |
integer |
number of featured snippet items where the domain ranks #11-20 |
pos_21_30 |
integer |
number of featured snippet items where the domain ranks #21-30 |
pos_31_40 |
integer |
number of featured snippet items where the domain ranks #31-40 |
pos_41_50 |
integer |
number of featured snippet items where the domain ranks #41-50 |
pos_51_60 |
integer |
number of featured snippet items where the domain ranks #51-60 |
pos_61_70 |
integer |
number of featured snippet items where the domain ranks #61-70 |
pos_71_80 |
integer |
number of featured snippet items where the domain ranks #71-80 |
pos_81_90 |
integer |
number of featured snippet items where the domain ranks #81-90 |
pos_91_100 |
integer |
number of featured snippet items where the domain ranks #91-100 |
etv |
float |
estimated traffic volume
estimated paid monthly traffic to the domain
calculated as the product of CTR (click-through-rate) and search volume values of all keywords in the category that the domain ranks for
learn more about how the metric is calculated in this help center article |
count |
integer |
total count of featured snippet items that contain the domain |
estimated_paid_traffic_cost |
float |
estimated cost of monthly search traffic
represents the estimated cost of paid monthly traffic (USD) based on etv and cpc values of all keywords in the category that the domain ranks for
learn more about how the metric is calculated in this help center article |
is_new |
integer |
number of new ranked elements
indicates how many new ranked elements were found for the indicated target
|
is_up |
integer |
rank went up
indicates how many ranked elements of the indicated target went up
|
is_down |
integer |
rank went down
indicates how many ranked elements of the indicated target went down
|
is_lost |
integer |
lost ranked elements
indicates how many ranked elements of the indicated target were previously presented in SERPs, but weren’t found during the last check
|
local_pack |
object |
ranking and traffic data from the local pack results in SERP |
pos_1 |
integer |
number of local pack items where the domain ranks #1 |
pos_2_3 |
integer |
number of local pack items where the domain ranks #2-3 |
pos_4_10 |
integer |
number of local pack items where the domain ranks #4-10 |
pos_11_20 |
integer |
number of local pack items where the domain ranks #11-20 |
pos_21_30 |
integer |
number of local pack items where the domain ranks #21-30 |
pos_31_40 |
integer |
number of local pack items where the domain ranks #31-40 |
pos_41_50 |
integer |
number of local pack items where the domain ranks #41-50 |
pos_51_60 |
integer |
number of local pack items where the domain ranks #51-60 |
pos_61_70 |
integer |
number of local pack items where the domain ranks #61-70 |
pos_71_80 |
integer |
number of local pack items where the domain ranks #71-80 |
pos_81_90 |
integer |
number of local pack items where the domain ranks #81-90 |
pos_91_100 |
integer |
number of local pack items where the domain ranks #91-100 |
etv |
float |
estimated traffic volume
estimated paid monthly traffic to the domain
calculated as the product of CTR (click-through-rate) and search volume values of all keywords in the category that the domain ranks for
learn more about how the metric is calculated in this help center article |
count |
integer |
total count of local pack items that contain the domain |
estimated_paid_traffic_cost |
float |
estimated cost of monthly search traffic
represents the estimated cost of paid monthly traffic (USD) based on etv and cpc values of all keywords in the category that the domain ranks for
learn more about how the metric is calculated in this help center article |
is_new |
integer |
number of new ranked elements
indicates how many new ranked elements were found for the indicated target
|
is_up |
integer |
rank went up
indicates how many ranked elements of the indicated target went up
|
is_down |
integer |
rank went down
indicates how many ranked elements of the indicated target went down
|
is_lost |
integer |
lost ranked elements
indicates how many ranked elements of the indicated target were previously presented in SERPs, but weren’t found during the last check
|
metrics_absolute |
object |
ranking data relevant to the specified domain
ranking data is provided by the rank_absolute parameters that indicate the result’s position among all SERP elements
|
organic |
array |
ranking data from organic search |
pos_1 |
integer |
number of organic SERPs where the domain ranks #1 |
pos_2_3 |
integer |
number of organic SERPs where the domain ranks #2-3 |
pos_4_10 |
integer |
number of organic SERPs where the domain ranks #4-10 |
pos_11_20 |
integer |
number of organic SERPs where the domain ranks #11-20 |
pos_21_30 |
integer |
number of organic SERPs where the domain ranks #21-30 |
pos_31_40 |
integer |
number of organic SERPs where the domain ranks #31-40 |
pos_41_50 |
integer |
number of organic SERPs where the domain ranks #41-50 |
pos_51_60 |
integer |
number of organic SERPs where the domain ranks #51-60 |
pos_61_70 |
integer |
number of organic SERPs where the domain ranks #61-70 |
pos_71_80 |
integer |
number of organic SERPs where the domain ranks #71-80 |
pos_81_90 |
integer |
number of organic SERPs where the domain ranks #81-90 |
pos_91_100 |
integer |
number of organic SERPs where the domain ranks #91-100 |
is_new |
integer |
number of new ranked elements
indicates how many new ranked elements were found for this domain
|
is_up |
integer |
rank went up
indicates how many ranked elements of this domain went up in Bing Search
|
is_down |
integer |
rank went down
indicates how many ranked elements of this domain went down in Bing Search
|
is_lost |
integer |
lost ranked elements
indicates how many ranked elements of this domain were previously presented in SERPs, but weren’t found during the last check
|
paid |
array |
ranking data from paid search |
pos_1 |
integer |
number of paid SERPs where the domain ranks #1 |
pos_2_3 |
integer |
number of paid SERPs where the domain ranks #2-3 |
pos_4_10 |
integer |
number of paid SERPs where the domain ranks #4-10 |
pos_11_20 |
integer |
number of paid SERPs where the domain ranks #11-20 |
pos_21_30 |
integer |
number of paid SERPs where the domain ranks #21-30 |
pos_31_40 |
integer |
number of paid SERPs where the domain ranks #31-40 |
pos_41_50 |
integer |
number of paid SERPs where the domain ranks #41-50 |
pos_51_60 |
integer |
number of paid SERPs where the domain ranks #51-60 |
pos_61_70 |
integer |
number of paid SERPs where the domain ranks #61-70 |
pos_71_80 |
integer |
number of paid SERPs where the domain ranks #71-80 |
pos_81_90 |
integer |
number of paid SERPs where the domain ranks #81-90 |
pos_91_100 |
integer |
number of paid SERPs where the domain ranks #91-100 |
is_new |
integer |
number of new ranked elements
indicates how many new ranked elements were found for this domain
|
is_up |
integer |
rank went up
indicates how many ranked elements of this domain went up in Bing Search
|
is_down |
integer |
rank went down
indicates how many ranked elements of this domain went down in Bing Search
|
is_lost |
integer |
lost ranked elements
indicates how many ranked elements of this domain were previously presented in SERPs, but weren’t found during the last check
|
featured_snippet |
array |
ranking and traffic data from the featured snippet results in Bing SERP |
pos_1 |
integer |
number of featured snippet items where the domain ranks #1 |
pos_2_3 |
integer |
number of featured snippet items where the domain ranks #2-3 |
pos_4_10 |
integer |
number of featured snippet items where the domain ranks #4-10 |
pos_11_20 |
integer |
number of featured snippet items where the domain ranks #11-20 |
pos_21_30 |
integer |
number of featured snippet items where the domain ranks #21-30 |
pos_31_40 |
integer |
number of featured snippet items where the domain ranks #31-40 |
pos_41_50 |
integer |
number of featured snippet items where the domain ranks #41-50 |
pos_51_60 |
integer |
number of featured snippet items where the domain ranks #51-60 |
pos_61_70 |
integer |
number of featured snippet items where the domain ranks #61-70 |
pos_71_80 |
integer |
number of featured snippet items where the domain ranks #71-80 |
pos_81_90 |
integer |
number of featured snippet items where the domain ranks #81-90 |
pos_91_100 |
integer |
number of featured snippet items where the domain ranks #91-100 |
etv |
float |
estimated traffic volume
estimated paid monthly traffic to the domain
calculated as the product of CTR (click-through-rate) and search volume values of all keywords in the category that the domain ranks for
learn more about how the metric is calculated in this help center article |
count |
integer |
total count of featured snippet items that contain the domain |
estimated_paid_traffic_cost |
float |
estimated cost of monthly search traffic
represents the estimated cost of paid monthly traffic (USD) based on etv and cpc values of all keywords in the category that the domain ranks for
learn more about how the metric is calculated in this help center article |
is_new |
integer |
number of new ranked elements
indicates how many new ranked elements were found for the indicated target
|
is_up |
integer |
rank went up
indicates how many ranked elements of the indicated target went up
|
is_down |
integer |
rank went down
indicates how many ranked elements of the indicated target went down
|
is_lost |
integer |
lost ranked elements
indicates how many ranked elements of the indicated target were previously presented in SERPs, but weren’t found during the last check
|
local_pack |
array |
ranking and traffic data from the local pack results in SERP |
pos_1 |
integer |
number of local pack items where the domain ranks #1 |
pos_2_3 |
integer |
number of local pack items where the domain ranks #2-3 |
pos_4_10 |
integer |
number of local pack items where the domain ranks #4-10 |
pos_11_20 |
integer |
number of local pack items where the domain ranks #11-20 |
pos_21_30 |
integer |
number of local pack items where the domain ranks #21-30 |
pos_31_40 |
integer |
number of local pack items where the domain ranks #31-40 |
pos_41_50 |
integer |
number of local pack items where the domain ranks #41-50 |
pos_51_60 |
integer |
number of local pack items where the domain ranks #51-60 |
pos_61_70 |
integer |
number of local pack items where the domain ranks #61-70 |
pos_71_80 |
integer |
number of local pack items where the domain ranks #71-80 |
pos_81_90 |
integer |
number of local pack items where the domain ranks #81-90 |
pos_91_100 |
integer |
number of local pack items where the domain ranks #91-100 |
etv |
float |
estimated traffic volume
estimated paid monthly traffic to the domain
calculated as the product of CTR (click-through-rate) and search volume values of all keywords in the category that the domain ranks for
learn more about how the metric is calculated in this help center article |
count |
integer |
total count of local pack items that contain the domain |
estimated_paid_traffic_cost |
float |
estimated cost of monthly search traffic
represents the estimated cost of paid monthly traffic (USD) based on etv and cpc values of all keywords in the category that the domain ranks for
learn more about how the metric is calculated in this help center article |
is_new |
integer |
number of new ranked elements
indicates how many new ranked elements were found for the indicated target
|
is_up |
integer |
rank went up
indicates how many ranked elements of the indicated target went up
|
is_down |
integer |
rank went down
indicates how many ranked elements of the indicated target went down
|
is_lost |
integer |
lost ranked elements
indicates how many ranked elements of the indicated target were previously presented in SERPs, but weren’t found during the last check
|
items |
array |
contains ranked keywords and related data |
keyword_data |
array |
keyword data for the returned keyword |
se_type |
string |
search engine type |
keyword |
string |
returned keyword |
location_code |
integer |
location code in a POST array |
language_code |
integer |
language code in a POST array |
keyword_info |
array |
keyword data for the returned keyword |
se_type |
string |
search engine type |
last_updated_time |
string |
date and time when keyword data was updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00 |
competition |
float |
competition
represents the relative amount of competition associated with the given keyword
this value is based on Bing Ads data and can be between 0 and 1 (inclusive)
if there is no data the value is null |
cpc |
float |
cost-per-click
represents the average cost per click (USD) historically paid for the keyword
if there is no data then the value is null |
search_volume |
integer |
average monthly search volume rate
represents the (approximate) number of searches for the given keyword on bing.com
if there is no data then the value is null |
monthly_searches |
array |
monthly searches
represents the (approximate) number of searches on this keyword (as available for the past twelve months), targeted to the specified geographic locations
if there is no data then the value is null |
year |
integer |
year |
month |
integer |
month |
search_volume |
integer |
monthly average search volume rate |
keyword_properties |
object |
additional information about the keyword |
se_type |
string |
search engine type |
core_keyword |
string |
main keyword in a group
contains the main keyword in a group determined by the synonym clustering algorithm
if the value is null, our database does not contain any keywords the corresponding algorithm could identify as synonymous with keyword |
synonym_clustering_algorithm |
string |
the algorithm used to identify synonyms
possible values:
keyword_metrics – indicates the algorithm based on keyword_info parameters
text_processing – indicates the text-based algorithm
if the value is null, our database does not contain any keywords the corresponding algorithm could identify as synonymous with keyword |
keyword_difficulty |
integer |
difficulty of ranking in the first top-10 organic results for a keyword
indicates the chance of getting in top-10 organic results for a keyword on a logarithmic scale from 0 to 100;
calculated by analysing, among other parameters, link profiles of the first 10 pages in SERP;
learn more about the metric in this help center guide |
detected_language |
string |
detected language of the keyword
indicates the language of the keyword as identified by our system
|
is_another_language |
boolean |
detected language of the keyword is different from the set language
if true, the language set in the request does not match the language determined by our system for a given keyword
|
serp_info |
array |
SERP data
|
se_type |
string |
search engine type |
check_url |
string |
direct URL to search engine results
you can use it to make sure that we provided accurate results |
serp_item_types |
array |
types of search results in SERP
contains types of search results (items) found in SERP
possible item types:
answer_box, carousel, events, featured_snippet, hotels_pack, images, jobs, local_pack, map, organic, paid, people_also_ask, people_also_search,questions_and_answers, recipes, related_searches, shopping, top_stories, video, ai_overview;
note that the actual results will be returned only for organic, paid, featured_snippet, and local_pack elements |
se_results_count |
string |
number of search results for the returned keyword |
keyword_difficulty |
integer |
difficulty of ranking in the first top-10 organic results for a keyword
indicates the chance of getting in top-10 organic results for a keyword on a logarithmic scale from 0 to 100;
calculated by analysing, among other parameters, link profiles of the first 10 pages in SERP |
last_updated_time |
string |
date and time when SERP data was updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00 |
previous_updated_time |
string |
previous to the most recent date and time when SERP data was updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-10-15 12:57:46 +00:00 |
avg_backlinks_info |
object |
backlink data for the returned keyword
this object provides the average number of backlinks, referring pages and domains, as well as the average rank values among the top-10 websites ranking organically for the keyword |
se_type |
string |
search engine type
|
backlinks |
float |
average number of backlinks
|
dofollow |
float |
average number of dofollow links
|
referring_pages |
float |
average number of referring pages
|
referring_domains |
float |
average number of referring domains
|
referring_main_domains |
float |
average number of referring main domains
|
rank |
float |
average rank
learn more about the metric and its calculation formula in this help center article
|
main_domain_rank |
float |
average main domain rank
learn more about the metric and its calculation formula in this help center article
|
last_updated_time |
string |
date and time when backlink data was updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00 |
ranked_serp_element |
array |
contains data on the domain’s SERP element found for the returned keyword |
se_type |
string |
search engine type |
serp_item |
array |
contains data on the SERP element
the list of supported SERP elements can be found below |
se_type |
string |
search engine type |
| ‘organic’ element in SERP |
|
|
type |
string |
type of element = ‘organic’ |
rank_group |
integer |
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group |
rank_absolute |
integer |
absolute rank in SERP
absolute position among all the elements in SERP |
position |
string |
the alignment of the element in SERP
can take the following values:
left, right |
xpath |
string |
the XPath of the element |
domain |
string |
subdomain in SERP |
title |
string |
title of the result in SERP |
url |
string |
relevant URL in SERP |
breadcrumb |
string |
breadcrumb in SERP |
is_image |
boolean |
indicates whether the element contains an image |
is_video |
boolean |
indicates whether the element contains a video |
is_featured_snippet |
boolean |
indicates whether the element is a featured_snippet |
is_malicious |
boolean |
indicates whether the element is marked as malicious |
description |
string |
description of the results element in SERP |
pre_snippet |
string |
includes additional information appended before the result description in SERP |
extended_snippet |
string |
includes additional information appended after the result description in SERP |
amp_version |
boolean |
Accelerated Mobile Pages
indicates whether an item has the Accelerated Mobile Page (AMP) version |
rating |
object |
the item’s rating
the popularity rate based on reviews and displayed in SERP |
rating_type |
string |
the type of rating
here you can find the following elements: Max5, Percents, CustomMax |
value |
integer |
the value of the rating |
votes_count |
integer |
the amount of feedback |
rating_max |
integer |
the maximum value for a rating_type |
highlighted |
array |
words highlighted in bold within the results description |
links |
array |
sitelinks
the links shown below some of Google’s search results
if there are none, equals null |
type |
string |
type of element = ‘link_element‘ |
title |
string |
title of the result in SERP |
description |
string |
description of the results element in SERP |
url |
string |
sitelink URL |
main_domain |
string |
primary domain name in SERP |
relative_url |
string |
URL in SERP that does not specify the HTTPs protocol and domain name |
etv |
float |
estimated traffic volume
estimated organic monthly traffic to the domain
calculated as the product of CTR (click-through-rate) and search volume values of the returned keyword
learn more about how the metric is calculated in this help center article |
estimated_paid_traffic_cost |
float |
estimated cost of converting organic search traffic into paid
represents the estimated monthly cost of running ads for the returned keyword
the metric is calculated as the product of organic etv and paid cpc values and indicates the cost of driving the estimated volume of monthly organic traffic through PPC advertising in Google Search
learn more about how the metric is calculated in this help center article |
rank_changes |
array |
changes in rankings
contains information about the ranking changes of the SERP element since the previous_updated_time
|
previous_rank_absolute |
integer |
previous absolute rank in SERP
indicates previous rank of the element in Google SERP;
if this element is new, the value will be null
|
is_new |
boolean |
element was previously present in SERP
if the value is true, previously collected SERP didn’t contain this element
|
is_up |
boolean |
rank of this element went up
if the value is true, position of the element in SERP is higher compared to the previous check
|
is_down |
boolean |
rank of this element went down
if the value is true, position of the element in SERP is lower compared to the previous check
|
backlinks_info |
object |
backlinks information for the target website
|
referring_domains |
integer |
number of referring domains
referring domains include subdomains that are counted as separate domains for this metric
|
referring_main_domains |
integer |
number of referring main domains
|
referring_pages |
integer |
number of pages pointing to the target website
|
dofollow |
integer |
number of dofollow links
|
backlinks |
integer |
total number of backlinks
the total number of backlinks, including dofollow and nofollow links
|
time_update |
string |
date and time when backlink data was updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”;
example:
2019-11-15 12:57:46 +00:00 |
rank_info |
object |
page and domain rank information
|
page_rank |
integer |
page rank
page_rank is calculated based on the method for node ranking in a linked database – a principle used in the original Google PageRank algorithm;
learn more about the metric and how it is calculated in this help center article |
main_domain_rank |
integer |
main domain rank
main_domain_rank is calculated based on the method for node ranking in a linked database – a principle used in the original Google PageRank algorithm
learn more about the metric and how it is calculated in this help center article |
| ‘paid’ element in SERP |
|
|
type |
string |
type of element = ‘paid’ |
rank_group |
integer |
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group |
rank_absolute |
integer |
absolute rank in SERP
absolute position among all the elements in SERP |
position |
string |
the alignment of the element in SERP
can take the following values:
left, right |
xpath |
string |
the XPath of the element |
title |
string |
title of the result in SERP |
domain |
string |
domain in SERP of the Ad element |
description |
string |
description of the results element in SERP |
breadcrumb |
string |
breadcrumb of the Ad element in SERP |
url |
string |
relevant URL of the Ad element in SERP |
highlighted |
array |
words highlighted in bold within the results description |
extra |
object |
additional information about the result |
ad_aclk |
string |
the identifier of the ad |
description_rows |
array |
extended description
if there is none, equals null |
links |
array |
sitelinks
the links shown below some of Google’s search results
if there are none, equals null |
type |
string |
type of element = ‘ad_link_element‘ |
title |
string |
title of the link element |
description |
string |
description of the results element in SERP |
url |
string |
URL link |
ad_aclk |
string |
the identifier of the ad |
main_domain |
string |
primary domain name in SERP |
relative_url |
string |
URL in SERP that does not specify the HTTPs protocol and domain name |
etv |
float |
estimated traffic volume
estimated organic monthly traffic to the domain
calculated as the product of CTR (click-through-rate) and search volume values of the returned keyword
learn more about how the metric is calculated in this help center article |
estimated_paid_traffic_cost |
float |
estimated cost of paid monthly search traffic
represents the estimated cost of paid monthly traffic based on etv and cpc values
learn more about how the metric is calculated in this help center article |
rank_changes |
array |
changes in rankings
contains information about the ranking changes of the SERP element since the previous_updated_time
|
previous_rank_absolute |
integer |
previous absolute rank in SERP
indicates previous rank of the element in Google SERP;
if this element is new, the value will be null
|
is_new |
boolean |
element was previously present in SERP
if the value is true, previously collected SERP didn’t contain this element
|
is_up |
boolean |
rank of this element went up
if the value is true, position of the element in SERP is higher compared to the previous check
|
is_down |
boolean |
rank of this element went down
if the value is true, position of the element in SERP is lower compared to the previous check
|
backlinks_info |
object |
backlinks information for the target website
|
referring_domains |
integer |
number of referring domains
referring domains include subdomains that are counted as separate domains for this metric
|
referring_main_domains |
integer |
number of referring main domains
|
referring_pages |
integer |
number of pages pointing to the target website
|
dofollow |
integer |
number of dofollow links
|
backlinks |
integer |
total number of backlinks
the total number of backlinks, including dofollow and nofollow links
|
time_update |
string |
date and time when backlink data was updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”;
example:
2019-11-15 12:57:46 +00:00 |
rank_info |
object |
page and domain rank information
|
page_rank |
integer |
page rank
page_rank is calculated based on the method for node ranking in a linked database – a principle used in the original Google PageRank algorithm;
learn more about the metric and how it is calculated in this help center article |
main_domain_rank |
integer |
main domain rank
main_domain_rank is calculated based on the method for node ranking in a linked database – a principle used in the original Google PageRank algorithm
learn more about the metric and how it is calculated in this help center article |
| ‘local_pack’ element in SERP |
|
|
type |
string |
type of element = ‘local_pack’ |
rank_group |
integer |
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group |
rank_absolute |
integer |
absolute rank in SERP
absolute position among all the elements in SERP |
position |
string |
the alignment of the element in SERP
can take the following values:
left, right |
xpath |
string |
the XPath of the element |
title |
string |
title of the result in SERP |
description |
string |
description of the results element in SERP |
domain |
string |
domain in SERP |
phone |
string |
phone number |
url |
string |
relevant URL |
is_paid |
boolean |
indicates whether the element is an ad |
rating |
array |
the item’s rating
the popularity rate based on reviews and displayed in SERP |
rating_type |
string |
the type of rating
here you can find the following elements: Max5, Percents, CustomMax |
value |
integer |
the value of the rating |
votes_count |
integer |
the amount of feedback |
rating_max |
integer |
the maximum value for a rating_type |
main_domain |
string |
primary domain name in SERP |
relative_url |
string |
URL in SERP that does not specify the HTTPs protocol and domain name |
etv |
float |
estimated traffic volume
estimated organic monthly traffic to the domain
calculated as the product of CTR (click-through-rate) and search volume values of the returned keyword
learn more about how the metric is calculated in this help center article |
estimated_paid_traffic_cost |
float |
estimated cost of converting organic search traffic into paid
represents the estimated monthly cost of running ads for the returned keyword
the metric is calculated as the product of organic etv and paid cpc values and indicates the cost of driving the estimated volume of monthly organic traffic through PPC advertising in Google Search
learn more about how the metric is calculated in this help center article |
rank_changes |
array |
changes in rankings
contains information about the ranking changes of the SERP element since the previous_updated_time
|
previous_rank_absolute |
integer |
previous absolute rank in SERP
indicates previous rank of the element in Google SERP;
if this element is new, the value will be null
|
is_new |
boolean |
element was previously present in SERP
if the value is true, previously collected SERP didn’t contain this element
|
is_up |
boolean |
rank of this element went up
if the value is true, position of the element in SERP is higher compared to the previous check
|
is_down |
boolean |
rank of this element went down
if the value is true, position of the element in SERP is lower compared to the previous check
|
backlinks_info |
object |
backlinks information for the target website
|
referring_domains |
integer |
number of referring domains
referring domains include subdomains that are counted as separate domains for this metric
|
referring_main_domains |
integer |
number of referring main domains
|
referring_pages |
integer |
number of pages pointing to the target website
|
dofollow |
integer |
number of dofollow links
|
backlinks |
integer |
total number of backlinks
the total number of backlinks, including dofollow and nofollow links
|
time_update |
string |
date and time when backlink data was updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”;
example:
2019-11-15 12:57:46 +00:00 |
rank_info |
object |
page and domain rank information
|
page_rank |
integer |
page rank
page_rank is calculated based on the method for node ranking in a linked database – a principle used in the original Google PageRank algorithm;
learn more about the metric and how it is calculated in this help center article |
main_domain_rank |
integer |
main domain rank
main_domain_rank is calculated based on the method for node ranking in a linked database – a principle used in the original Google PageRank algorithm
learn more about the metric and how it is calculated in this help center article |
| ‘featured_snippet’ element in SERP |
|
|
type |
string |
type of element = ‘featured_snippet’ |
rank_group |
integer |
position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group |
rank_absolute |
integer |
absolute rank in SERP
absolute position among all the elements in SERP |
position |
string |
the alignment of the element in SERP
can take the following values:
left, right |
xpath |
string |
the XPath of the element |
domain |
string |
domain in SERP |
title |
string |
title of the result in SERP |
featured_title |
string |
the title of the featured snippets source page |
description |
string |
description of the results element in SERP |
url |
string |
relevant URL |
table |
array |
results table
if there are none, equals null |
table_header |
array |
column names |
table_content |
array |
the content of the table
one line of the table in this element of the array |
main_domain |
string |
primary domain name in SERP |
relative_url |
string |
URL in SERP that does not specify the HTTPs protocol and domain name |
etv |
float |
estimated traffic volume
estimated organic monthly traffic to the domain
calculated as the product of CTR (click-through-rate) and search volume values of the returned keyword
learn more about how the metric is calculated in this help center article |
estimated_paid_traffic_cost |
float |
estimated cost of converting organic search traffic into paid
represents the estimated monthly cost of running ads for the returned keyword
the metric is calculated as the product of organic etv and paid cpc values and indicates the cost of driving the estimated volume of monthly organic traffic through PPC advertising in Google Search
learn more about how the metric is calculated in this help center article |
rank_changes |
array |
changes in rankings
contains information about the ranking changes of the SERP element since the previous_updated_time
|
previous_rank_absolute |
integer |
previous absolute rank in SERP
indicates previous rank of the element in Google SERP;
if this element is new, the value will be null
|
is_new |
boolean |
element was previously present in SERP
if the value is true, previously collected SERP didn’t contain this element
|
is_up |
boolean |
rank of this element went up
if the value is true, position of the element in SERP is higher compared to the previous check
|
is_down |
boolean |
rank of this element went down
if the value is true, position of the element in SERP is lower compared to the previous check
|
backlinks_info |
object |
backlinks information for the target website
|
referring_domains |
integer |
number of referring domains
referring domains include subdomains that are counted as separate domains for this metric
|
referring_main_domains |
integer |
number of referring main domains
|
referring_pages |
integer |
number of pages pointing to the target website
|
dofollow |
integer |
number of dofollow links
|
backlinks |
integer |
total number of backlinks
the total number of backlinks, including dofollow and nofollow links
|
time_update |
string |
date and time when backlink data was updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”;
example:
2019-11-15 12:57:46 +00:00 |
rank_info |
object |
page and domain rank information
|
page_rank |
integer |
page rank
page_rank is calculated based on the method for node ranking in a linked database – a principle used in the original Google PageRank algorithm;
learn more about the metric and how it is calculated in this help center article |
main_domain_rank |
integer |
main domain rank
main_domain_rank is calculated based on the method for node ranking in a linked database – a principle used in the original Google PageRank algorithm
learn more about the metric and how it is calculated in this help center article |
check_url |
string |
direct URL to search engine results
you can use it to make sure that we provided accurate results |
serp_item_types |
array |
types of search results in SERP
contains types of search results (items) found in SERP
possible item types:
answer_box, carousel, events, featured_snippet, hotels_pack, images, jobs, local_pack, map, organic, paid, people_also_ask, people_also_search,questions_and_answers, recipes, related_searches, shopping, top_stories, video;
note that the actual results will be returned only for organic, paid, featured_snippet, and local_pack elements |
se_results_count |
string |
number of search results for the returned keyword |
keyword_difficulty |
integer |
difficulty of ranking in the first top-10 organic results for a keyword
indicates the chance of getting in top-10 organic results for a keyword on a logarithmic scale from 0 to 100;
calculated by analysing, among other parameters, link profiles of the first 10 pages in SERP |
is_lost |
boolean |
indicates whether the keyword is lost
if true, the target had previously had ranking results in SERP for the keyword, but din’t have them during the last check
|
last_updated_time |
string |
date and time when SERP data was updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00 |
previous_updated_time |
string |
previous to the most recent date and time when SERP data was updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-10-15 12:57:46 +00:00 |