Domain Metrics By Categories: how the new endpoint works
in
By calling the Domain Metrics By Categories endpoint, you can receive up to 1,000 domains relevant to the specified categories, including the dynamics of domain metrics within the indicated time frame.
POST https://api.dataforseo.com/v3/dataforseo_labs/google/domain_metrics_by_categories/live
You will receive historical ranking data from Google SERPs, along with valuable current and historical domain metrics, such as traffic volume, estimated paid traffic cost, and more.
By providing the dynamics of changes in domain metrics, the endpoint enables you to discover how much traffic and how many ranking positions a specific domain has lost or gained over a certain time period.
In the following paragraphs, we will provide insights into how the Domain Metrics By Categories endpoint works so that you can fully utilize its capabilities.
Setting a task
The Domain Metrics By Categories endpoint has 5 required fields:
1 category_codes — product and service categories for which you want to receive a list of domains and their metrics (you can download the full list of possible categories here).
2 first_date — first date of comparison period for which domains and metrics are provided. It should be specified in the YYYYMMDD format. Example: "first_date": "2021-06-01".
Note: first_date cannot be greater than today’s date. The dates specified in first_date and second_date cannot point to the same month of the same year.
You can specify the dates in any order: first_date can be greater than second_date and vice versa. The minimum date you can specify is 2020-10-01.
3 second_date — second date of comparison period for which domains and metrics are provided. It should be specified in the YYYYMMDD format. Example: "second_date": "2021-10-01".
Note: second_date cannot be greater than today’s date. The dates specified in first_date and second_date cannot point to the same month of the same year.
You can specify the dates in any order: second_date can be greater than first_date and vice versa. The minimum date you can specify is 2020-10-01.
4 location_name or location_code.
5 language_name or language_code.
Your basic POST request will be structured as in the following example:
[
{
"location_code": 2840,
"language_code": "en",
"category_codes": [
13418
],
"first_date": "2021-06-01",
"second_date": "2021-10-01"
}
]
In later paragraphs, we will walk you through more advanced parameters, but for now, let’s keep things simple and analyze the response for a basic request.
Understanding the response
In the API response, you will get a list of domains for the specified categories, their current metrics, and historical metrics for the indicated dates.
{
"version": "0.1.20220216",
"status_code": 20000,
"status_message": "Ok.",
"time": "5.8301 sec.",
"cost": 0.2,
"tasks_count": 1,
"tasks_error": 0,
"tasks": [
{
"id": "03211159-2806-0403-0000-eb3be995ba4f",
"status_code": 20000,
"status_message": "Ok.",
"time": "5.7671 sec.",
"cost": 0.2,
"result_count": 1,
"path": [
"v3",
"dataforseo_labs",
"google",
"domain_metrics_by_categories",
"live"
],
"data": {
"api": "dataforseo_labs",
"function": "domain_metrics_by_categories",
"se_type": "google",
"location_code": 2840,
"language_code": "en",
"category_codes": [
13418
],
"first_date": "2021-06-01",
"second_date": "2021-10-01"
},
"result": [
{
"se_type": "google",
"categories": [
13418
],
"location_code": 2840,
"language_code": "en",
"total_count": 225001,
"items_count": 100,
"items": [
{
"se_type": "google",
"top_categories": [
13418
],
"organic_etv": 9950900.042,
"organic_count": 2,
"organic_is_lost": null,
"organic_is_new": null,
"domain": "www.youtour.pt",
"main_domain": "youtour.pt",
"metrics_history": {
"202106": {
"organic": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 1,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 1,
"pos_41_50": 2,
"pos_51_60": 1,
"pos_61_70": 0,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 0,
"etv": 1.8916626204550264,
"count": 5,
"estimated_paid_traffic_cost": 0,
"is_new": 1,
"is_up": 1,
"is_down": 2,
"is_lost": 1
},
"paid": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": 0,
"pos_51_60": 0,
"pos_61_70": 0,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 0,
"etv": 0,
"count": 0,
"estimated_paid_traffic_cost": 0,
"is_new": 0,
"is_up": 0,
"is_down": 0,
"is_lost": 0
},
"featured_snippet": null,
"local_pack": null
},
"202110": {
"organic": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": 0,
"pos_51_60": 0,
"pos_61_70": 0,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 0,
"etv": 0,
"count": 0,
"estimated_paid_traffic_cost": 0,
"is_new": 0,
"is_up": 0,
"is_down": 0,
"is_lost": 0
},
"paid": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": 0,
"pos_51_60": 0,
"pos_61_70": 0,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 0,
"etv": 0,
"count": 0,
"estimated_paid_traffic_cost": 0,
"is_new": 0,
"is_up": 0,
"is_down": 0,
"is_lost": 0
},
"featured_snippet": null,
"local_pack": null
}
},
"metrics_difference": {
"organic": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": -1,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": -1,
"pos_41_50": -2,
"pos_51_60": -1,
"pos_61_70": 0,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 0,
"etv": -1.8916626204550264,
"count": -5,
"estimated_paid_traffic_cost": 0,
"is_new": -1,
"is_up": -1,
"is_down": -2,
"is_lost": -1
},
"paid": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": 0,
"pos_51_60": 0,
"pos_61_70": 0,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 0,
"etv": 0,
"count": 0,
"estimated_paid_traffic_cost": 0,
"is_new": 0,
"is_up": 0,
"is_down": 0,
"is_lost": 0
},
"featured_snippet": null,
"local_pack": null
}
},
{
"se_type": "google",
"top_categories": [
13418
],
"organic_etv": 4187428.2685931176,
"organic_count": 11,
"organic_is_lost": 3,
"organic_is_new": 5,
"domain": "mapper.ai",
"main_domain": "mapper.ai",
"metrics_history": {
"202106": {
"organic": {
"pos_1": 2,
"pos_2_3": 2,
"pos_4_10": 1,
"pos_11_20": 4,
"pos_21_30": 1,
"pos_31_40": 0,
"pos_41_50": 4,
"pos_51_60": 3,
"pos_61_70": 3,
"pos_71_80": 0,
"pos_81_90": 1,
"pos_91_100": 4,
"etv": 493487.4017443705,
"count": 24,
"estimated_paid_traffic_cost": 268583.97597303207,
"is_new": 5,
"is_up": 3,
"is_down": 9,
"is_lost": 4
},
"paid": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": 0,
"pos_51_60": 0,
"pos_61_70": 0,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 0,
"etv": 0,
"count": 0,
"estimated_paid_traffic_cost": 0,
"is_new": 0,
"is_up": 0,
"is_down": 0,
"is_lost": 0
},
"featured_snippet": null,
"local_pack": null
},
"202110": {
"organic": {
"pos_1": 6,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 1,
"pos_21_30": 1,
"pos_31_40": 3,
"pos_41_50": 2,
"pos_51_60": 1,
"pos_61_70": 0,
"pos_71_80": 3,
"pos_81_90": 0,
"pos_91_100": 0,
"etv": 4187674.754974965,
"count": 18,
"estimated_paid_traffic_cost": 2635470.2041639984,
"is_new": 5,
"is_up": 4,
"is_down": 3,
"is_lost": 6
},
"paid": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": 0,
"pos_51_60": 0,
"pos_61_70": 0,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 0,
"etv": 0,
"count": 0,
"estimated_paid_traffic_cost": 0,
"is_new": 0,
"is_up": 0,
"is_down": 0,
"is_lost": 0
},
"featured_snippet": null,
"local_pack": null
}
},
"metrics_difference": {
"organic": {
"pos_1": 4,
"pos_2_3": -2,
"pos_4_10": -1,
"pos_11_20": -3,
"pos_21_30": 0,
"pos_31_40": 3,
"pos_41_50": -2,
"pos_51_60": -2,
"pos_61_70": -3,
"pos_71_80": 3,
"pos_81_90": -1,
"pos_91_100": -4,
"etv": 3694187.3532305947,
"count": -6,
"estimated_paid_traffic_cost": 2366886.2281909664,
"is_new": 0,
"is_up": 1,
"is_down": -6,
"is_lost": 3
},
"paid": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": 0,
"pos_51_60": 0,
"pos_61_70": 0,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 0,
"etv": 0,
"count": 0,
"estimated_paid_traffic_cost": 0,
"is_new": 0,
"is_up": 0,
"is_down": 0,
"is_lost": 0
},
"featured_snippet": null,
"local_pack": null
}
},
{
"se_type": "google",
"top_categories": [
13418
],
"organic_etv": 2974700.5460000057,
"organic_count": 13,
"organic_is_lost": 4,
"organic_is_new": 5,
"domain": "sukanyamotor.com",
"main_domain": "sukanyamotor.com",
"metrics_history": {
"202106": {
"organic": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 1,
"pos_21_30": 0,
"pos_31_40": 5,
"pos_41_50": 2,
"pos_51_60": 5,
"pos_61_70": 2,
"pos_71_80": 4,
"pos_81_90": 1,
"pos_91_100": 1,
"etv": 0.167415437489748,
"count": 20,
"estimated_paid_traffic_cost": 0,
"is_new": 3,
"is_up": 0,
"is_down": 9,
"is_lost": 2
},
"paid": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": 0,
"pos_51_60": 0,
"pos_61_70": 0,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 0,
"etv": 0,
"count": 0,
"estimated_paid_traffic_cost": 0,
"is_new": 0,
"is_up": 0,
"is_down": 0,
"is_lost": 0
},
"featured_snippet": null,
"local_pack": null
},
"202110": {
"organic": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 1,
"pos_31_40": 1,
"pos_41_50": 0,
"pos_51_60": 1,
"pos_61_70": 3,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 1,
"etv": 0.18899999931454659,
"count": 8,
"estimated_paid_traffic_cost": 0,
"is_new": 0,
"is_up": 0,
"is_down": 1,
"is_lost": 11
},
"paid": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": 0,
"pos_51_60": 0,
"pos_61_70": 0,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 0,
"etv": 0,
"count": 0,
"estimated_paid_traffic_cost": 0,
"is_new": 0,
"is_up": 0,
"is_down": 0,
"is_lost": 0
},
"featured_snippet": null,
"local_pack": null
}
},
"metrics_difference": {
"organic": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": -1,
"pos_21_30": 1,
"pos_31_40": -4,
"pos_41_50": -2,
"pos_51_60": -4,
"pos_61_70": 1,
"pos_71_80": -4,
"pos_81_90": -1,
"pos_91_100": 0,
"etv": 0.021584561824798593,
"count": -12,
"estimated_paid_traffic_cost": 0,
"is_new": -3,
"is_up": 0,
"is_down": -8,
"is_lost": 9
},
"paid": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": 0,
"pos_51_60": 0,
"pos_61_70": 0,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 0,
"etv": 0,
"count": 0,
"estimated_paid_traffic_cost": 0,
"is_new": 0,
"is_up": 0,
"is_down": 0,
"is_lost": 0
},
"featured_snippet": null,
"local_pack": null
}
},
{
"se_type": "google",
"top_categories": [
13418
],
"organic_etv": 1402780.209701458,
"organic_count": 162,
"organic_is_lost": 47,
"organic_is_new": 38,
"domain": "www.smsclub.org",
"main_domain": "smsclub.org",
"metrics_history": {
"202106": {
"organic": {
"pos_1": 2,
"pos_2_3": 11,
"pos_4_10": 15,
"pos_11_20": 21,
"pos_21_30": 23,
"pos_31_40": 30,
"pos_41_50": 19,
"pos_51_60": 15,
"pos_61_70": 30,
"pos_71_80": 21,
"pos_81_90": 20,
"pos_91_100": 16,
"etv": 45814.954401240444,
"count": 224,
"estimated_paid_traffic_cost": 13128.85142590595,
"is_new": 58,
"is_up": 31,
"is_down": 57,
"is_lost": 65
},
"paid": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": 0,
"pos_51_60": 0,
"pos_61_70": 0,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 0,
"etv": 0,
"count": 0,
"estimated_paid_traffic_cost": 0,
"is_new": 0,
"is_up": 0,
"is_down": 0,
"is_lost": 0
},
"featured_snippet": null,
"local_pack": null
},
"202110": {
"organic": {
"pos_1": 6,
"pos_2_3": 9,
"pos_4_10": 13,
"pos_11_20": 20,
"pos_21_30": 29,
"pos_31_40": 22,
"pos_41_50": 23,
"pos_51_60": 26,
"pos_61_70": 27,
"pos_71_80": 24,
"pos_81_90": 20,
"pos_91_100": 11,
"etv": 109328.74248140678,
"count": 230,
"estimated_paid_traffic_cost": 13461.960159298033,
"is_new": 62,
"is_up": 86,
"is_down": 42,
"is_lost": 96
},
"paid": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": 0,
"pos_51_60": 0,
"pos_61_70": 0,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 0,
"etv": 0,
"count": 0,
"estimated_paid_traffic_cost": 0,
"is_new": 0,
"is_up": 0,
"is_down": 0,
"is_lost": 0
},
"featured_snippet": null,
"local_pack": null
}
},
"metrics_difference": {
"organic": {
"pos_1": 4,
"pos_2_3": -2,
"pos_4_10": -3,
"pos_11_20": -2,
"pos_21_30": 6,
"pos_31_40": -8,
"pos_41_50": 4,
"pos_51_60": 10,
"pos_61_70": -3,
"pos_71_80": 3,
"pos_81_90": 0,
"pos_91_100": -5,
"etv": 63513.788080166334,
"count": 6,
"estimated_paid_traffic_cost": 333.1087333920823,
"is_new": 4,
"is_up": 56,
"is_down": -14,
"is_lost": 31
},
"paid": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": 0,
"pos_51_60": 0,
"pos_61_70": 0,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 0,
"etv": 0,
"count": 0,
"estimated_paid_traffic_cost": 0,
"is_new": 0,
"is_up": 0,
"is_down": 0,
"is_lost": 0
},
"featured_snippet": null,
"local_pack": null
}
},
{
"se_type": "google",
"top_categories": [
13418
],
"organic_etv": 1211985.149004802,
"organic_count": 6,
"organic_is_lost": 2,
"organic_is_new": 2,
"domain": "www.ok-look.com",
"main_domain": "ok-look.com",
"metrics_history": {
"202106": {
"organic": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": 0,
"pos_51_60": 0,
"pos_61_70": 0,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 0,
"etv": 0,
"count": 0,
"estimated_paid_traffic_cost": 0,
"is_new": 0,
"is_up": 0,
"is_down": 0,
"is_lost": 0
},
"paid": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": 0,
"pos_51_60": 0,
"pos_61_70": 0,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 0,
"etv": 0,
"count": 0,
"estimated_paid_traffic_cost": 0,
"is_new": 0,
"is_up": 0,
"is_down": 0,
"is_lost": 0
},
"featured_snippet": null,
"local_pack": null
},
"202110": {
"organic": {
"pos_1": 1,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": 0,
"pos_51_60": 0,
"pos_61_70": 2,
"pos_71_80": 0,
"pos_81_90": 1,
"pos_91_100": 1,
"etv": 269.0739890355617,
"count": 6,
"estimated_paid_traffic_cost": 211.9729461669922,
"is_new": 0,
"is_up": 0,
"is_down": 0,
"is_lost": 8
},
"paid": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": 0,
"pos_51_60": 0,
"pos_61_70": 0,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 0,
"etv": 0,
"count": 0,
"estimated_paid_traffic_cost": 0,
"is_new": 0,
"is_up": 0,
"is_down": 0,
"is_lost": 0
},
"featured_snippet": null,
"local_pack": null
}
},
"metrics_difference": {
"organic": {
"pos_1": 1,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": 0,
"pos_51_60": 0,
"pos_61_70": 2,
"pos_71_80": 0,
"pos_81_90": 1,
"pos_91_100": 1,
"etv": 269.0739890355617,
"count": 6,
"estimated_paid_traffic_cost": 211.9729461669922,
"is_new": 0,
"is_up": 0,
"is_down": 0,
"is_lost": 8
},
"paid": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": 0,
"pos_51_60": 0,
"pos_61_70": 0,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 0,
"etv": 0,
"count": 0,
"estimated_paid_traffic_cost": 0,
"is_new": 0,
"is_up": 0,
"is_down": 0,
"is_lost": 0
},
"featured_snippet": null,
"local_pack": null
}
},
{
"se_type": "google",
"top_categories": [
13418
],
"organic_etv": 1020108.8869997021,
"organic_count": 85,
"organic_is_lost": 17,
"organic_is_new": 30,
"domain": "www.gloglocreations.com",
"main_domain": "gloglocreations.com",
"metrics_history": {
"202106": {
"organic": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 2,
"pos_11_20": 6,
"pos_21_30": 4,
"pos_31_40": 4,
"pos_41_50": 7,
"pos_51_60": 10,
"pos_61_70": 11,
"pos_71_80": 11,
"pos_81_90": 9,
"pos_91_100": 1,
"etv": 273878.77110720647,
"count": 63,
"estimated_paid_traffic_cost": 377962.7776209651,
"is_new": 13,
"is_up": 14,
"is_down": 23,
"is_lost": 14
},
"paid": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": 0,
"pos_51_60": 0,
"pos_61_70": 0,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 0,
"etv": 0,
"count": 0,
"estimated_paid_traffic_cost": 0,
"is_new": 0,
"is_up": 0,
"is_down": 0,
"is_lost": 0
},
"featured_snippet": null,
"local_pack": null
},
"202110": {
"organic": {
"pos_1": 1,
"pos_2_3": 0,
"pos_4_10": 2,
"pos_11_20": 12,
"pos_21_30": 7,
"pos_31_40": 10,
"pos_41_50": 11,
"pos_51_60": 9,
"pos_61_70": 8,
"pos_71_80": 2,
"pos_81_90": 4,
"pos_91_100": 1,
"etv": 62.970240546390414,
"count": 68,
"estimated_paid_traffic_cost": 96.47423016559333,
"is_new": 11,
"is_up": 15,
"is_down": 20,
"is_lost": 54
},
"paid": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": 0,
"pos_51_60": 0,
"pos_61_70": 0,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 0,
"etv": 0,
"count": 0,
"estimated_paid_traffic_cost": 0,
"is_new": 0,
"is_up": 0,
"is_down": 0,
"is_lost": 0
},
"featured_snippet": null,
"local_pack": null
}
},
"metrics_difference": {
"organic": {
"pos_1": 1,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 6,
"pos_21_30": 3,
"pos_31_40": 6,
"pos_41_50": 4,
"pos_51_60": -1,
"pos_61_70": -3,
"pos_71_80": -8,
"pos_81_90": -5,
"pos_91_100": 0,
"etv": -273815.8008666601,
"count": 5,
"estimated_paid_traffic_cost": -377866.3033907995,
"is_new": -2,
"is_up": 1,
"is_down": -3,
"is_lost": 39
},
"paid": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": 0,
"pos_51_60": 0,
"pos_61_70": 0,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 0,
"etv": 0,
"count": 0,
"estimated_paid_traffic_cost": 0,
"is_new": 0,
"is_up": 0,
"is_down": 0,
"is_lost": 0
},
"featured_snippet": null,
"local_pack": null
}
},
{
"se_type": "google",
"top_categories": [
13418
],
"organic_etv": 1017957.7810519375,
"organic_count": 30,
"organic_is_lost": 14,
"organic_is_new": 54,
"domain": "translate.google.cat",
"main_domain": "google.cat",
"metrics_history": {
"202106": {
"organic": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 4,
"pos_11_20": 4,
"pos_21_30": 2,
"pos_31_40": 0,
"pos_41_50": 1,
"pos_51_60": 1,
"pos_61_70": 3,
"pos_71_80": 0,
"pos_81_90": 2,
"pos_91_100": 0,
"etv": 2266.82128180328,
"count": 16,
"estimated_paid_traffic_cost": 2172.532720726464,
"is_new": 6,
"is_up": 2,
"is_down": 3,
"is_lost": 4
},
"paid": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": 0,
"pos_51_60": 0,
"pos_61_70": 0,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 0,
"etv": 0,
"count": 0,
"estimated_paid_traffic_cost": 0,
"is_new": 0,
"is_up": 0,
"is_down": 0,
"is_lost": 0
},
"featured_snippet": null,
"local_pack": null
},
"202110": {
"organic": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 10,
"pos_11_20": 8,
"pos_21_30": 8,
"pos_31_40": 6,
"pos_41_50": 2,
"pos_51_60": 6,
"pos_61_70": 2,
"pos_71_80": 6,
"pos_81_90": 2,
"pos_91_100": 1,
"etv": 141871.08199761435,
"count": 51,
"estimated_paid_traffic_cost": 117672.4290858563,
"is_new": 11,
"is_up": 8,
"is_down": 1,
"is_lost": 39
},
"paid": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": 0,
"pos_51_60": 0,
"pos_61_70": 0,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 0,
"etv": 0,
"count": 0,
"estimated_paid_traffic_cost": 0,
"is_new": 0,
"is_up": 0,
"is_down": 0,
"is_lost": 0
},
"featured_snippet": null,
"local_pack": null
}
},
"metrics_difference": {
"organic": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 6,
"pos_11_20": 4,
"pos_21_30": 6,
"pos_31_40": 6,
"pos_41_50": 1,
"pos_51_60": 5,
"pos_61_70": -1,
"pos_71_80": 6,
"pos_81_90": 0,
"pos_91_100": 1,
"etv": 139604.26071581108,
"count": 34,
"estimated_paid_traffic_cost": 115499.89636512984,
"is_new": 5,
"is_up": 6,
"is_down": -2,
"is_lost": 36
},
"paid": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": 0,
"pos_51_60": 0,
"pos_61_70": 0,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 0,
"etv": 0,
"count": 0,
"estimated_paid_traffic_cost": 0,
"is_new": 0,
"is_up": 0,
"is_down": 0,
"is_lost": 0
},
"featured_snippet": null,
"local_pack": null
}
},
{
"se_type": "google",
"top_categories": [
13418
],
"organic_etv": 889470.1484831125,
"organic_count": 23,
"organic_is_lost": 8,
"organic_is_new": 5,
"domain": "kioncommunity.force.com",
"main_domain": "force.com",
"metrics_history": {
"202106": {
"organic": {
"pos_1": 1,
"pos_2_3": 0,
"pos_4_10": 3,
"pos_11_20": 1,
"pos_21_30": 1,
"pos_31_40": 0,
"pos_41_50": 4,
"pos_51_60": 3,
"pos_61_70": 2,
"pos_71_80": 2,
"pos_81_90": 1,
"pos_91_100": 1,
"etv": 264685.6996521438,
"count": 18,
"estimated_paid_traffic_cost": 306906.21235541865,
"is_new": 5,
"is_up": 4,
"is_down": 5,
"is_lost": 4
},
"paid": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": 0,
"pos_51_60": 0,
"pos_61_70": 0,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 0,
"etv": 0,
"count": 0,
"estimated_paid_traffic_cost": 0,
"is_new": 0,
"is_up": 0,
"is_down": 0,
"is_lost": 0
},
"featured_snippet": null,
"local_pack": null
},
"202110": {
"organic": {
"pos_1": 1,
"pos_2_3": 1,
"pos_4_10": 0,
"pos_11_20": 7,
"pos_21_30": 1,
"pos_31_40": 0,
"pos_41_50": 1,
"pos_51_60": 2,
"pos_61_70": 3,
"pos_71_80": 2,
"pos_81_90": 5,
"pos_91_100": 0,
"etv": 889486.2211783268,
"count": 24,
"estimated_paid_traffic_cost": 1871624.7977938503,
"is_new": 4,
"is_up": 9,
"is_down": 2,
"is_lost": 13
},
"paid": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": 0,
"pos_51_60": 0,
"pos_61_70": 0,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 0,
"etv": 0,
"count": 0,
"estimated_paid_traffic_cost": 0,
"is_new": 0,
"is_up": 0,
"is_down": 0,
"is_lost": 0
},
"featured_snippet": null,
"local_pack": null
}
},
"metrics_difference": {
"organic": {
"pos_1": 0,
"pos_2_3": 1,
"pos_4_10": -3,
"pos_11_20": 6,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": -3,
"pos_51_60": -1,
"pos_61_70": 1,
"pos_71_80": 0,
"pos_81_90": 4,
"pos_91_100": -1,
"etv": 624800.521526183,
"count": 5,
"estimated_paid_traffic_cost": 1564718.5854384317,
"is_new": -1,
"is_up": 5,
"is_down": -3,
"is_lost": 8
},
"paid": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": 0,
"pos_51_60": 0,
"pos_61_70": 0,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 0,
"etv": 0,
"count": 0,
"estimated_paid_traffic_cost": 0,
"is_new": 0,
"is_up": 0,
"is_down": 0,
"is_lost": 0
},
"featured_snippet": null,
"local_pack": null
}
},
{
"se_type": "google",
"top_categories": [
13418
],
"organic_etv": 662081.4699661639,
"organic_count": 258,
"organic_is_lost": 34,
"organic_is_new": 40,
"domain": "www.goole.com",
"main_domain": "goole.com",
"metrics_history": {
"202110": {
"organic": {
"pos_1": 0,
"pos_2_3": 3,
"pos_4_10": 10,
"pos_11_20": 14,
"pos_21_30": 10,
"pos_31_40": 13,
"pos_41_50": 8,
"pos_51_60": 6,
"pos_61_70": 9,
"pos_71_80": 5,
"pos_81_90": 6,
"pos_91_100": 3,
"etv": 122270.12978660502,
"count": 87,
"estimated_paid_traffic_cost": 176972.1090389639,
"is_new": 14,
"is_up": 18,
"is_down": 13,
"is_lost": 76
},
"paid": {
"pos_1": 0,
"pos_2_3": 0,
"pos_4_10": 0,
"pos_11_20": 0,
"pos_21_30": 0,
"pos_31_40": 0,
"pos_41_50": 0,
"pos_51_60": 0,
"pos_61_70": 0,
"pos_71_80": 0,
"pos_81_90": 0,
"pos_91_100": 0,
"etv": 0,
"count": 0,
"estimated_paid_traffic_cost": 0,
"is_new": 0,
"is_up": 0,
"is_down": 0,
"is_lost": 0
},
"featured_snippet": null,
"local_pack": null
}
}
}
]
}
]
}
]
}
Note: the API response will provide a list of domains relevant to the exact categories you indicated. Consequently, if you specify one category in a POST request, you will get domains relevant to that one category only. Domains that are relevant to two or more categories will not be included in the response. To expand the list without specifying additional categories in a POST request, you should use the top_categories_count parameter. Learn how it works in this help center guide.
As you can see in the response above, the API provides four current metrics (organic_etv, organic_count, organic_is_lost, and organic_is_new) — all the other metrics are historical and provided for indicated dates.
The dates you specified will be displayed in the YYYYMM format. Below them, you will find the metrics_difference parameter that provides the dynamics of domain metrics.
As mentioned above, you can specify the dates in any order: first_date can be greater than second_date and vice versa. In the API response, the first displayed date will always be the one that is greater. What’s important, when calculating metrics_difference for a domain, the API will always subtract the metrics as of the greater date from the ones as of the smaller date.
For example, if a domain had an organic estimated traffic value (ETV) of 216.35684056393802 on 202106 and 335.55784956083563 on 202104, the metrics_difference in organic ETV would be:
216.35684056393802 – 335.55784956083563 = -119.201008997
The same calculation is performed for each historical metric in the response.
Advanced parameters
You can get more specific results by using several advanced parameters when setting a task:
etv_min— minimum current organic ETV of the domain. If specified, the API will return only domains withorganic_etvgreater than the specified value.etv_max— maximum current organic ETV of the domain. If specified, the API will return only domains withorganic_etvlesser than the specified value.top_categories_count— number of additional domain categories. By using this parameter, you can receive domains relevant to additional categories that are not specified incategory_codes. Refer to this guide to learn more.include_subdomains— whether to include or exclude subdomains. Iffalse, the API response will containmain_domainonly. Iftrue, the API will returnmain_domainplus its subdomains (if available). By default, the parameter is set totrue.item_types— indicates the type of search results included in the response. By default, the API provides data from organic and paid search. You can also receive data from featured snippets and local packs by specifying the parameter as"item_types": ["organic", "paid", "featured_snippet", "local_pack"].filters— you can filter domains by using several filtering parameters. For example, you can make the API display domains that had organic ETV greater than 250 on one of the specified date:"filters": ["metrics_history.202110.organic.etv", ">", 2500]. To learn more about using filters with DataForSEO Labs API, please refer to this help center article.order_by— instead of filtering domains, you can order them by different values, using the same rules as in the filters array to sort the results. Learn more in this guide.