Using DataForSEO Labs API endpoints, it’s easy to get thousands of keyword ideas for any seed term. The API also enables you to narrow down your results by applying various filters: for example, you can get only question keywords.
Our customers often ask us how to do that, so let us help in this article.
To receive question keywords in the API response, simply apply the following filter: "filters": ["keyword", "like", "%*%"]. Instead of *, you should use a question word: how, why, what, which, where, who, when, etc.
The filter is available for the Keyword Suggestions and Keyword Ideas endpoints.
How to get question keywords with the Keyword Suggestions endpoint
1 Call the Keyword Suggestions endpoint.
POST https://api.dataforseo.com/v3/dataforseo_labs/google/keyword_suggestions/live
2 Add the keyword field to the Task POST body and specify the seed keyword in it.
3 Specify location_name (or location_code) and language_name (or language code) to get location-specific metrics for suggested keywords. If you ignore these fields, the API will return global data.
To get the full list of locations and languages for DataForSEO Labs API, call the Locations and Languages endpoint.
GET https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
4 Apply the filter mentioned above. Example: "filters": ["keyword", "like", "%how%"]
5 Set the limit on the number of returned keywords by adding the limit field to the Task POST array. Note that the Keyword Suggestions endpoint can return no more than 1000 keywords per one request. Thus, the maximum limit value can be 1000. If you don’t add this parameter, the API response will return 100 keywords as the default limit value is 100.
Your Task POST request should be structured as in the example below:
[
{
"keyword": "phone",
"language_name": "English",
"location_code": 2840,
"filters": ["keyword", "like", "%how%"],
"limit": 10
}
]
The API response will return question keyword suggestions that contain “how.”
{
"version": "0.1.20220216",
"status_code": 20000,
"status_message": "Ok.",
"time": "6.5819 sec.",
"cost": 0.011,
"tasks_count": 1,
"tasks_error": 0,
"tasks": [
{
"id": "03211253-2806-0400-0000-453f790b06d8",
"status_code": 20000,
"status_message": "Ok.",
"time": "6.5334 sec.",
"cost": 0.011,
"result_count": 1,
"path": [
"v3",
"dataforseo_labs",
"google",
"keyword_ideas",
"live"
],
"data": {
"api": "dataforseo_labs",
"function": "keyword_ideas",
"se_type": "google",
"keywords": [
"phone"
],
"language_name": "English",
"location_code": 2840,
"filters": [
"keyword",
"like",
"%how%"
],
"limit": 10
},
"result": [
{
"se_type": "google",
"seed_keywords": [
"phone"
],
"location_code": 2840,
"language_code": "en",
"total_count": 4264,
"items_count": 10,
"offset": 0,
"offset_token": "eyJDdXJyZW50T2Zmc2V0IjoxMCwiUmVxdWVzdERhdGEiOnsia2V5d29yZHMiOlsicGhvbmUiXSwibG9jYXRpb24iOjI4NDAsImxhbmd1YWdlIjoiZW4iLCJjbG9zZWx5X3ZhcmlhbnRzIjpmYWxzZSwibmV3ZXN0IjpmYWxzZSwiZXh0ZW5kZWQiOmZhbHNlLCJsb2FkX3NlcnBfaW5mbyI6ZmFsc2UsIklzT2xkIjpmYWxzZSwic2VhcmNoX2FmdGVyX3Rva2VuIjpudWxsLCJzZWFyY2hfZW5naW5lIjoiZ29vZ2xlIiwib3JkZXJfYnkiOnsib3JkZXJfZmllbGQiOiJfc2NvcmUiLCJvcmRlcl90eXBlIjoiRGVzYyIsIm5leHQiOm51bGx9LCJsaW1pdCI6MTAsIm9mZnNldCI6MCwiVG9rZW4iOnsiSXNDYW5jZWxsYXRpb25SZXF1ZXN0ZWQiOmZhbHNlLCJDYW5CZUNhbmNlbGVkIjp0cnVlLCJXYWl0SGFuZGxlIjp7IkhhbmRsZSI6eyJ2YWx1ZSI6MjQ2NH0sIlNhZmVXYWl0SGFuZGxlIjp7IklzSW52YWxpZCI6ZmFsc2UsIklzQ2xvc2VkIjpmYWxzZX19fX0sIlJhd1F1ZXJ5Ijp7ImZpZWxkIjoia2V5d29yZCIsInR5cGUiOiJsaWtlIiwidmFsdWUiOiIlaG93JSJ9LCJTZWFyY2hBZnRlckRhdGEiOls2MC4xMTIxOSwiZTU5MzRkOTAtNTYyNC0xYTI4LTBlNjktNDgwNmUxYjcwNDg3Il19",
"items": [
{
"se_type": "google",
"keyword": "how can i monitor my childs text messages on iphone",
"location_code": 2840,
"language_code": "en",
"keyword_info": {
"se_type": "google",
"last_updated_time": "2022-03-02 23:19:57 +00:00",
"competition": 0.4444444444444444,
"cpc": 9.03056,
"search_volume": 50,
"categories": [
10007,
10019,
10167,
10168,
10878,
10885,
11511,
12161,
12765,
13054,
13094,
13378,
13381,
13418,
13419,
13759
],
"monthly_searches": [
{
"year": 2022,
"month": 1,
"search_volume": 50
},
{
"year": 2021,
"month": 12,
"search_volume": 50
},
{
"year": 2021,
"month": 11,
"search_volume": 40
},
{
"year": 2021,
"month": 10,
"search_volume": 70
},
{
"year": 2021,
"month": 9,
"search_volume": 40
},
{
"year": 2021,
"month": 8,
"search_volume": 40
},
{
"year": 2021,
"month": 7,
"search_volume": 50
},
{
"year": 2021,
"month": 6,
"search_volume": 50
},
{
"year": 2021,
"month": 5,
"search_volume": 50
},
{
"year": 2021,
"month": 4,
"search_volume": 50
},
{
"year": 2021,
"month": 3,
"search_volume": 50
},
{
"year": 2021,
"month": 2,
"search_volume": 50
}
]
},
"keyword_properties": {
"se_type": "google",
"core_keyword": null,
"keyword_difficulty": 45
},
"serp_info": null
},
{
"se_type": "google",
"keyword": "how to use vcast",
"location_code": 2840,
"language_code": "en",
"keyword_info": {
"se_type": "google",
"last_updated_time": "2022-02-13 12:43:21 +00:00",
"competition": 0.10132890365448505,
"cpc": 0.534093,
"search_volume": 50,
"categories": [
10007,
10013,
10019,
10108,
10109,
10167,
10591,
10878,
11511,
12161,
12764,
13054,
13381,
13419,
13691
],
"monthly_searches": [
{
"year": 2022,
"month": 1,
"search_volume": 90
},
{
"year": 2021,
"month": 12,
"search_volume": 70
},
{
"year": 2021,
"month": 11,
"search_volume": 50
},
{
"year": 2021,
"month": 10,
"search_volume": 50
},
{
"year": 2021,
"month": 9,
"search_volume": 50
},
{
"year": 2021,
"month": 8,
"search_volume": 40
},
{
"year": 2021,
"month": 7,
"search_volume": 70
},
{
"year": 2021,
"month": 6,
"search_volume": 50
},
{
"year": 2021,
"month": 5,
"search_volume": 50
},
{
"year": 2021,
"month": 4,
"search_volume": 50
},
{
"year": 2021,
"month": 3,
"search_volume": 70
},
{
"year": 2021,
"month": 2,
"search_volume": 70
}
]
},
"keyword_properties": {
"se_type": "google",
"core_keyword": null,
"keyword_difficulty": 54
},
"serp_info": null
},
{
"se_type": "google",
"keyword": "how to activate at&t sim",
"location_code": 2840,
"language_code": "en",
"keyword_info": {
"se_type": "google",
"last_updated_time": "2022-03-17 04:34:33 +00:00",
"competition": 0.026373626373626377,
"cpc": 0.878544,
"search_volume": 140,
"categories": [
10007,
10019,
10167,
10872,
10878,
11511,
12133,
12161,
13031,
13054,
13381,
13419
],
"monthly_searches": [
{
"year": 2022,
"month": 2,
"search_volume": 140
},
{
"year": 2022,
"month": 1,
"search_volume": 140
},
{
"year": 2021,
"month": 12,
"search_volume": 170
},
{
"year": 2021,
"month": 11,
"search_volume": 110
},
{
"year": 2021,
"month": 10,
"search_volume": 140
},
{
"year": 2021,
"month": 9,
"search_volume": 170
},
{
"year": 2021,
"month": 8,
"search_volume": 140
},
{
"year": 2021,
"month": 7,
"search_volume": 140
},
{
"year": 2021,
"month": 6,
"search_volume": 140
},
{
"year": 2021,
"month": 5,
"search_volume": 90
},
{
"year": 2021,
"month": 4,
"search_volume": 90
},
{
"year": 2021,
"month": 3,
"search_volume": 70
}
]
},
"keyword_properties": {
"se_type": "google",
"core_keyword": null,
"keyword_difficulty": 55
},
"serp_info": null
},
{
"se_type": "google",
"keyword": "how much does an iphone 6 weigh",
"location_code": 2840,
"language_code": "en",
"keyword_info": {
"se_type": "google",
"last_updated_time": "2022-02-15 00:34:11 +00:00",
"competition": 0.0026702269692923898,
"cpc": null,
"search_volume": 140,
"categories": [
10007,
10019,
10167,
10168,
10878,
11511,
12161,
13054,
13381,
13419
],
"monthly_searches": [
{
"year": 2022,
"month": 1,
"search_volume": 110
},
{
"year": 2021,
"month": 12,
"search_volume": 110
},
{
"year": 2021,
"month": 11,
"search_volume": 140
},
{
"year": 2021,
"month": 10,
"search_volume": 140
},
{
"year": 2021,
"month": 9,
"search_volume": 170
},
{
"year": 2021,
"month": 8,
"search_volume": 110
},
{
"year": 2021,
"month": 7,
"search_volume": 140
},
{
"year": 2021,
"month": 6,
"search_volume": 140
},
{
"year": 2021,
"month": 5,
"search_volume": 170
},
{
"year": 2021,
"month": 4,
"search_volume": 170
},
{
"year": 2021,
"month": 3,
"search_volume": 210
},
{
"year": 2021,
"month": 2,
"search_volume": 210
}
]
},
"keyword_properties": {
"se_type": "google",
"core_keyword": null,
"keyword_difficulty": 49
},
"serp_info": null
},
{
"se_type": "google",
"keyword": "how to blacklist a iphone",
"location_code": 2840,
"language_code": "en",
"keyword_info": {
"se_type": "google",
"last_updated_time": "2022-02-14 13:09:18 +00:00",
"competition": 0.12987012987012986,
"cpc": null,
"search_volume": 10,
"categories": [
10007,
10019,
10167,
10168,
10878,
10885,
11511,
12161,
12765,
13054,
13094,
13378,
13381,
13418,
13419,
13759
],
"monthly_searches": [
{
"year": 2022,
"month": 1,
"search_volume": 10
},
{
"year": 2021,
"month": 12,
"search_volume": 10
},
{
"year": 2021,
"month": 11,
"search_volume": 10
},
{
"year": 2021,
"month": 10,
"search_volume": 10
},
{
"year": 2021,
"month": 9,
"search_volume": 10
},
{
"year": 2021,
"month": 8,
"search_volume": 10
},
{
"year": 2021,
"month": 7,
"search_volume": 10
},
{
"year": 2021,
"month": 6,
"search_volume": 10
},
{
"year": 2021,
"month": 5,
"search_volume": 10
},
{
"year": 2021,
"month": 4,
"search_volume": 10
},
{
"year": 2021,
"month": 3,
"search_volume": 10
},
{
"year": 2021,
"month": 2,
"search_volume": 10
}
]
},
"keyword_properties": {
"se_type": "google",
"core_keyword": null,
"keyword_difficulty": 45
},
"serp_info": null
},
{
"se_type": "google",
"keyword": "how long are verizon contracts",
"location_code": 2840,
"language_code": "en",
"keyword_info": {
"se_type": "google",
"last_updated_time": "2022-03-21 02:47:14 +00:00",
"competition": 0.05957719410634208,
"cpc": 13.313919,
"search_volume": 210,
"categories": [
10007,
10019,
10167,
10878,
11511,
12161,
13054,
13381,
13419
],
"monthly_searches": [
{
"year": 2022,
"month": 2,
"search_volume": 210
},
{
"year": 2022,
"month": 1,
"search_volume": 210
},
{
"year": 2021,
"month": 12,
"search_volume": 210
},
{
"year": 2021,
"month": 11,
"search_volume": 210
},
{
"year": 2021,
"month": 10,
"search_volume": 260
},
{
"year": 2021,
"month": 9,
"search_volume": 260
},
{
"year": 2021,
"month": 8,
"search_volume": 210
},
{
"year": 2021,
"month": 7,
"search_volume": 210
},
{
"year": 2021,
"month": 6,
"search_volume": 210
},
{
"year": 2021,
"month": 5,
"search_volume": 210
},
{
"year": 2021,
"month": 4,
"search_volume": 170
},
{
"year": 2021,
"month": 3,
"search_volume": 170
}
]
},
"keyword_properties": {
"se_type": "google",
"core_keyword": null,
"keyword_difficulty": 50
},
"serp_info": null
},
{
"se_type": "google",
"keyword": "how to backup phone",
"location_code": 2840,
"language_code": "en",
"keyword_info": {
"se_type": "google",
"last_updated_time": "2022-03-02 15:04:08 +00:00",
"competition": 0.040015292468459286,
"cpc": 2.09572,
"search_volume": 1300,
"categories": [
10007,
10019,
10167,
10168,
10878,
10885,
11511,
12161,
12765,
13054,
13094,
13378,
13381,
13418,
13419,
13759
],
"monthly_searches": [
{
"year": 2022,
"month": 1,
"search_volume": 1000
},
{
"year": 2021,
"month": 12,
"search_volume": 1600
},
{
"year": 2021,
"month": 11,
"search_volume": 1300
},
{
"year": 2021,
"month": 10,
"search_volume": 1300
},
{
"year": 2021,
"month": 9,
"search_volume": 1300
},
{
"year": 2021,
"month": 8,
"search_volume": 1000
},
{
"year": 2021,
"month": 7,
"search_volume": 1300
},
{
"year": 2021,
"month": 6,
"search_volume": 1300
},
{
"year": 2021,
"month": 5,
"search_volume": 1000
},
{
"year": 2021,
"month": 4,
"search_volume": 1000
},
{
"year": 2021,
"month": 3,
"search_volume": 1300
},
{
"year": 2021,
"month": 2,
"search_volume": 1000
}
]
},
"keyword_properties": {
"se_type": "google",
"core_keyword": null,
"keyword_difficulty": 70
},
"serp_info": null
},
{
"se_type": "google",
"keyword": "how to activate an unlocked phone on metro pcs",
"location_code": 2840,
"language_code": "en",
"keyword_info": {
"se_type": "google",
"last_updated_time": "2022-03-16 13:43:49 +00:00",
"competition": null,
"cpc": null,
"search_volume": 20,
"categories": [
10007,
10019,
10167,
10878,
11511,
12161,
13054,
13381,
13419
],
"monthly_searches": [
{
"year": 2022,
"month": 2,
"search_volume": 10
},
{
"year": 2022,
"month": 1,
"search_volume": 20
},
{
"year": 2021,
"month": 12,
"search_volume": 40
},
{
"year": 2021,
"month": 11,
"search_volume": 10
},
{
"year": 2021,
"month": 10,
"search_volume": 10
},
{
"year": 2021,
"month": 9,
"search_volume": 10
},
{
"year": 2021,
"month": 8,
"search_volume": 20
},
{
"year": 2021,
"month": 7,
"search_volume": 20
},
{
"year": 2021,
"month": 6,
"search_volume": 10
},
{
"year": 2021,
"month": 5,
"search_volume": 20
},
{
"year": 2021,
"month": 4,
"search_volume": 30
},
{
"year": 2021,
"month": 3,
"search_volume": 20
}
]
},
"keyword_properties": {
"se_type": "google",
"core_keyword": null,
"keyword_difficulty": 57
},
"serp_info": null
},
{
"se_type": "google",
"keyword": "how much does the average cell phone weigh",
"location_code": 2840,
"language_code": "en",
"keyword_info": {
"se_type": "google",
"last_updated_time": "2022-03-18 19:22:09 +00:00",
"competition": null,
"cpc": null,
"search_volume": 30,
"categories": [
10007,
10019,
10167,
10878,
11511,
12161,
13054,
13381,
13419
],
"monthly_searches": [
{
"year": 2022,
"month": 2,
"search_volume": 20
},
{
"year": 2022,
"month": 1,
"search_volume": 20
},
{
"year": 2021,
"month": 12,
"search_volume": 20
},
{
"year": 2021,
"month": 11,
"search_volume": 30
},
{
"year": 2021,
"month": 10,
"search_volume": 30
},
{
"year": 2021,
"month": 9,
"search_volume": 20
},
{
"year": 2021,
"month": 8,
"search_volume": 40
},
{
"year": 2021,
"month": 7,
"search_volume": 40
},
{
"year": 2021,
"month": 6,
"search_volume": 20
},
{
"year": 2021,
"month": 5,
"search_volume": 30
},
{
"year": 2021,
"month": 4,
"search_volume": 20
},
{
"year": 2021,
"month": 3,
"search_volume": 30
}
]
},
"keyword_properties": {
"se_type": "google",
"core_keyword": null,
"keyword_difficulty": 45
},
"serp_info": null
},
{
"se_type": "google",
"keyword": "how to check if at&t iphone is unlocked",
"location_code": 2840,
"language_code": "en",
"keyword_info": {
"se_type": "google",
"last_updated_time": "2022-02-14 02:59:40 +00:00",
"competition": null,
"cpc": null,
"search_volume": 20,
"categories": [
10007,
10019,
10167,
10878,
11511,
12161,
13054,
13381,
13419
],
"monthly_searches": [
{
"year": 2022,
"month": 1,
"search_volume": 10
},
{
"year": 2021,
"month": 12,
"search_volume": 10
},
{
"year": 2021,
"month": 11,
"search_volume": 10
},
{
"year": 2021,
"month": 10,
"search_volume": 10
},
{
"year": 2021,
"month": 9,
"search_volume": 20
},
{
"year": 2021,
"month": 8,
"search_volume": 50
},
{
"year": 2021,
"month": 7,
"search_volume": 90
},
{
"year": 2021,
"month": 6,
"search_volume": 10
},
{
"year": 2021,
"month": 5,
"search_volume": 10
},
{
"year": 2021,
"month": 4,
"search_volume": 20
},
{
"year": 2021,
"month": 3,
"search_volume": 10
},
{
"year": 2021,
"month": 2,
"search_volume": 10
}
]
},
"keyword_properties": {
"se_type": "google",
"core_keyword": null,
"keyword_difficulty": 57
},
"serp_info": null
}
]
}
]
}
]
}