Keyword Database
This is a legacy version page. See the updated documentation here.
Keyword Database encompassed over 3 billion search terms enriched with related data: search volume trends, cpc, competition, impressions, and more.
This database is available in both JSON and CSV formats.
The database in JSON contains data structured like in the example below:
{
"keyword": "الرسم ثلاثي الابعاد",
"location": 2818,
"language": "ar",
"spell": null,
"spell_type": null,
"keyword_info": {
"search_volume": 720,
"cpc": 0.015523,
"competition": 0.019329507701600728,
"time_update": "2021-03-24T04:01:47.4351095Z",
"categories": [
10013,
10108,
13388,
13595,
13691,
13692
],
"history": {
"202003": 1000,
"202004": 1000,
"202005": 880,
"202006": 1000,
"202007": 720,
"202008": 590,
"202009": 480,
"202010": 480,
"202011": 480,
"202012": 590,
"202101": 590,
"202102": 480
}
},
"impressions_info": {
"ad_position_avg": null,
"ad_position_min": null,
"ad_position_max": null,
"cpc_avg": null,
"cpc_min": null,
"cpc_max": null,
"daily_impressions_avg": 0,
"daily_impressions_min": 0,
"daily_impressions_max": 0,
"daily_clicks_avg": 0,
"daily_clicks_min": 0,
"daily_clicks_max": 0,
"bid": 999,
"daily_cost_avg": 0,
"daily_cost_min": 0,
"daily_cost_max": 0,
"time_update": "2021-03-19T14:07:03.9208731Z"
},
"bing_keyword_info": null,
"extra": {
"core_keyword": "رسومات ثلاثية الابعاد"
}
},
{
"keyword": "الاميرة هيا",
"location": 2818,
"language": "ar",
"spell": null,
"spell_type": null,
"keyword_info": {
"search_volume": 720,
"cpc": 0.009519,
"competition": 0.0033973161202649907,
"time_update": "2021-03-31T21:57:05.1516650Z",
"categories": [
10013,
10018,
10108,
10584,
13414,
13444
],
"history": {
"202003": 2900,
"202004": 880,
"202005": 590,
"202006": 590,
"202007": 720,
"202008": 590,
"202009": 480,
"202010": 390,
"202011": 390,
"202012": 390,
"202101": 390,
"202102": 880
}
},
"impressions_info": {
"ad_position_avg": null,
"ad_position_min": null,
"ad_position_max": null,
"cpc_avg": null,
"cpc_min": null,
"cpc_max": null,
"daily_impressions_avg": 0,
"daily_impressions_min": 0,
"daily_impressions_max": 0,
"daily_clicks_avg": 0,
"daily_clicks_min": 0,
"daily_clicks_max": 0,
"bid": 999,
"daily_cost_avg": 0,
"daily_cost_min": 0,
"daily_cost_max": 0,
"time_update": "2021-03-28T14:05:34.4503662Z"
},
"bing_keyword_info": null,
"extra": {
"core_keyword": null
}
}
Description of the fields in the Keyword Database:
| Field name | Type | Description |
|---|---|---|
keyword |
string | keyword UTF-8 encoding applies |
location |
integer | location code unique identifier of the corresponding location you can receive the list of available locations with their location_code by making a separate request to thehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languagesexample: 2840 corresponds to the United States |
language |
string | language code unique identifier of the language available for the corresponding location you can receive the list of available locations with their language_code by making a separate request to thehttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languagesexample: en corresponds to English |
spell |
string | autocorrection of the search engine if the search engine provided results for a keyword that was corrected, we will provide the keyword corrected by the search engine and the type of autocorrection |
spell_type |
string | type of autocorrection possible values: did_you_mean, showing_results_for, no_results_found_for
|
keyword_info |
array | keyword data for the returned keyword |
search_volume |
integer | average monthly search volume rate represents either the approximate number of searches for the given keyword idea on google.com or google.com and partners, depending on the user’s targeting |
cpc |
float | cost-per-click represents the average cost per click (USD) historically paid for the keyword |
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) |
time_update |
string | date and time when keyword data was last updated in the format: “month/date/year hours:minutes:seconds UTC” example: 05/08/2020 09:47:05 |
categories |
array | product and service categories you can download the full list of possible categories |
history |
array | monthly searches represents the (approximate) number of searches on the returned keyword in the given location |
impressions_info |
array | impressions data for the returned keyword learn more about impressions in this help center article |
ad_position_average |
float | the average ad position represents the average position of the paid result in Google SERP for the returned keyword |
ad_position_min |
float | the minimum ad position represents the minimum position of the paid result in Google SERP for the returned keyword |
ad_position_max |
float | the maximum ad position represents the maximum position of the paid result in Google SERP for returned keyword |
cpc_avg |
float | the average value of cost-per-click represents the average cost-per-click (USD) historically paid for the keyword in Google Ads |
cpc_min |
float | the minimum value of cost-per-click represents the minimum cost-per-click (USD) historically paid for the keyword in Google Ads |
cpc_max |
float | the maximum value of cost-per-click represents the maximum cost-per-click (USD) historically paid for the keyword in Google Ads |
daily_impressions_avg |
float | the average value of daily impressions represents the average number of daily impressions of the paid result in Google SERP for the returned keyword |
daily_impressions_min |
float | the minimum value of daily impressions represents the minimum number of daily impressions of the paid result in Google SERP for the returned keyword |
daily_impressions_max |
float | the maximum value of daily impressions represents the maximum number of daily impressions of the paid result in Google SERP for the returned keyword |
daily_clicks_avg |
float | the average value of daily clicks represents the average number of daily clicks on the paid result in Google SERP for the returned keyword |
daily_clicks_min |
float | the minimum value of daily clicks represents the minimum number of daily clicks on the paid result in Google SERP for the returned keyword |
daily_clicks_max |
float | the maximum value of daily clicks represents the maximum number of daily clicks on the paid result in Google SERP for the returned keyword |
bid |
integer | the maximum bid we return the results for the 999 bid value to provide the most relevant impressions data |
daily_cost_avg |
float | the average daily cost represents the average daily cost of running ads for the returned keyword in Google Ads |
daily_cost_min |
float | the minimum daily cost represents the minimum daily cost of running ads for the returned keyword in Google Ads |
daily_cost_max |
float | the maximum daily charge value represents the maximum daily cost of running ads for the returned keyword in Google Ads |
time_update |
string | date and time when keyword data was last updated in the format: “month/date/year hours:minutes:seconds UTC” example: 05/08/2020 09:47:05 |
bing_keyword_info |
array | keyword data based on bing ads note: bing data is available for a limited number of locations and languages |
search_volume |
integer | monthly number of searches on bing represents the number of searches for the given keyword idea on bing.com for the past month |
time_update |
string | date and time when keyword data was last updated in the ISO 8601 format: “YYYY-MM-DDThh:mm:ss.sssssssZ” example: 2020-09-12T00:07:43.0733218Z |
history |
array | monthly searches represents the number of monthly Bing searches on the returned keyword in the given location |
extra |
array | additional information about the keyword |
core_keyword |
string | main keyword in a group contains the main keyword in a group of keywords that share similarities across the keyword_info parametersif the value is null, our database does not contain any keywords that match these criteria |