With DataForSEO Labs API endpoints, you can sort your results by virtually any metric from the returned dataset. You can sort the results either in ascending or descending order (asc and desc respectively).
Let’s take the Keyword Suggestions endpoint, for example. This endpoint provides keyword suggestions for seed keywords specified in the keyword field of the Task POST array. Along with keyword ideas, it offers valuable keyword metrics, such as search volume, cpc, competition, and others.
Suppose you want to get keywords with high search volumes first. To receive them, all you have to do is add the order_by array to the Task POST body and apply the right sorting rule in it — in our case ["keyword_info.search_volume,desc"].
Your POST request should be structured as in the example below:
[
{
"keyword": "purchase laptop",
"language_name": "English",
"location_code": 2840,
"order_by": ["keyword_info.search_volume,desc"],
"limit": 10
}
]
In the API response, you will find suggested keywords sorted by search volume in descending order.
{
"version": "0.1.20220216",
"status_code": 20000,
"status_message": "Ok.",
"time": "1.7989 sec.",
"cost": 0.011,
"tasks_count": 1,
"tasks_error": 0,
"tasks": [
{
"id": "03211229-2806-0399-0000-3da22295c270",
"status_code": 20000,
"status_message": "Ok.",
"time": "1.7479 sec.",
"cost": 0.011,
"result_count": 1,
"path": [
"v3",
"dataforseo_labs",
"google",
"keyword_suggestions",
"live"
],
"data": {
"api": "dataforseo_labs",
"function": "keyword_suggestions",
"se_type": "google",
"keyword": "purchase laptop",
"language_name": "English",
"location_code": 2840,
"order_by": [
"keyword_info.search_volume,desc"
],
"limit": 10
},
"result": [
{
"se_type": "google",
"seed_keyword": "purchase laptop",
"seed_keyword_data": null,
"location_code": 2840,
"language_code": "en",
"total_count": 276,
"items_count": 10,
"offset": 0,
"offset_token": "eyJDdXJyZW50T2Zmc2V0IjoxMCwiUmVxdWVzdERhdGEiOnsia2V5d29yZCI6InB1cmNoYXNlIGxhcHRvcCIsImluY2x1ZGVfc2VlZF9rZXl3b3JkIjpmYWxzZSwiZnVsbF9tYXRjaCI6ZmFsc2UsImxvYWRfc2VycF9pbmZvIjpmYWxzZSwic2VhcmNoX2FmdGVyX3Rva2VuIjpudWxsLCJsYW5ndWFnZSI6ImVuIiwic2VhcmNoX2VuZ2luZSI6Imdvb2dsZSIsImxvY2F0aW9uIjoyODQwLCJvcmRlcl9ieSI6eyJvcmRlcl9maWVsZCI6ImtleXdvcmRfaW5mby5zZWFyY2hfdm9sdW1lIiwib3JkZXJfdHlwZSI6IkRlc2MiLCJuZXh0IjpudWxsfSwibGltaXQiOjEwLCJvZmZzZXQiOjAsIlRva2VuIjp7IklzQ2FuY2VsbGF0aW9uUmVxdWVzdGVkIjpmYWxzZSwiQ2FuQmVDYW5jZWxlZCI6dHJ1ZSwiV2FpdEhhbmRsZSI6eyJIYW5kbGUiOnsidmFsdWUiOjM1NDh9LCJTYWZlV2FpdEhhbmRsZSI6eyJJc0ludmFsaWQiOmZhbHNlLCJJc0Nsb3NlZCI6ZmFsc2V9fX19LCJSYXdRdWVyeSI6bnVsbCwiU2VhcmNoQWZ0ZXJEYXRhIjpbNDAsIjNhYTIyYmVkLTc5ZmMtYTk1Yi04NjQyLTUzYzE5OTAyOTQ2MyJdfQ==",
"items": [
{
"se_type": "google",
"keyword": "purchase a laptop",
"location_code": 2840,
"language_code": "en",
"keyword_info": {
"se_type": "google",
"last_updated_time": "2022-03-18 08:04:37 +00:00",
"competition": 0.9947686116700201,
"cpc": 8.47968,
"search_volume": 390,
"categories": [
10019,
10168,
10883,
12187,
13069,
13070
],
"monthly_searches": [
{
"year": 2022,
"month": 2,
"search_volume": 390
},
{
"year": 2022,
"month": 1,
"search_volume": 390
},
{
"year": 2021,
"month": 12,
"search_volume": 260
},
{
"year": 2021,
"month": 11,
"search_volume": 320
},
{
"year": 2021,
"month": 10,
"search_volume": 390
},
{
"year": 2021,
"month": 9,
"search_volume": 320
},
{
"year": 2021,
"month": 8,
"search_volume": 390
},
{
"year": 2021,
"month": 7,
"search_volume": 390
},
{
"year": 2021,
"month": 6,
"search_volume": 390
},
{
"year": 2021,
"month": 5,
"search_volume": 390
},
{
"year": 2021,
"month": 4,
"search_volume": 480
},
{
"year": 2021,
"month": 3,
"search_volume": 480
}
]
},
"keyword_properties": {
"se_type": "google",
"core_keyword": "purchase laptop",
"keyword_difficulty": 100
},
"impressions_info": {
"se_type": "google",
"last_updated_time": "2022-03-20 23:34:17 +00:00",
"bid": 999,
"match_type": "exact",
"ad_position_min": 1.74,
"ad_position_max": 1,
"ad_position_average": 1.59,
"cpc_min": 359.48,
"cpc_max": 439.37,
"cpc_average": 399.42,
"daily_impressions_min": 15.9,
"daily_impressions_max": 19.43,
"daily_impressions_average": 17.66,
"daily_clicks_min": 0.78,
"daily_clicks_max": 0.95,
"daily_clicks_average": 0.86,
"daily_cost_min": 310.77,
"daily_cost_max": 379.83,
"daily_cost_average": 345.3
},
"serp_info": null
},
{
"se_type": "google",
"keyword": "laptop to purchase",
"location_code": 2840,
"language_code": "en",
"keyword_info": {
"se_type": "google",
"last_updated_time": "2022-03-19 05:37:29 +00:00",
"competition": 0.9947686116700201,
"cpc": 8.47968,
"search_volume": 390,
"categories": [
10003,
10019,
10040,
10042,
10168,
10883,
12187
],
"monthly_searches": [
{
"year": 2022,
"month": 2,
"search_volume": 390
},
{
"year": 2022,
"month": 1,
"search_volume": 390
},
{
"year": 2021,
"month": 12,
"search_volume": 260
},
{
"year": 2021,
"month": 11,
"search_volume": 320
},
{
"year": 2021,
"month": 10,
"search_volume": 390
},
{
"year": 2021,
"month": 9,
"search_volume": 320
},
{
"year": 2021,
"month": 8,
"search_volume": 390
},
{
"year": 2021,
"month": 7,
"search_volume": 390
},
{
"year": 2021,
"month": 6,
"search_volume": 390
},
{
"year": 2021,
"month": 5,
"search_volume": 390
},
{
"year": 2021,
"month": 4,
"search_volume": 480
},
{
"year": 2021,
"month": 3,
"search_volume": 480
}
]
},
"keyword_properties": {
"se_type": "google",
"core_keyword": null,
"keyword_difficulty": 98
},
"impressions_info": {
"se_type": "google",
"last_updated_time": "2022-03-09 02:54:10 +00:00",
"bid": 999,
"match_type": "exact",
"ad_position_min": null,
"ad_position_max": null,
"ad_position_average": null,
"cpc_min": null,
"cpc_max": null,
"cpc_average": null,
"daily_impressions_min": null,
"daily_impressions_max": null,
"daily_impressions_average": null,
"daily_clicks_min": null,
"daily_clicks_max": null,
"daily_clicks_average": null,
"daily_cost_min": null,
"daily_cost_max": null,
"daily_cost_average": null
},
"serp_info": null
},
{
"se_type": "google",
"keyword": "laptop purchase",
"location_code": 2840,
"language_code": "en",
"keyword_info": {
"se_type": "google",
"last_updated_time": "2022-02-11 22:37:06 +00:00",
"competition": 1,
"cpc": 7.599445,
"search_volume": 390,
"categories": [
10019,
10168,
10883,
12187,
13069,
13070
],
"monthly_searches": [
{
"year": 2022,
"month": 1,
"search_volume": 390
},
{
"year": 2021,
"month": 12,
"search_volume": 260
},
{
"year": 2021,
"month": 11,
"search_volume": 320
},
{
"year": 2021,
"month": 10,
"search_volume": 390
},
{
"year": 2021,
"month": 9,
"search_volume": 320
},
{
"year": 2021,
"month": 8,
"search_volume": 390
},
{
"year": 2021,
"month": 7,
"search_volume": 390
},
{
"year": 2021,
"month": 6,
"search_volume": 390
},
{
"year": 2021,
"month": 5,
"search_volume": 390
},
{
"year": 2021,
"month": 4,
"search_volume": 480
},
{
"year": 2021,
"month": 3,
"search_volume": 480
},
{
"year": 2021,
"month": 2,
"search_volume": 390
}
]
},
"keyword_properties": {
"se_type": "google",
"core_keyword": "purchase laptop",
"keyword_difficulty": 80
},
"impressions_info": {
"se_type": "google",
"last_updated_time": "2022-03-16 15:18:04 +00:00",
"bid": 999,
"match_type": "exact",
"ad_position_min": 1.46,
"ad_position_max": 1,
"ad_position_average": 1.33,
"cpc_min": 176.26,
"cpc_max": 215.43,
"cpc_average": 195.84,
"daily_impressions_min": 2.57,
"daily_impressions_max": 3.14,
"daily_impressions_average": 2.85,
"daily_clicks_min": 0.23,
"daily_clicks_max": 0.28,
"daily_clicks_average": 0.25,
"daily_cost_min": 44.9,
"daily_cost_max": 54.88,
"daily_cost_average": 49.89
},
"serp_info": null
},
{
"se_type": "google",
"keyword": "purchase laptop",
"location_code": 2840,
"language_code": "en",
"keyword_info": {
"se_type": "google",
"last_updated_time": "2022-02-13 03:12:22 +00:00",
"competition": 1,
"cpc": 7.599445,
"search_volume": 390,
"categories": [
10019,
10168,
10883,
12187,
13069,
13070
],
"monthly_searches": [
{
"year": 2022,
"month": 1,
"search_volume": 390
},
{
"year": 2021,
"month": 12,
"search_volume": 260
},
{
"year": 2021,
"month": 11,
"search_volume": 320
},
{
"year": 2021,
"month": 10,
"search_volume": 390
},
{
"year": 2021,
"month": 9,
"search_volume": 320
},
{
"year": 2021,
"month": 8,
"search_volume": 390
},
{
"year": 2021,
"month": 7,
"search_volume": 390
},
{
"year": 2021,
"month": 6,
"search_volume": 390
},
{
"year": 2021,
"month": 5,
"search_volume": 390
},
{
"year": 2021,
"month": 4,
"search_volume": 480
},
{
"year": 2021,
"month": 3,
"search_volume": 480
},
{
"year": 2021,
"month": 2,
"search_volume": 390
}
]
},
"keyword_properties": {
"se_type": "google",
"core_keyword": null,
"keyword_difficulty": 100
},
"impressions_info": {
"se_type": "google",
"last_updated_time": "2022-03-17 05:37:54 +00:00",
"bid": 999,
"match_type": "exact",
"ad_position_min": 1.6,
"ad_position_max": 1,
"ad_position_average": 1.45,
"cpc_min": 367.13,
"cpc_max": 448.71,
"cpc_average": 407.92,
"daily_impressions_min": 128.15,
"daily_impressions_max": 156.63,
"daily_impressions_average": 142.39,
"daily_clicks_min": 6.98,
"daily_clicks_max": 8.53,
"daily_clicks_average": 7.75,
"daily_cost_min": 2845.89,
"daily_cost_max": 3478.31,
"daily_cost_average": 3162.1
},
"serp_info": null
},
{
"se_type": "google",
"keyword": "best laptop purchase",
"location_code": 2840,
"language_code": "en",
"keyword_info": {
"se_type": "google",
"last_updated_time": "2022-02-13 21:21:08 +00:00",
"competition": 1,
"cpc": 2.077209,
"search_volume": 110,
"categories": [
10002,
10019,
10028,
10168,
10222,
10883,
12187,
12199,
13813
],
"monthly_searches": [
{
"year": 2022,
"month": 1,
"search_volume": 110
},
{
"year": 2021,
"month": 12,
"search_volume": 70
},
{
"year": 2021,
"month": 11,
"search_volume": 140
},
{
"year": 2021,
"month": 10,
"search_volume": 110
},
{
"year": 2021,
"month": 9,
"search_volume": 110
},
{
"year": 2021,
"month": 8,
"search_volume": 110
},
{
"year": 2021,
"month": 7,
"search_volume": 90
},
{
"year": 2021,
"month": 6,
"search_volume": 90
},
{
"year": 2021,
"month": 5,
"search_volume": 140
},
{
"year": 2021,
"month": 4,
"search_volume": 90
},
{
"year": 2021,
"month": 3,
"search_volume": 140
},
{
"year": 2021,
"month": 2,
"search_volume": 140
}
]
},
"keyword_properties": {
"se_type": "google",
"core_keyword": "best laptop to purchase",
"keyword_difficulty": 94
},
"impressions_info": {
"se_type": "google",
"last_updated_time": "2022-03-17 15:28:56 +00:00",
"bid": 999,
"match_type": "exact",
"ad_position_min": null,
"ad_position_max": null,
"ad_position_average": null,
"cpc_min": null,
"cpc_max": null,
"cpc_average": null,
"daily_impressions_min": null,
"daily_impressions_max": null,
"daily_impressions_average": null,
"daily_clicks_min": null,
"daily_clicks_max": null,
"daily_clicks_average": null,
"daily_cost_min": null,
"daily_cost_max": null,
"daily_cost_average": null
},
"serp_info": null
},
{
"se_type": "google",
"keyword": "best laptop to purchase",
"location_code": 2840,
"language_code": "en",
"keyword_info": {
"se_type": "google",
"last_updated_time": "2022-03-15 12:27:54 +00:00",
"competition": 1,
"cpc": 4.731863,
"search_volume": 110,
"categories": [
10002,
10019,
10028,
10168,
10222,
10883,
12187,
12199,
13813
],
"monthly_searches": [
{
"year": 2022,
"month": 2,
"search_volume": 90
},
{
"year": 2022,
"month": 1,
"search_volume": 110
},
{
"year": 2021,
"month": 12,
"search_volume": 70
},
{
"year": 2021,
"month": 11,
"search_volume": 140
},
{
"year": 2021,
"month": 10,
"search_volume": 110
},
{
"year": 2021,
"month": 9,
"search_volume": 110
},
{
"year": 2021,
"month": 8,
"search_volume": 110
},
{
"year": 2021,
"month": 7,
"search_volume": 90
},
{
"year": 2021,
"month": 6,
"search_volume": 90
},
{
"year": 2021,
"month": 5,
"search_volume": 140
},
{
"year": 2021,
"month": 4,
"search_volume": 90
},
{
"year": 2021,
"month": 3,
"search_volume": 140
}
]
},
"keyword_properties": {
"se_type": "google",
"core_keyword": null,
"keyword_difficulty": 99
},
"impressions_info": {
"se_type": "google",
"last_updated_time": "2022-03-19 01:35:00 +00:00",
"bid": 999,
"match_type": "exact",
"ad_position_min": 1.11,
"ad_position_max": 1,
"ad_position_average": 1.06,
"cpc_min": 238.86,
"cpc_max": 291.93,
"cpc_average": 265.4,
"daily_impressions_min": 1.15,
"daily_impressions_max": 1.4,
"daily_impressions_average": 1.27,
"daily_clicks_min": 0.21,
"daily_clicks_max": 0.26,
"daily_clicks_average": 0.24,
"daily_cost_min": 56.91,
"daily_cost_max": 69.55,
"daily_cost_average": 63.23
},
"serp_info": null
},
{
"se_type": "google",
"keyword": "where to purchase laptop",
"location_code": 2840,
"language_code": "en",
"keyword_info": {
"se_type": "google",
"last_updated_time": "2022-02-15 04:44:38 +00:00",
"competition": 1,
"cpc": 7.911521,
"search_volume": 50,
"categories": [
10019,
10168,
10883,
12187,
13069,
13070
],
"monthly_searches": [
{
"year": 2022,
"month": 1,
"search_volume": 50
},
{
"year": 2021,
"month": 12,
"search_volume": 50
},
{
"year": 2021,
"month": 11,
"search_volume": 70
},
{
"year": 2021,
"month": 10,
"search_volume": 30
},
{
"year": 2021,
"month": 9,
"search_volume": 40
},
{
"year": 2021,
"month": 8,
"search_volume": 110
},
{
"year": 2021,
"month": 7,
"search_volume": 40
},
{
"year": 2021,
"month": 6,
"search_volume": 40
},
{
"year": 2021,
"month": 5,
"search_volume": 50
},
{
"year": 2021,
"month": 4,
"search_volume": 90
},
{
"year": 2021,
"month": 3,
"search_volume": 90
},
{
"year": 2021,
"month": 2,
"search_volume": 40
}
]
},
"keyword_properties": {
"se_type": "google",
"core_keyword": null,
"keyword_difficulty": 74
},
"impressions_info": {
"se_type": "google",
"last_updated_time": "2022-03-18 12:03:44 +00:00",
"bid": 999,
"match_type": "exact",
"ad_position_min": null,
"ad_position_max": null,
"ad_position_average": null,
"cpc_min": null,
"cpc_max": null,
"cpc_average": null,
"daily_impressions_min": null,
"daily_impressions_max": null,
"daily_impressions_average": null,
"daily_clicks_min": null,
"daily_clicks_max": null,
"daily_clicks_average": null,
"daily_cost_min": null,
"daily_cost_max": null,
"daily_cost_average": null
},
"serp_info": null
},
{
"se_type": "google",
"keyword": "guide to purchase laptop",
"location_code": 2840,
"language_code": "en",
"keyword_info": {
"se_type": "google",
"last_updated_time": "2022-02-10 07:58:28 +00:00",
"competition": 1,
"cpc": 5.822661,
"search_volume": 40,
"categories": null,
"monthly_searches": [
{
"year": 2022,
"month": 1,
"search_volume": 40
},
{
"year": 2021,
"month": 12,
"search_volume": 30
},
{
"year": 2021,
"month": 11,
"search_volume": 50
},
{
"year": 2021,
"month": 10,
"search_volume": 20
},
{
"year": 2021,
"month": 9,
"search_volume": 40
},
{
"year": 2021,
"month": 8,
"search_volume": 30
},
{
"year": 2021,
"month": 7,
"search_volume": 30
},
{
"year": 2021,
"month": 6,
"search_volume": 40
},
{
"year": 2021,
"month": 5,
"search_volume": 30
},
{
"year": 2021,
"month": 4,
"search_volume": 40
},
{
"year": 2021,
"month": 3,
"search_volume": 50
},
{
"year": 2021,
"month": 2,
"search_volume": 40
}
]
},
"keyword_properties": {
"se_type": "google",
"core_keyword": null,
"keyword_difficulty": 70
},
"impressions_info": {
"se_type": "google",
"last_updated_time": "2022-03-15 17:39:12 +00:00",
"bid": 999,
"match_type": "exact",
"ad_position_min": null,
"ad_position_max": null,
"ad_position_average": null,
"cpc_min": null,
"cpc_max": null,
"cpc_average": null,
"daily_impressions_min": null,
"daily_impressions_max": null,
"daily_impressions_average": null,
"daily_clicks_min": null,
"daily_clicks_max": null,
"daily_clicks_average": null,
"daily_cost_min": null,
"daily_cost_max": null,
"daily_cost_average": null
},
"serp_info": null
},
{
"se_type": "google",
"keyword": "purchase a laptop computer",
"location_code": 2840,
"language_code": "en",
"keyword_info": {
"se_type": "google",
"last_updated_time": "2022-03-16 19:33:10 +00:00",
"competition": 1,
"cpc": 6.242388,
"search_volume": 40,
"categories": [
10019,
10168,
10883,
12187,
13069
],
"monthly_searches": [
{
"year": 2022,
"month": 2,
"search_volume": 20
},
{
"year": 2022,
"month": 1,
"search_volume": 70
},
{
"year": 2021,
"month": 12,
"search_volume": 50
},
{
"year": 2021,
"month": 11,
"search_volume": 30
},
{
"year": 2021,
"month": 10,
"search_volume": 40
},
{
"year": 2021,
"month": 9,
"search_volume": 30
},
{
"year": 2021,
"month": 8,
"search_volume": 50
},
{
"year": 2021,
"month": 7,
"search_volume": 30
},
{
"year": 2021,
"month": 6,
"search_volume": 40
},
{
"year": 2021,
"month": 5,
"search_volume": 30
},
{
"year": 2021,
"month": 4,
"search_volume": 40
},
{
"year": 2021,
"month": 3,
"search_volume": 30
}
]
},
"keyword_properties": {
"se_type": "google",
"core_keyword": "purchase laptop computer",
"keyword_difficulty": 82
},
"impressions_info": {
"se_type": "google",
"last_updated_time": "2022-03-19 22:26:54 +00:00",
"bid": 999,
"match_type": "exact",
"ad_position_min": 1.11,
"ad_position_max": 1,
"ad_position_average": 1.06,
"cpc_min": 13.35,
"cpc_max": 16.32,
"cpc_average": 14.83,
"daily_impressions_min": null,
"daily_impressions_max": null,
"daily_impressions_average": null,
"daily_clicks_min": null,
"daily_clicks_max": null,
"daily_clicks_average": null,
"daily_cost_min": null,
"daily_cost_max": null,
"daily_cost_average": null
},
"serp_info": null
},
{
"se_type": "google",
"keyword": "purchase laptop computer",
"location_code": 2840,
"language_code": "en",
"keyword_info": {
"se_type": "google",
"last_updated_time": "2022-03-16 18:23:53 +00:00",
"competition": 1,
"cpc": 6.242388,
"search_volume": 40,
"categories": [
10019,
10168,
10883,
12187,
13069
],
"monthly_searches": [
{
"year": 2022,
"month": 2,
"search_volume": 20
},
{
"year": 2022,
"month": 1,
"search_volume": 70
},
{
"year": 2021,
"month": 12,
"search_volume": 50
},
{
"year": 2021,
"month": 11,
"search_volume": 30
},
{
"year": 2021,
"month": 10,
"search_volume": 40
},
{
"year": 2021,
"month": 9,
"search_volume": 30
},
{
"year": 2021,
"month": 8,
"search_volume": 50
},
{
"year": 2021,
"month": 7,
"search_volume": 30
},
{
"year": 2021,
"month": 6,
"search_volume": 40
},
{
"year": 2021,
"month": 5,
"search_volume": 30
},
{
"year": 2021,
"month": 4,
"search_volume": 40
},
{
"year": 2021,
"month": 3,
"search_volume": 30
}
]
},
"keyword_properties": {
"se_type": "google",
"core_keyword": null,
"keyword_difficulty": 82
},
"impressions_info": {
"se_type": "google",
"last_updated_time": "2022-03-19 21:56:11 +00:00",
"bid": 999,
"match_type": "exact",
"ad_position_min": 1.46,
"ad_position_max": 1,
"ad_position_average": 1.32,
"cpc_min": 327.45,
"cpc_max": 400.22,
"cpc_average": 363.84,
"daily_impressions_min": 11.26,
"daily_impressions_max": 13.76,
"daily_impressions_average": 12.51,
"daily_clicks_min": 1.02,
"daily_clicks_max": 1.24,
"daily_clicks_average": 1.13,
"daily_cost_min": 369.6,
"daily_cost_max": 451.74,
"daily_cost_average": 410.67
},
"serp_info": null
}
]
}
]
}
]
}
Using the same principle, you can sort the results by any parameter. Moreover, you can apply up to 3 sorting rules in a single request.