Historical Google Keywords Database
Historical Google Keyword Databases can provide you with billions of keywords enriched with historical keyword data: search volume, competition, and more.
Note that historical data is available since the beginning of 2019.
This database is available in JSON format only.
Click here to download a database sample for the US location, English language.
The database in JSON contains data structured like in the example below:
{
"keyword":"petfinder san ramon",
"location":2840,
"language":"en",
"spell":null,
"spell_type":null,
"keyword_info_history":{
"202109":{
"search_volume":10,
"cpc":1.65483,
"competition":0.06493506493506493,
"competition_level":null,
"low_top_of_page_bid":null,
"high_top_of_page_bid":null,
"time_update":"2021-10-15T22:18:08.4095058Z",
"categories":[
],
"history":{
"202010":0,
"202011":0,
"202012":0,
"202101":0,
"202102":0,
"202103":0,
"202104":0,
"202105":0,
"202106":0,
"202107":0,
"202108":0,
"202109":40
}
},
"202110":{
"search_volume":10,
"cpc":null,
"competition":0.12857142857142856,
"competition_level":null,
"low_top_of_page_bid":null,
"high_top_of_page_bid":null,
"time_update":"2021-11-16T20:49:14.4926487Z",
"categories":[
],
"history":{
"202011":0,
"202012":0,
"202101":0,
"202102":0,
"202103":0,
"202104":0,
"202105":0,
"202106":0,
"202107":0,
"202108":0,
"202109":40,
"202110":20
}
},
"202111":{
"search_volume":10,
"cpc":3.79435,
"competition":0.0873015873015873,
"competition_level":null,
"low_top_of_page_bid":null,
"high_top_of_page_bid":null,
"time_update":"2021-12-13T03:13:24.2692357Z",
"categories":[
],
"history":{
"202012":0,
"202101":0,
"202102":0,
"202103":0,
"202104":0,
"202105":0,
"202106":0,
"202107":0,
"202108":0,
"202109":40,
"202110":20,
"202111":40
}
},
"202112":{
"search_volume":10,
"cpc":2.99924,
"competition":0.05059523809523809,
"competition_level":null,
"low_top_of_page_bid":null,
"high_top_of_page_bid":null,
"time_update":"2022-01-11T14:42:50.1419700Z",
"categories":[
],
"history":{
"202101":0,
"202102":0,
"202103":0,
"202104":0,
"202105":0,
"202106":0,
"202107":0,
"202108":0,
"202109":40,
"202110":20,
"202111":40,
"202112":50
}
},
"202201":{
"search_volume":20,
"cpc":5.333734,
"competition":0.05428571428571429,
"competition_level":null,
"low_top_of_page_bid":null,
"high_top_of_page_bid":null,
"time_update":"2022-02-09T20:17:24.7030074Z",
"categories":[
],
"history":{
"202102":0,
"202103":0,
"202104":0,
"202105":0,
"202106":0,
"202107":0,
"202108":0,
"202109":40,
"202110":20,
"202111":40,
"202112":50,
"202201":50
}
},
"202202":{
"search_volume":20,
"cpc":null,
"competition":0.08823529411764706,
"competition_level":null,
"low_top_of_page_bid":null,
"high_top_of_page_bid":null,
"time_update":"2022-03-17T11:51:24.2191751Z",
"categories":[
],
"history":{
"202103":0,
"202104":0,
"202105":0,
"202106":0,
"202107":0,
"202108":0,
"202109":40,
"202110":20,
"202111":40,
"202112":50,
"202201":50,
"202202":30
}
},
"202203":{
"search_volume":20,
"cpc":null,
"competition":0.06,
"competition_level":"LOW",
"low_top_of_page_bid":null,
"high_top_of_page_bid":null,
"time_update":"2022-04-15T16:30:50.1857624Z",
"categories":[
],
"history":{
"202104":0,
"202105":0,
"202106":0,
"202107":0,
"202108":0,
"202109":40,
"202110":20,
"202111":40,
"202112":50,
"202201":50,
"202202":30,
"202203":40
}
}
},
"extra":{
"core_keyword":null,
"keyword_difficulty":45
}
}
Description of the fields in the 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 Statesyou can also download the full list of supported locations in the CSV format (last updated 2023-01-04) |
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 Englishyou can also download the full list of supported languages in the CSV format (last updated 2023-01-04) |
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_history |
object | historical keyword data for the returned keyword |
$date |
object | date variable provided in the “YYYYMM” format example: "202109" |
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 note that Google Ads does not provide separate CPC data; this field returns values based on data from high_top_of_page_bid supplied in Google Ads |
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, HIGHif competition level is unknown, the value is null;learn more about the metric in this help center article |
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 |
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 |
categories |
array | product and service categories you can download the full list of possible categories |
history |
object | monthly searches represents the (approximate) number of searches on the returned keyword in the given location for the 12 months preceding the $date variable;example: "202109":40
|
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 |
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 |