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 or webpage 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 or webpage 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 target ranks #1 |
pos_2_3 | integer | number of organic SERPs where target ranks #2-3 |
pos_4_10 | integer | number of organic SERPs where target ranks #4-10 |
pos_11_20 | integer | number of organic SERPs where target ranks #11-20 |
pos_21_30 | integer | number of organic SERPs where target ranks #21-30 |
pos_31_40 | integer | number of organic SERPs where target ranks #31-40 |
pos_41_50 | integer | number of organic SERPs where target ranks #41-50 |
pos_51_60 | integer | number of organic SERPs where target ranks #51-60 |
pos_61_70 | integer | number of organic SERPs where target ranks #61-70 |
pos_71_80 | integer | number of organic SERPs where target ranks #71-80 |
pos_81_90 | integer | number of organic SERPs where target ranks #81-90 |
pos_91_100 | integer | number of organic SERPs where target ranks #91-100 |
etv | float | estimated traffic volume estimated organic monthly traffic to the domain or webpage; calculated as the product of CTR (click-through-rate) and search volume values of all keywords the domain or webpage rank for; learn more about how the metric is calculated in this help center article |
count | integer | total count of organic SERPs that contain the target |
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 or webpage 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 or webpage |
is_up | integer | rank went up indicates how many ranked elements of this target went up in Google Search |
is_down | integer | rank went down indicates how many ranked elements of this target went down in Google Search |
is_lost | integer | lost ranked elements indicates how many ranked elements of this target were previously presented in SERPs, but weren't found during the last check |
clickstream_etv | integer | estimated traffic volume based on clickstream data calculated as the product of click-through-rate and clickstream search volume values of all keywords the domain or webpage ranks for; to retrieve results for this field, the parameter include_clickstream_data must be set to true; learn more about how the metric is calculated in this help center article |
clickstream_gender_distribution | object | distribution of estimated clickstream-based metrics by gender to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article |
female | integer | number of female users in the relevant clickstream dataset |
male | integer | number of male users in the relevant clickstream dataset |
clickstream_age_distribution | object | distribution of clickstream-based metrics by age to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article |
18-24 | integer | number of users in the relevant clickstream dataset that fall within the 18-24 age range |
25-34 | integer | number of users in the relevant clickstream dataset that fall within the 25-34 age range |
35-44 | integer | number of users in the relevant clickstream dataset that fall within the 35-44 age range |
45-54 | integer | number of users in the relevant clickstream dataset that fall within the 45-54 age range |
55-64 | integer | number of users in the relevant clickstream dataset that fall within the 55-64 age range |
paid | object | ranking and traffic data from paid search |
pos_1 | integer | number of paid SERPs where target ranks #1 |
pos_2_3 | integer | number of paid SERPs where target ranks #2-3 |
pos_4_10 | integer | number of paid SERPs where target ranks #4-10 |
pos_11_20 | integer | number of paid SERPs where target ranks #11-20 |
pos_21_30 | integer | number of paid SERPs where target ranks #21-30 |
pos_31_40 | integer | number of paid SERPs where target ranks #31-40 |
pos_41_50 | integer | number of paid SERPs where target ranks #41-50 |
pos_51_60 | integer | number of paid SERPs where target ranks #51-60 |
pos_61_70 | integer | number of paid SERPs where target ranks #61-70 |
pos_71_80 | integer | number of paid SERPs where target ranks #71-80 |
pos_81_90 | integer | number of paid SERPs where target ranks #81-90 |
pos_91_100 | integer | number of paid SERPs where target ranks #91-100 |
etv | float | estimated traffic volume estimated paid monthly traffic to the target calculated as the product of CTR (click-through-rate) and search volume values of all keywords the target 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 target |
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 target |
is_up | integer | rank went up indicates how many ranked elements of this target went up in Google Search |
is_down | integer | rank went down indicates how many ranked elements of this target went down in Google Search |
is_lost | integer | lost ranked elements indicates how many ranked elements of this target were previously presented in SERPs, but weren't found during the last check |
clickstream_etv | integer | estimated traffic volume based on clickstream data calculated as the product of click-through-rate and clickstream search volume values of all keywords the target ranks for to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article |
clickstream_gender_distribution | object | distribution of estimated clickstream-based metrics by gender to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article |
female | integer | number of female users in the relevant clickstream dataset |
male | integer | number of male users in the relevant clickstream dataset |
clickstream_age_distribution | object | distribution of clickstream-based metrics by age to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article |
18-24 | integer | number of users in the relevant clickstream dataset that fall within the 18-24 age range |
25-34 | integer | number of users in the relevant clickstream dataset that fall within the 25-34 age range |
35-44 | integer | number of users in the relevant clickstream dataset that fall within the 35-44 age range |
45-54 | integer | number of users in the relevant clickstream dataset that fall within the 45-54 age range |
55-64 | integer | number of users in the relevant clickstream dataset that fall within the 55-64 age range |
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 target ranks #1 |
pos_2_3 | integer | number of featured snippet items where the target ranks #2-3 |
pos_4_10 | integer | number of featured snippet items where the target ranks #4-10 |
pos_11_20 | integer | number of featured snippet items where the target ranks #11-20 |
pos_21_30 | integer | number of featured snippet items where the target ranks #21-30 |
pos_31_40 | integer | number of featured snippet items where the target ranks #31-40 |
pos_41_50 | integer | number of featured snippet items where the target ranks #41-50 |
pos_51_60 | integer | number of featured snippet items where the target ranks #51-60 |
pos_61_70 | integer | number of featured snippet items where the target ranks #61-70 |
pos_71_80 | integer | number of featured snippet items where the target ranks #71-80 |
pos_81_90 | integer | number of featured snippet items where the target ranks #81-90 |
pos_91_100 | integer | number of featured snippet items where the target ranks #91-100 |
etv | float | estimated traffic volume estimated paid monthly traffic to the target calculated as the product of CTR (click-through-rate) and search volume values of all keywords in the category that the target 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 target |
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 target 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 |
clickstream_etv | integer | estimated traffic volume based on clickstream data calculated as the product of click-through-rate and clickstream search volume values of all keywords the target ranks for to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article |
clickstream_gender_distribution | object | distribution of estimated clickstream-based metrics by gender to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article |
female | integer | number of female users in the relevant clickstream dataset |
male | integer | number of male users in the relevant clickstream dataset |
clickstream_age_distribution | object | distribution of clickstream-based metrics by age to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article |
18-24 | integer | number of users in the relevant clickstream dataset that fall within the 18-24 age range |
25-34 | integer | number of users in the relevant clickstream dataset that fall within the 25-34 age range |
35-44 | integer | number of users in the relevant clickstream dataset that fall within the 35-44 age range |
45-54 | integer | number of users in the relevant clickstream dataset that fall within the 45-54 age range |
55-64 | integer | number of users in the relevant clickstream dataset that fall within the 55-64 age range |
local_pack | object | ranking and traffic data from the local pack results in SERP |
pos_1 | integer | number of local pack items where the target ranks #1 |
pos_2_3 | integer | number of local pack items where the target ranks #2-3 |
pos_4_10 | integer | number of local pack items where the target ranks #4-10 |
pos_11_20 | integer | number of local pack items where the target ranks #11-20 |
pos_21_30 | integer | number of local pack items where the target ranks #21-30 |
pos_31_40 | integer | number of local pack items where the target ranks #31-40 |
pos_41_50 | integer | number of local pack items where the target ranks #41-50 |
pos_51_60 | integer | number of local pack items where the target ranks #51-60 |
pos_61_70 | integer | number of local pack items where the target ranks #61-70 |
pos_71_80 | integer | number of local pack items where the target ranks #71-80 |
pos_81_90 | integer | number of local pack items where the target ranks #81-90 |
pos_91_100 | integer | number of local pack items where the target ranks #91-100 |
etv | float | estimated traffic volume estimated paid monthly traffic to the target calculated as the product of CTR (click-through-rate) and search volume values of all keywords in the category that the target 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 target |
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 target 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 |
clickstream_etv | integer | estimated traffic volume based on clickstream data calculated as the product of click-through-rate and clickstream search volume values of all keywords the target ranks for to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article |
clickstream_gender_distribution | object | distribution of estimated clickstream-based metrics by gender to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article |
female | integer | number of female users in the relevant clickstream dataset |
male | integer | number of male users in the relevant clickstream dataset |
clickstream_age_distribution | object | distribution of clickstream-based metrics by age to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article |
18-24 | integer | number of users in the relevant clickstream dataset that fall within the 18-24 age range |
25-34 | integer | number of users in the relevant clickstream dataset that fall within the 25-34 age range |
35-44 | integer | number of users in the relevant clickstream dataset that fall within the 35-44 age range |
45-54 | integer | number of users in the relevant clickstream dataset that fall within the 45-54 age range |
55-64 | integer | number of users in the relevant clickstream dataset that fall within the 55-64 age range |
ai_overview_reference | object | ranking and traffic data from ai_overivew results in Google SERP |
pos_1 | integer | number of ai_overivew references where the target ranks #1 |
pos_2_3 | integer | number of ai_overivew references where the target ranks #2-3 |
pos_4_10 | integer | number of ai_overivew references where the target ranks #4-10 |
pos_11_20 | integer | number of ai_overivew references where the target ranks #11-20 |
pos_21_30 | integer | number of ai_overivew references where the target ranks #21-30 |
pos_31_40 | integer | number of ai_overivew references where the target ranks #31-40 |
pos_41_50 | integer | number of ai_overivew references where the target ranks #41-50 |
pos_51_60 | integer | number of ai_overivew references where the target ranks #51-60 |
pos_61_70 | integer | number of ai_overivew references where the target ranks #61-70 |
pos_71_80 | integer | number of ai_overivew references where the target ranks #71-80 |
pos_81_90 | integer | number of ai_overivew references where the target ranks #81-90 |
pos_91_100 | integer | number of ai_overivew references where the target ranks #91-100 |
etv | float | estimated traffic volume estimated paid monthly traffic to the target calculated as the product of CTR (click-through-rate) and search volume values of all keywords in the category that the target 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 target |
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 target 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 |
clickstream_etv | integer | estimated traffic volume based on clickstream data calculated as the product of click-through-rate and clickstream search volume values of all keywords the target ranks for to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article |
clickstream_gender_distribution | object | distribution of estimated clickstream-based metrics by gender to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article |
female | integer | number of female users in the relevant clickstream dataset |
male | integer | number of male users in the relevant clickstream dataset |
clickstream_age_distribution | object | distribution of clickstream-based metrics by age to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article |
18-24 | integer | number of users in the relevant clickstream dataset that fall within the 18-24 age range |
25-34 | integer | number of users in the relevant clickstream dataset that fall within the 25-34 age range |
35-44 | integer | number of users in the relevant clickstream dataset that fall within the 35-44 age range |
45-54 | integer | number of users in the relevant clickstream dataset that fall within the 45-54 age range |
55-64 | integer | number of users in the relevant clickstream dataset that fall within the 55-64 age range |
metrics_absolute | object | ranking data relevant to the specified domain or webpage 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 target ranks #1 |
pos_2_3 | integer | number of organic SERPs where the target ranks #2-3 |
pos_4_10 | integer | number of organic SERPs where target ranks #4-10 |
pos_11_20 | integer | number of organic SERPs where target ranks #11-20 |
pos_21_30 | integer | number of organic SERPs where target ranks #21-30 |
pos_31_40 | integer | number of organic SERPs where target ranks #31-40 |
pos_41_50 | integer | number of organic SERPs where target ranks #41-50 |
pos_51_60 | integer | number of organic SERPs where target ranks #51-60 |
pos_61_70 | integer | number of organic SERPs where target ranks #61-70 |
pos_71_80 | integer | number of organic SERPs where target ranks #71-80 |
pos_81_90 | integer | number of organic SERPs where target ranks #81-90 |
pos_91_100 | integer | number of organic SERPs where target ranks #91-100 |
is_new | integer | number of new ranked elements indicates how many new ranked elements were found for this target |
is_up | integer | rank went up indicates how many ranked elements of this target went up in Google Search |
is_down | integer | rank went down indicates how many ranked elements of this target went down in Google Search |
is_lost | integer | lost ranked elements indicates how many ranked elements of this target were previously presented in SERPs, but weren't found during the last check |
clickstream_etv | integer | estimated traffic volume based on clickstream data calculated as the product of click-through-rate and clickstream search volume values of all keywords the target ranks for to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article |
clickstream_gender_distribution | object | distribution of estimated clickstream-based metrics by gender to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article |
female | integer | number of female users in the relevant clickstream dataset |
male | integer | number of male users in the relevant clickstream dataset |
clickstream_age_distribution | object | distribution of clickstream-based metrics by age to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article |
18-24 | integer | number of users in the relevant clickstream dataset that fall within the 18-24 age range |
25-34 | integer | number of users in the relevant clickstream dataset that fall within the 25-34 age range |
35-44 | integer | number of users in the relevant clickstream dataset that fall within the 35-44 age range |
45-54 | integer | number of users in the relevant clickstream dataset that fall within the 45-54 age range |
55-64 | integer | number of users in the relevant clickstream dataset that fall within the 55-64 age range |
paid | object | ranking data from paid search |
pos_1 | integer | number of paid SERPs where target ranks #1 |
pos_2_3 | integer | number of paid SERPs where target ranks #2-3 |
pos_4_10 | integer | number of paid SERPs where target ranks #4-10 |
pos_11_20 | integer | number of paid SERPs where target ranks #11-20 |
pos_21_30 | integer | number of paid SERPs where target ranks #21-30 |
pos_31_40 | integer | number of paid SERPs where target ranks #31-40 |
pos_41_50 | integer | number of paid SERPs where target ranks #41-50 |
pos_51_60 | integer | number of paid SERPs where target ranks #51-60 |
pos_61_70 | integer | number of paid SERPs where target ranks #61-70 |
pos_71_80 | integer | number of paid SERPs where target ranks #71-80 |
pos_81_90 | integer | number of paid SERPs where target ranks #81-90 |
pos_91_100 | integer | number of paid SERPs where target ranks #91-100 |
is_new | integer | number of new ranked elements indicates how many new ranked elements were found for this target |
is_up | integer | rank went up indicates how many ranked elements of this target went up in Google Search |
is_down | integer | rank went down indicates how many ranked elements of this target went down in Google Search |
is_lost | integer | lost ranked elements indicates how many ranked elements of this target were previously presented in SERPs, but weren't found during the last check |
clickstream_etv | integer | estimated traffic volume based on clickstream data calculated as the product of click-through-rate and clickstream search volume values of all keywords the target ranks for to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article |
clickstream_gender_distribution | object | distribution of estimated clickstream-based metrics by gender to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article |
female | integer | number of female users in the relevant clickstream dataset |
male | integer | number of male users in the relevant clickstream dataset |
clickstream_age_distribution | object | distribution of clickstream-based metrics by age to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article |
18-24 | integer | number of users in the relevant clickstream dataset that fall within the 18-24 age range |
25-34 | integer | number of users in the relevant clickstream dataset that fall within the 25-34 age range |
35-44 | integer | number of users in the relevant clickstream dataset that fall within the 35-44 age range |
45-54 | integer | number of users in the relevant clickstream dataset that fall within the 45-54 age range |
55-64 | integer | number of users in the relevant clickstream dataset that fall within the 55-64 age range |
featured_snippet | object | ranking and traffic data from the featured snippet results in Google SERP |
pos_1 | integer | number of featured snippet items where target ranks #1 |
pos_2_3 | integer | number of featured snippet items where target ranks #2-3 |
pos_4_10 | integer | number of featured snippet items where target ranks #4-10 |
pos_11_20 | integer | number of featured snippet items where target ranks #11-20 |
pos_21_30 | integer | number of featured snippet items where target ranks #21-30 |
pos_31_40 | integer | number of featured snippet items where target ranks #31-40 |
pos_41_50 | integer | number of featured snippet items where target ranks #41-50 |
pos_51_60 | integer | number of featured snippet items where target ranks #51-60 |
pos_61_70 | integer | number of featured snippet items where target ranks #61-70 |
pos_71_80 | integer | number of featured snippet items where target ranks #71-80 |
pos_81_90 | integer | number of featured snippet items where target ranks #81-90 |
pos_91_100 | integer | number of featured snippet items where target ranks #91-100 |
etv | float | estimated traffic volume estimated paid monthly traffic to the target calculated as the product of CTR (click-through-rate) and search volume values of all keywords in the category that the target 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 target |
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 target 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 |
clickstream_etv | integer | estimated traffic volume based on clickstream data calculated as the product of click-through-rate and clickstream search volume values of all keywords the target ranks for to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article |
clickstream_gender_distribution | object | distribution of estimated clickstream-based metrics by gender to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article |
female | integer | number of female users in the relevant clickstream dataset |
male | integer | number of male users in the relevant clickstream dataset |
clickstream_age_distribution | object | distribution of clickstream-based metrics by age to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article |
18-24 | integer | number of users in the relevant clickstream dataset that fall within the 18-24 age range |
25-34 | integer | number of users in the relevant clickstream dataset that fall within the 25-34 age range |
35-44 | integer | number of users in the relevant clickstream dataset that fall within the 35-44 age range |
45-54 | integer | number of users in the relevant clickstream dataset that fall within the 45-54 age range |
55-64 | integer | number of users in the relevant clickstream dataset that fall within the 55-64 age range |
local_pack | object | ranking and traffic data from the local pack results in SERP |
pos_1 | integer | number of local pack items where target ranks #1 |
pos_2_3 | integer | number of local pack items where target ranks #2-3 |
pos_4_10 | integer | number of local pack items where target ranks #4-10 |
pos_11_20 | integer | number of local pack items where target ranks #11-20 |
pos_21_30 | integer | number of local pack items where target ranks #21-30 |
pos_31_40 | integer | number of local pack items where target ranks #31-40 |
pos_41_50 | integer | number of local pack items where target ranks #41-50 |
pos_51_60 | integer | number of local pack items where target ranks #51-60 |
pos_61_70 | integer | number of local pack items where target ranks #61-70 |
pos_71_80 | integer | number of local pack items where target ranks #71-80 |
pos_81_90 | integer | number of local pack items where the target ranks #81-90 |
pos_91_100 | integer | number of local pack items where the target ranks #91-100 |
etv | float | estimated traffic volume estimated paid monthly traffic to the target calculated as the product of CTR (click-through-rate) and search volume values of all keywords in the category that the target 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 target |
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 target 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 |
clickstream_etv | integer | estimated traffic volume based on clickstream data calculated as the product of click-through-rate and clickstream search volume values of all keywords the targetranks for to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article |
clickstream_gender_distribution | object | distribution of estimated clickstream-based metrics by gender to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article |
female | integer | number of female users in the relevant clickstream dataset |
male | integer | number of male users in the relevant clickstream dataset |
clickstream_age_distribution | object | distribution of clickstream-based metrics by age to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article |
18-24 | integer | number of users in the relevant clickstream dataset that fall within the 18-24 age range |
25-34 | integer | number of users in the relevant clickstream dataset that fall within the 25-34 age range |
35-44 | integer | number of users in the relevant clickstream dataset that fall within the 35-44 age range |
45-54 | integer | number of users in the relevant clickstream dataset that fall within the 45-54 age range |
55-64 | integer | number of users in the relevant clickstream dataset that fall within the 55-64 age range |
ai_overview_reference | object | ranking and traffic data from ai_overivew results in Google SERP |
pos_1 | integer | number of ai_overivew references where the target ranks #1 |
pos_2_3 | integer | number of ai_overivew references where the target ranks #2-3 |
pos_4_10 | integer | number of ai_overivew references where the target ranks #4-10 |
pos_11_20 | integer | number of ai_overivew references where the target ranks #11-20 |
pos_21_30 | integer | number of ai_overivew references where the target ranks #21-30 |
pos_31_40 | integer | number of ai_overivew references where the target ranks #31-40 |
pos_41_50 | integer | number of ai_overivew references where the target ranks #41-50 |
pos_51_60 | integer | number of ai_overivew references where the target ranks #51-60 |
pos_61_70 | integer | number of ai_overivew references where the target ranks #61-70 |
pos_71_80 | integer | number of ai_overivew references where the target ranks #71-80 |
pos_81_90 | integer | number of ai_overivew references where the target ranks #81-90 |
pos_91_100 | integer | number of ai_overivew references where the target ranks #91-100 |
etv | float | estimated traffic volume estimated paid monthly traffic to the target calculated as the product of CTR (click-through-rate) and search volume values of all keywords in the category that the target 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 target |
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 target 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 |
clickstream_etv | integer | estimated traffic volume based on clickstream data calculated as the product of click-through-rate and clickstream search volume values of all keywords the target ranks for to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article |
clickstream_gender_distribution | object | distribution of estimated clickstream-based metrics by gender to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article |
female | integer | number of female users in the relevant clickstream dataset |
male | integer | number of male users in the relevant clickstream dataset |
clickstream_age_distribution | object | distribution of clickstream-based metrics by age to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article |
18-24 | integer | number of users in the relevant clickstream dataset that fall within the 18-24 age range |
25-34 | integer | number of users in the relevant clickstream dataset that fall within the 25-34 age range |
35-44 | integer | number of users in the relevant clickstream dataset that fall within the 35-44 age range |
45-54 | integer | number of users in the relevant clickstream dataset that fall within the 45-54 age range |
55-64 | integer | number of users in the relevant clickstream dataset that fall within the 55-64 age range |
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 |
search_volume_trend | object | search volume trend changes represents search volume change in percent compared to the previous period |
monthly | integer | search volume change in percent compared to the previous month |
quarterly | integer | search volume change in percent compared to the previous quarter |
yearly | integer | search volume change in percent compared to the previous year |
keyword_info_normalized_with_bing | object | contains keyword search volume normalized with Bing search volume |
last_updated_time | string | date and time when the dataset was updated in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00 |
search_volume | integer | current search volume rate of a keyword |
is_normalized | boolean | keyword info is normalized if true, values are normalized with Bing data |
monthly_searches | object | monthly search volume rates array of objects with search volume rates in a certain month of a year |
year | object | year |
month | integer | month |
search_volume | integer | search volume rate in a certain month of a year |
keyword_info_normalized_with_clickstream | object | contains keyword search volume normalized with clickstream data |
last_updated_time | string | date and time when the dataset was updated in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00 |
search_volume | integer | current search volume rate of a keyword |
is_normalized | boolean | keyword info is normalized if true, values are normalized with clickstream data |
monthly_searches | object | monthly search volume rates array of objects with search volume rates in a certain month of a year |
year | integer | year |
month | integer | month |
search_volume | integer | search volume rate in a certain month of a year |
clickstream_keyword_info | object | clickstream data for the returned keyword to retrieve results for this field, the parameter include_clickstream_data must be set to true |
search_volume | integer | monthly average clickstream search volume rate |
last_updated_time | string | date and time when the clickstream dataset was updated in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” |
gender_distribution | object | distribution of estimated clickstream-based metrics by gender learn more about how the metric is calculated in this help center article |
female | integer | number of female users in the relevant clickstream dataset |
male | integer | number of male users in the relevant clickstream dataset |
age_distribution | object | distribution of clickstream-based metrics by age learn more about how the metric is calculated in this help center article |
18-24 | integer | number of users in the relevant clickstream dataset that fall within the 18-24 age range |
25-34 | integer | number of users in the relevant clickstream dataset that fall within the 25-34 age range |
35-44 | integer | number of users in the relevant clickstream dataset that fall within the 35-44 age range |
45-54 | integer | number of users in the relevant clickstream dataset that fall within the 45-54 age range |
55-64 | integer | number of users in the relevant clickstream dataset that fall within the 55-64 age range |
monthly_searches | array | monthly clickstream search volume rates array of objects with clickstream search volume rates in a certain month of a year |
year | integer | year |
month | integer | month |
search_volume | integer | clickstream-based search volume rate in a certain month of a year |
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, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, third_party_reviews, google_posts, images, jobs, knowledge_graph, local_pack, hotels_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, visual_stories, commercial_units, local_services, google_hotels, math_solver, currency_box, product_considerations, found_on_web, short_videos, refine_products, explore_brands, perspectives, discussions_and_forums, compare_sites, courses, ai_overview; note that the actual results will be returned only for organic, paid, featured_snippet, and local_pack elements |
se_results_count | integer | number of search results for the returned keyword |
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 webpages 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 |
organic | object | ‘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 |
website_name | string | relevant website name in SERP |
is_image | boolean | indicates whether the element contains an image Note: this check no longer appears in SERP |
is_video | boolean | indicates whether the element contains a video Note: this check no longer appears in SERP |
is_featured_snippet | boolean | indicates whether the element is a featured_snippet Note: this check no longer appears in SERP |
is_malicious | boolean | indicates whether the element is marked as malicious Note: this check no longer appears in SERP |
checks | array | array of properties detected for the SERP element lists the properties that are true for this element each value in the array represents a detected property example: if is_image is present in the array, the element contains an image possible values in the array:
is_image, is_video, is_featured_snippet, amp_version, is_malicious, is_web_story, is_highly_cited equals null if none of the properties are detected for the element learn more about the checks array in this Help Center article |
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 Note: this check no longer appears in SERP |
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 target 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 |
clickstream_etv | integer | estimated traffic volume based on clickstream data calculated as the product of click-through-rate and clickstream search volume values of all keywords the domain ranks for to retrieve results for this field, the parameter include_clickstream_data must be set to true 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 relevant page URL |
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 | object | ‘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 | 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 relevant page URL |
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 |
clickstream_etv | integer | estimated traffic volume based on clickstream data calculated as the product of click-through-rate and clickstream search volume values of all keywords the domain ranks for to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article |
local_pack | object | ‘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 | 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 |
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 relevant page URL |
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 |
clickstream_etv | integer | estimated traffic volume based on clickstream data calculated as the product of click-through-rate and clickstream search volume values of all keywords the domain ranks for to retrieve results for this field, the parameter include_clickstream_data must be set to true learn more about how the metric is calculated in this help center article |
featured_snippet | object | ‘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 | 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 |
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 relevant page URL |
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 |
ai_overview_reference | object | ‘ai_overview_reference’ element in SERP |
type | string | type of element = 'ai_overview_reference' |
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 |
source | string | reference source name or title |
domain | string | domain name of the reference |
title | string | reference page title |
url | string | reference page URL |
text | string | reference text text snippet from the page that was used to generate the ai_overview_element |
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 | 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 relevant page URL |
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 all possible item types can be found here, they include: 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, local_pack, and ai_overview_reference 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 if the result no longer appears 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 |