NAVNavbar
Logo
cURL php NodeJS Python cSharp

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 the
https://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 2022-01-17)
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 the
https://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 2022-01-17)
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 parameters
if 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

‌‌