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_languages example: 2840 corresponds to the United States you 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_languages example: en corresponds to English you 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 , HIGH if 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 |