Keyword Database

‌‌ 

This is a legacy version page. See the updated documentation here.

 
Keyword Database encompassed over 3 billion search terms enriched with related data: search volume trends, cpc, competition, impressions, and more.

This database is available in both JSON and CSV formats.

Pricing

The cost depends on the size and location parameters of the specific database.
The cost can be found on the Keyword Database pricing page.

Description of the fields in the Keyword 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
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
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 array keyword data for the returned keyword
    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
    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)
    time_update string date and time when keyword data was last updated
in the format: “month/date/year hours:minutes:seconds UTC”
example:
05/08/2020 09:47:05
    categories array product and service categories
you can download the full list of possible categories
    history array monthly searches
represents the (approximate) number of searches on the returned keyword in the given location
impressions_info array impressions data for the returned keyword
learn more about impressions in this help center article
    ad_position_average float the average ad position
represents the average position of the paid result in Google SERP for the returned keyword
    ad_position_min float the minimum ad position
represents the minimum position of the paid result in Google SERP for the returned keyword
    ad_position_max float the maximum ad position
represents the maximum position of the paid result in Google SERP for returned keyword
    cpc_avg float the average value of cost-per-click
represents the average cost-per-click (USD) historically paid for the keyword in Google Ads
    cpc_min float the minimum value of cost-per-click
represents the minimum cost-per-click (USD) historically paid for the keyword in Google Ads
    cpc_max float the maximum value of cost-per-click
represents the maximum cost-per-click (USD) historically paid for the keyword in Google Ads
    daily_impressions_avg float the average value of daily impressions
represents the average number of daily impressions of the paid result in Google SERP for the returned keyword
    daily_impressions_min float the minimum value of daily impressions
represents the minimum number of daily impressions of the paid result in Google SERP for the returned keyword
    daily_impressions_max float the maximum value of daily impressions
represents the maximum number of daily impressions of the paid result in Google SERP for the returned keyword
    daily_clicks_avg float the average value of daily clicks
represents the average number of daily clicks on the paid result in Google SERP for the returned keyword
    daily_clicks_min float the minimum value of daily clicks
represents the minimum number of daily clicks on the paid result in Google SERP for the returned keyword
    daily_clicks_max float the maximum value of daily clicks
represents the maximum number of daily clicks on the paid result in Google SERP for the returned keyword
    bid integer the maximum bid
we return the results for the 999 bid value to provide the most relevant impressions data
    daily_cost_avg float the average daily cost
represents the average daily cost of running ads for the returned keyword in Google Ads
    daily_cost_min float the minimum daily cost
represents the minimum daily cost of running ads for the returned keyword in Google Ads
    daily_cost_max float the maximum daily charge value
represents the maximum daily cost of running ads for the returned keyword in Google Ads
    time_update string date and time when keyword data was last updated
in the format: “month/date/year hours:minutes:seconds UTC”
example:
05/08/2020 09:47:05
bing_keyword_info array keyword data based on bing ads
note: bing data is available for a limited number of locations and languages
    search_volume integer monthly number of searches on bing
represents the number of searches for the given keyword idea on bing.com for the past month
    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
    history array monthly searches
represents the number of monthly Bing searches on the returned keyword in the given location
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

‌‌

The database in JSON contains data structured like in the example below:

{
  "keyword": "الرسم ثلاثي الابعاد",
  "location": 2818,
  "language": "ar",
  "spell": null,
  "spell_type": null,
  "keyword_info": {
    "search_volume": 720,
    "cpc": 0.015523,
    "competition": 0.019329507701600728,
    "time_update": "2021-03-24T04:01:47.4351095Z",
    "categories": [
      10013,
      10108,
      13388,
      13595,
      13691,
      13692
    ],
    "history": {
      "202003": 1000,
      "202004": 1000,
      "202005": 880,
      "202006": 1000,
      "202007": 720,
      "202008": 590,
      "202009": 480,
      "202010": 480,
      "202011": 480,
      "202012": 590,
      "202101": 590,
      "202102": 480
    }
  },
  "impressions_info": {
    "ad_position_avg": null,
    "ad_position_min": null,
    "ad_position_max": null,
    "cpc_avg": null,
    "cpc_min": null,
    "cpc_max": null,
    "daily_impressions_avg": 0,
    "daily_impressions_min": 0,
    "daily_impressions_max": 0,
    "daily_clicks_avg": 0,
    "daily_clicks_min": 0,
    "daily_clicks_max": 0,
    "bid": 999,
    "daily_cost_avg": 0,
    "daily_cost_min": 0,
    "daily_cost_max": 0,
    "time_update": "2021-03-19T14:07:03.9208731Z"
  },
  "bing_keyword_info": null,
  "extra": {
    "core_keyword": "رسومات ثلاثية الابعاد"
  }
},
{
  "keyword": "الاميرة هيا",
  "location": 2818,
  "language": "ar",
  "spell": null,
  "spell_type": null,
  "keyword_info": {
    "search_volume": 720,
    "cpc": 0.009519,
    "competition": 0.0033973161202649907,
    "time_update": "2021-03-31T21:57:05.1516650Z",
    "categories": [
      10013,
      10018,
      10108,
      10584,
      13414,
      13444
    ],
    "history": {
      "202003": 2900,
      "202004": 880,
      "202005": 590,
      "202006": 590,
      "202007": 720,
      "202008": 590,
      "202009": 480,
      "202010": 390,
      "202011": 390,
      "202012": 390,
      "202101": 390,
      "202102": 880
    }
  },
  "impressions_info": {
    "ad_position_avg": null,
    "ad_position_min": null,
    "ad_position_max": null,
    "cpc_avg": null,
    "cpc_min": null,
    "cpc_max": null,
    "daily_impressions_avg": 0,
    "daily_impressions_min": 0,
    "daily_impressions_max": 0,
    "daily_clicks_avg": 0,
    "daily_clicks_min": 0,
    "daily_clicks_max": 0,
    "bid": 999,
    "daily_cost_avg": 0,
    "daily_cost_min": 0,
    "daily_cost_max": 0,
    "time_update": "2021-03-28T14:05:34.4503662Z"
  },
  "bing_keyword_info": null,
  "extra": {
    "core_keyword": null
  }
}