{"id":14108,"date":"2022-05-24T12:26:52","date_gmt":"2022-05-24T12:26:52","guid":{"rendered":"https:\/\/docs_v3.dataforseo.com\/v3\/?page_id=14108"},"modified":"2025-05-05T10:09:36","modified_gmt":"2025-05-05T10:09:36","slug":"databases-google-history-keywords","status":"publish","type":"page","link":"https:\/\/docs.dataforseo.com\/v3\/databases-google-history-keywords\/","title":{"rendered":"databases\/google\/history\/keywords"},"content":{"rendered":"

[vc_row][vc_column][vc_column_text]<\/p>\n

Historical Google Keywords Database<\/h2>\n

\u200c\u200c
\nHistorical Google Keyword Databases can provide you with billions of keywords enriched with historical keyword data: search volume, competition, and more. <\/p>\n

Note that historical data is available starting from 08-2021.<\/p>\n

This database is available in JSON format only.<\/p>\n

Click here to download a database sample for the US location, English language.<\/a><\/p>\n

You can also download the full list of supported locations<\/a> in the CSV format (last updated 2026-04-06).<\/p>\n

\t

\n\t\t
\n\t\t\t
\n\t\t\t\t\n\t\t\t\t\t<\/use>\n\t\t\t\t<\/svg>\n\t\t\t<\/div>\n\t\t\t
Pricing<\/div>\n\t\t<\/header>\n\t\t
\n\t\t\t

The cost depends on the size and location parameters of the specific database.
\nThe cost can be found on the Historical Google Databases<\/a> pricing page.<\/p>\n\t\t<\/div>\n\t<\/article>\n\t[vc_column_text]<\/p>\n

Description of the fields in the database:<\/strong><\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Field name<\/th>\nType<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
keyword<\/code><\/td>\nstring<\/td>\nkeyword<\/em>
\nUTF-8 encoding applies\n<\/td>\n<\/tr>\n
location<\/code><\/td>\ninteger<\/td>\nlocation code<\/em>
\nunique identifier of the corresponding location
\nyou can receive the list of available locations with their location_code<\/code> by a GET request to
\nhttps:\/\/api.dataforseo.com\/v3\/dataforseo_labs\/locations_and_languages<\/code>
\nexample:
\n2840<\/code> corresponds to the United States<\/code><\/td>\n<\/tr>\n
language<\/code><\/td>\nstring<\/td>\nlanguage code<\/em>
\nunique identifier of the language available for the corresponding location
\nyou can receive the list of available locations with their language_code<\/code> by a GET request to
\nhttps:\/\/api.dataforseo.com\/v3\/dataforseo_labs\/locations_and_languages<\/code>
\nexample:
\nen<\/code> corresponds to English<\/code><\/td>\n<\/tr>\n
spell<\/code><\/td>\nstring<\/td>\nautocorrection of the search engine<\/em>
\nif 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\n<\/td>\n<\/tr>\n
spell_type<\/code><\/td>\nstring<\/td>\ntype of autocorrection<\/em>
\npossible values:
\ndid_you_mean<\/code>, showing_results_for<\/code>, no_results_found_for<\/code>\n<\/td>\n<\/tr>\n
keyword_info_history<\/strong><\/code><\/td>\nobject<\/td>\nhistorical keyword data for the returned keyword<\/em><\/td>\n<\/tr>\n
\u00a0 \u00a0 $date<\/code><\/td>\nobject<\/td>\ndate variable<\/em>
\nprovided in the “YYYYMM” format
\nexample: \"202109\"<\/code><\/td>\n<\/tr>\n
\u00a0 \u00a0 \u00a0 \u00a0 search_volume<\/code><\/td>\ninteger<\/td>\naverage monthly search volume rate<\/em>
\nrepresents either the approximate number of searches for the given keyword idea on google.com or google.com and partners, depending on the user\u2019s targeting<\/td>\n<\/tr>\n
\u00a0 \u00a0 \u00a0 \u00a0 cpc<\/code><\/td>\nfloat<\/td>\ncost-per-click<\/em>
\nrepresents the average cost per click (USD) historically paid for the keyword
\nnote<\/strong> that Google Ads does not provide separate CPC data;
\nthis field returns values based on data from high_top_of_page_bid<\/code> supplied in Google Ads<\/td>\n<\/tr>\n
\u00a0 \u00a0 \u00a0 \u00a0 competition<\/code><\/td>\nfloat<\/td>\ncompetition<\/em>
\nrepresents the relative amount of competition associated with the given keyword;
\nthe value is based on Google Ads data and can be between 0 and 1 (inclusive)<\/td>\n<\/tr>\n
\u00a0 \u00a0 \u00a0 \u00a0 competition_level<\/code><\/td>\nstring<\/td>\ncompetition level<\/em>
\nrepresents the relative level of competition associated with the given keyword in paid SERP only;
\npossible values: LOW<\/code>, MEDIUM<\/code>, HIGH<\/code>
\nif competition level is unknown, the value is null<\/code>;
\nlearn more about the metric in this help center article<\/a><\/td>\n<\/tr>\n
\u00a0 \u00a0 \u00a0 \u00a0 low_top_of_page_bid<\/code><\/td>\nfloat<\/td>\nminimum bid for the ad to be displayed at the top of the first page<\/em>
\nindicates the value greater than about 20% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers)
\nthe value may differ depending on the location specified in a POST request<\/td>\n<\/tr>\n
\u00a0 \u00a0 \u00a0 \u00a0 high_top_of_page_bid<\/code><\/td>\nfloat<\/td>\nmaximum bid for the ad to be displayed at the top of the first page<\/em>
\nindicates the value greater than about 80% of the lowest bids for which ads were displayed (based on Google Ads statistics for advertisers)
\nthe value may differ depending on the location specified in a POST request<\/td>\n<\/tr>\n
\u00a0 \u00a0 \u00a0 \u00a0 time_update<\/code><\/td>\nstring<\/td>\ndate and time when keyword data was last updated<\/em>
\nin the ISO 8601<\/a> format: \u201cYYYY-MM-DDThh:mm:ss.sssssssZ\u201d
\nexample:
\n2020-09-12T00:07:43.0733218Z<\/code><\/td>\n<\/tr>\n
\u00a0 \u00a0 \u00a0 \u00a0 categories<\/code><\/td>\narray<\/td>\nproduct and service categories<\/em>
\nyou can download the full list of possible categories<\/a><\/td>\n<\/tr>\n
\u00a0 \u00a0 \u00a0 \u00a0 history<\/code><\/td>\nobject<\/td>\nmonthly searches<\/em>
\nrepresents the (approximate) number of searches on the returned keyword in the given location for 4 years preceding the $date<\/code> variable;
\nexample: \"202109\":40<\/code>\n<\/td>\n<\/tr>\n
extra<\/strong><\/code><\/td>\narray<\/td>\nadditional information about the keyword<\/em><\/td>\n<\/tr>\n
\u00a0 \u00a0 core_keyword<\/code><\/td>\nstring<\/td>\nmain keyword in a group<\/em>
\ncontains the main keyword in a group of keywords that share similarities across the keyword_info<\/code> parameters
\nif the value is null<\/code>, our database does not contain any keywords that match these criteria<\/td>\n<\/tr>\n
\u00a0 \u00a0 synonym_clustering_algorithm<\/code><\/td>\nstring<\/td>\nthe algorithm used to identify synonyms<\/em>
\npossible values:
\nkeyword_metrics<\/code> – indicates the algorithm based on keyword_info<\/code> parameters
\ntext_processing<\/code> – indicates the text-based algorithm
\nif the value is null<\/code>, our database does not contain any keywords the corresponding algorithm could identify as synonymous with keyword<\/code><\/td>\n<\/tr>\n
\u00a0 \u00a0 detected_language<\/code><\/td>\nstring<\/td>\ndetected language of the keyword<\/em>
\nindicates the language of the keyword as identified by our system<\/td>\n<\/tr>\n
\u00a0 \u00a0 keyword_difficulty<\/code><\/td>\ninteger<\/td>\ndifficulty of ranking in the first top-10 organic results for a keyword<\/em>
\nindicates the chance of getting in top-10 organic results for a keyword on a logarithmic scale from 0 to 100;
\ncalculated by analysing, among other parameters, link profiles of the first 10 pages in SERP;
\nlearn more about the metric in this help center guide<\/a><\/td>\n<\/tr>\n
search_intent_info<\/strong><\/code><\/td>\nobject<\/td>\nsearch intent info for the returned keyword<\/em>
\nlearn about search intent in this help center article<\/a><\/td>\n<\/tr>\n
\u00a0 \u00a0 main_intent<\/code><\/td>\nstring<\/td>\nmain search intent<\/em>
\npossible values: informational<\/code>, navigational<\/code>, commercial<\/code>, transactional<\/code><\/a>\n<\/td>\n<\/tr>\n
\u00a0 \u00a0 foreign_intent<\/code><\/td>\narray<\/td>\nsupplementary search intents<\/em>
\npossible values: informational<\/code>, navigational<\/code>, commercial<\/code>, transactional<\/code><\/a>\n<\/td>\n<\/tr>\n
\u00a0 \u00a0 last_updated_time<\/code><\/td>\nstring<\/td>\ndate and time when search intent data was last updated<\/em>
\nin the ISO 8601<\/a> format: \u201cYYYY-MM-DDThh:mm:ss.sssssssZ\u201d
\nexample:
\n2022-09-12T00:07:43.0733218Z<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

\u200c\u200c[\/vc_column_text][\/vc_column][\/vc_row]<\/p>\n

The database in JSON contains data structured like in the example below:<\/p><\/blockquote>

{\r\n  "keyword": "huckleberry bookstore",\r\n  "location": 2124,\r\n  "language": "fr",\r\n  "spell": null,\r\n  "spell_type": null,\r\n  "keyword_info_history": {\r\n    "202203": {\r\n      "search_volume": 480,\r\n      "cpc": null,\r\n      "competition": 0.12,\r\n      "competition_level": "LOW",\r\n      "low_top_of_page_bid": null,\r\n      "high_top_of_page_bid": null,\r\n      "time_update": "2022-05-10T19:17:54.2726860Z",\r\n      "categories": [],\r\n      "history": {\r\n        "202105": 390,\r\n        "202106": 390,\r\n        "202107": 390,\r\n        "202108": 390,\r\n        "202109": 390,\r\n        "202110": 390,\r\n        "202111": 590,\r\n        "202112": 880,\r\n        "202201": 590,\r\n        "202202": 390,\r\n        "202203": 480,\r\n        "202204": 480\r\n      }\r\n    },\r\n    "202204": {\r\n      "search_volume": 480,\r\n      "cpc": null,\r\n      "competition": 0.12,\r\n      "competition_level": "LOW",\r\n      "low_top_of_page_bid": null,\r\n      "high_top_of_page_bid": null,\r\n      "time_update": "2022-06-02T23:21:21.7580528Z",\r\n      "categories": [],\r\n      "history": {\r\n        "202105": 390,\r\n        "202106": 390,\r\n        "202107": 390,\r\n        "202108": 390,\r\n        "202109": 390,\r\n        "202110": 390,\r\n        "202111": 590,\r\n        "202112": 880,\r\n        "202201": 590,\r\n        "202202": 390,\r\n        "202203": 480,\r\n        "202204": 480\r\n      }\r\n    },\r\n    "202205": {\r\n      "search_volume": 480,\r\n      "cpc": null,\r\n      "competition": 0.06,\r\n      "competition_level": "LOW",\r\n      "low_top_of_page_bid": null,\r\n      "high_top_of_page_bid": null,\r\n      "time_update": "2022-06-15T14:14:14.8835515Z",\r\n      "categories": [],\r\n      "history": {\r\n        "202106": 390,\r\n        "202107": 390,\r\n        "202108": 390,\r\n        "202109": 390,\r\n        "202110": 390,\r\n        "202111": 590,\r\n        "202112": 880,\r\n        "202201": 590,\r\n        "202202": 390,\r\n        "202203": 480,\r\n        "202204": 480,\r\n        "202205": 480\r\n      }\r\n    },\r\n    "202206": {\r\n      "search_volume": 480,\r\n      "cpc": null,\r\n      "competition": 0.13,\r\n      "competition_level": "LOW",\r\n      "low_top_of_page_bid": null,\r\n      "high_top_of_page_bid": null,\r\n      "time_update": "2022-07-12T18:44:24.3630256Z",\r\n      "categories": [],\r\n      "history": {\r\n        "202107": 390,\r\n        "202108": 390,\r\n        "202109": 390,\r\n        "202110": 390,\r\n        "202111": 590,\r\n        "202112": 880,\r\n        "202201": 590,\r\n        "202202": 390,\r\n        "202203": 480,\r\n        "202204": 480,\r\n        "202205": 480,\r\n        "202206": 390\r\n      }\r\n    },\r\n    "202302": {\r\n      "search_volume": 480,\r\n      "cpc": null,\r\n      "competition": 0.23,\r\n      "competition_level": "LOW",\r\n      "low_top_of_page_bid": null,\r\n      "high_top_of_page_bid": null,\r\n      "time_update": "2023-03-21T23:09:18.9404970Z",\r\n      "categories": [\r\n        10016,\r\n        10141,\r\n        10763,\r\n        10108,\r\n        10112,\r\n        10609\r\n      ],\r\n      "history": {\r\n        "202203": 390,\r\n        "202204": 480,\r\n        "202205": 390,\r\n        "202206": 390,\r\n        "202207": 390,\r\n        "202208": 390,\r\n        "202209": 390,\r\n        "202210": 480,\r\n        "202211": 590,\r\n        "202212": 880,\r\n        "202301": 590,\r\n        "202302": 480\r\n      }\r\n    }\r\n  },\r\n  "extra": {\r\n    "core_keyword": null,\r\n    "detected_language": "en",\r\n    "keyword_difficulty": 15\r\n  },\r\n  "search_intent_info": {\r\n    "main_intent": "commercial",\r\n    "foreign_intent": [],\r\n    "last_updated_time": "2023-03-04T13:14:40.0735962Z"\r\n  }\r\n}<\/code><\/pre><\/div><\/div><\/div><\/div>","protected":false},"excerpt":{"rendered":"
[vc_row][vc_column][vc_column_text] Historical Google Keywords Database \u200c\u200c 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 starting from 08-2021. This database is available in JSON format only. Click here to download a database sample for the US location, […]<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"template.php","meta":{"apibase_doc_request_yaml":"","apibase_doc_request_additional_yaml":"","apibase_doc_response_yaml":"","footnotes":""},"class_list":["post-14108","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/14108","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/comments?post=14108"}],"version-history":[{"count":38,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/14108\/revisions"}],"predecessor-version":[{"id":21501,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/14108\/revisions\/21501"}],"wp:attachment":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/media?parent=14108"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}