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 |
impressions_etv |
float |
estimated traffic volume based on impressions
estimated organic monthly traffic to the domain
calculated as the product of CTR (click-through-rate) and impressions 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 Google 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 Google Search
|
is_down |
integer |
rank went down
indicates how many ranked elements of this domain went down in Google 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 |
impressions_etv |
float |
estimated traffic volume based on impressions
estimated paid monthly traffic to the domain
calculated as the product of CTR (click-through-rate) and impressions 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 Google Search
|
is_down |
integer |
rank went down
indicates how many ranked elements of this domain went down in Google 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 Google 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 |
impressions_etv |
float |
estimated traffic volume based on impressions
estimated paid monthly traffic to the domain
calculated as the product of CTR (click-through-rate) and impressions 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 |
impressions_etv |
float |
estimated traffic volume based on impressions
estimated paid monthly traffic to the domain
calculated as the product of CTR (click-through-rate) and impressions 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 |
object |
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 Google Search
|
is_down |
integer |
rank went down
indicates how many ranked elements of this domain went down in Google 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 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 Google Search
|
is_down |
integer |
rank went down
indicates how many ranked elements of this domain went down in Google 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 Google 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 |
impressions_etv |
float |
estimated traffic volume based on impressions
estimated paid monthly traffic to the domain
calculated as the product of CTR (click-through-rate) and impressions 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 |
impressions_etv |
float |
estimated traffic volume based on impressions
estimated paid monthly traffic to the domain
calculated as the product of CTR (click-through-rate) and impressions 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 |
se_type |
string |
search engine type |
keyword_data |
object |
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 |
string |
language code in a POST array |
keyword_info |
object |
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;
the value is based on Google Ads data and can be between 0 and 1 (inclusive) |
competition_level |
string |
competition level
represents the relative level of competition associated with the given keyword in paid SERP only;
possible values: LOW , MEDIUM , HIGH
if competition level is unknown, the value is null ;
learn more about the metric in this help center article |
cpc |
float |
cost-per-click
represents the average cost per click (USD) historically paid for the keyword |
search_volume |
integer |
average monthly search volume rate
represents the (approximate) number of searches for the given keyword idea on google.com |
low_top_of_page_bid |
float |
minimum bid for the ad to be displayed at the top of the first page
indicates the value greater than about 20% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers)
the value may differ depending on the location specified in a POST request |
high_top_of_page_bid |
float |
maximum bid for the ad to be displayed at the top of the first page
indicates the value greater than about 80% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers)
the value may differ depending on the location specified in a POST request |
categories |
array |
product and service categories
you can download the full list of possible categories
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
|
impressions_info |
array |
impressions data for the returned keyword
Note that all data in the impressions_info object is deprecated and provided only as legacy to avoid maintenance issues
daily_impressions values provide a more accurate alternative to Google search volume data;
the 999 bid is used to mitigate account-specific factors Google considers when calculating impressions
learn more about impressions in this help center article
|
se_type |
string |
search engine type |
last_updated_time |
string |
date and time when impressions data was updated
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00 |
bid |
integer |
the maximum CPC
it stands for the price you are willing to pay for an ad. The higher value, the higher positions and price you will get
we return the results for the 999 bid value to provide the highest number of impressions and level down the account-specific factors |
match_type |
string |
keyword match-type
can take the following values: exact , broad , phrase |
ad_position_min |
float |
the minimum ad position
represents the minimum position of the advertisement |
ad_position_max |
float |
the maximum ad position
represents the maximum position of the advertisement |
ad_position_average |
float |
the average ad position
represents the average position of the advertisement |
cpc_min |
float |
the minimum value of cost-per-click
the minimum cost-per-click (USD) for the keyword given that a bid is set to 999 ;
note: this field does not represent an actual CPC value;
you can find an actual CPC value for a keyword in the cpc field of the keyword_info object
|
cpc_max |
float |
the maximum value of cost-per-click
the maximum cost-per-click (USD) for the keyword given that a bid is set to 999 ;
note: this field does not represent an actual CPC value;
you can find an actual CPC value for a keyword in the cpc field of the keyword_info object
|
cpc_average |
float |
the average value of cost-per-click
the average cost-per-click (USD) for the keyword given that a bid is set to 999 ;
note: this field does not represent an actual CPC value;
you can find an actual CPC value for a keyword in the cpc field of the keyword_info object
|
daily_impressions_min |
float |
the minimum value of daily impressions
represents the minimum number of daily impressions of the advertisement given that that a bid is set to 999 ;
provides a more accurate alternative to Google search volume data |
daily_impressions_max |
float |
the maximum value of daily impressions
represents the maximum number of daily impressions of the advertisement given that that a bid is set to 999 ;
provides a more accurate alternative to Google search volume data |
daily_impressions_average |
float |
the average value of daily impressions
represents the average number of daily impressions of the advertisement given that that a bid is set to 999 ;
provides a more accurate alternative to Google search volume data |
daily_clicks_min |
float |
the minimum value of daily clicks
represents the minimum number of daily clicks on the advertisement |
daily_clicks_max |
float |
the maximum value of daily clicks
represents the maximum number of daily clicks on the advertisement |
daily_clicks_average |
float |
the average value of daily clicks
represents the average number of daily clicks on the advertisement |
daily_cost_min |
float |
the minimum daily charge value
represents the minimum daily cost of the advertisement (USD) |
daily_cost_max |
float |
the maximum daily charge value
represents the maximum daily cost of the advertisement (USD) |
daily_cost_average |
float |
the average daily charge value
represents the average daily cost of the advertisement (USD) |
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 , app , carousel , multi_carousel , featured_snippet , google_flights , google_reviews , images , jobs , knowledge_graph , local_pack , map , organic , paid , people_also_ask , related_searches , people_also_search , shopping , top_stories , twitter , video , events , mention_carousel , recipes , top_sights , scholarly_articles , popular_products , podcasts , questions_and_answers , find_results_on , stocks_box ;
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;
learn more about the metric in this help center guide |
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 |
search_intent_info |
object |
search intent info for the returned keyword
learn about search intent in this help center article |
se_type |
string |
search engine type
possible values: google
|
main_intent |
string |
main search intent
possible values: informational , navigational , commercial , transactional
|
foreign_intent |
array |
supplementary search intents
possible values: informational , navigational , commercial , transactional
|
last_updated_time |
string |
date and time when search intent data was last 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 |
object |
contains data on the domain’s SERP element found for the returned keyword |
se_type |
string |
search engine type |
serp_item |
object |
contains data on the SERP element
the list of supported SERP elements can be found below |
se_type |
string |
search engine type |
|
|
|
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 |
website_name |
string |
relevant website name 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 |
about_this_result |
object |
contains information from the ‘About this result’ panel
‘About this result’ panel provides additional context about why Google returned this result for the given query;
this feature appears after clicking on the three dots next to most results |
type |
string |
type of element = ‘about_this_result_element‘ |
url |
string |
result’s URL
|
source |
string |
source of additional information about the result
|
source_info |
string |
additional information about the result
description of the website from Wikipedia or another additional context |
source_url |
string |
URL to full information from the source
|
language |
string |
the language of the result
|
location |
string |
location for which the result is relevant
|
search_terms |
array |
matching search terms that appear in the result
|
related_terms |
array |
related search terms that appear in the result |
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 |
impressions_etv |
float |
estimated traffic volume based on impressions
estimated organic monthly traffic to the domain
calculated as the product of CTR (click-through-rate) and impressions 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 |
object |
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 |
|
|
|
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 |
impressions_etv |
float |
estimated traffic volume based on impressions
estimated organic monthly traffic to the domain
calculated as the product of CTR (click-through-rate) and impressions 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 |
object |
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 |
|
|
|
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 |
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 |
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 |
impressions_etv |
float |
estimated traffic volume based on impressions
estimated organic monthly traffic to the domain
calculated as the product of CTR (click-through-rate) and impressions 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 |
object |
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 |
|
|
|
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 |
object |
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 |
impressions_etv |
float |
estimated traffic volume based on impressions
estimated organic monthly traffic to the domain
calculated as the product of CTR (click-through-rate) and impression 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 |
object |
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 |