{"id":14105,"date":"2022-05-24T08:33:17","date_gmt":"2022-05-24T08:33:17","guid":{"rendered":"https:\/\/docs_v3.dataforseo.com\/v3\/?page_id=14105"},"modified":"2025-03-14T15:54:13","modified_gmt":"2025-03-14T15:54:13","slug":"databases-google-keywords","status":"publish","type":"page","link":"https:\/\/docs.dataforseo.com\/v3\/databases-google-keywords\/","title":{"rendered":"databases\/google\/keywords"},"content":{"rendered":"

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

Google Keyword Database<\/h2>\n

\u200c\u200c
\nGoogle Keyword Database encompasses billions of search terms enriched with search volume trends and other related Google Ads data.<\/p>\n

Keyword data is collected from several sources, including Google Ads and Google search engine results pages. We\u2019re continuously adding new keywords to the database and updating keyword data gradually in the second part of each month (due to Google Ads\u2019 update cycle).<\/p>\n

This database is available in both JSON and CSV formats.<\/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 Keyword Database<\/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
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 making an API request to the
\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 making an API request to the
\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<\/strong><\/code><\/td>\narray<\/td>\nkeyword data for the returned keyword<\/em><\/td>\n<\/tr>\n
\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 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 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 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 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 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 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 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 history<\/code><\/td>\narray<\/td>\nmonthly searches<\/em>
\nrepresents the (approximate) number of monthly searches on the returned keyword in the given location;
\nhistorical data is available for the past 4 years\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": "races day",\r\n  "location": 2036,\r\n  "language": "en",\r\n  "spell": null,\r\n  "spell_type": null,\r\n  "keyword_info": {\r\n    "search_volume": 260,\r\n    "cpc": null,\r\n    "competition": 0.01,\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-21T20:25:36.3263513Z",\r\n    "categories": [\r\n      10014,\r\n      13605,\r\n      13624\r\n    ],\r\n    "history": {\r\n      "202203": 210,\r\n      "202204": 170,\r\n      "202205": 210,\r\n      "202206": 170,\r\n      "202207": 260,\r\n      "202208": 320,\r\n      "202209": 320,\r\n      "202210": 720,\r\n      "202211": 260,\r\n      "202212": 260,\r\n      "202301": 170,\r\n      "202302": 170\r\n    }\r\n  },\r\n  "extra": {\r\n    "core_keyword": null,\r\n    "detected_language": "en",\r\n    "keyword_difficulty": 57\r\n  },\r\n  "search_intent_info": {\r\n    "main_intent": "informational",\r\n    "foreign_intent": [\r\n      "navigational"\r\n    ],\r\n    "last_updated_time": "2023-03-02T17:23:41.2125531Z"\r\n  }\r\n}<\/code><\/pre><\/div><\/div><\/div><\/div>","protected":false},"excerpt":{"rendered":"
[vc_row][vc_column][vc_column_text] Google Keyword Database \u200c\u200c Google Keyword Database encompasses billions of search terms enriched with search volume trends and other related Google Ads data. Keyword data is collected from several sources, including Google Ads and Google search engine results pages. We\u2019re continuously adding new keywords to the database and updating keyword data gradually in the […]<\/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-14105","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/14105","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=14105"}],"version-history":[{"count":35,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/14105\/revisions"}],"predecessor-version":[{"id":21150,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/14105\/revisions\/21150"}],"wp:attachment":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/media?parent=14105"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}