Google Ads Keyword Planner: Most-used fields

The table below gives information about most-used fields that you can import from Google Ads Keyword Planner. Other fields might also be available in Adverity.

The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.

API name	Adverity UI name	Description	Use in Adverity
average_cpc_micros	average_cpc_micros	The average cost-per-click (CPC) for the keyword, expressed in micro-units (one millionth of the standard currency unit). This metric is available for historical performance and keyword ideas.	metric
avg_monthly_searches	avg_monthly_searches	The average number of searches for the keyword over the past 12 months, indicating overall search interest. This metric is available for keyword ideas and historical metrics.	metric
competition	competition	The level of competition for the keyword, indicating how many advertisers are bidding on it. This metric is available for keyword ideas and historical metrics.	metric
competition_index	competition_index	A numerical index representing the competition level for a keyword. This metric is available for keyword ideas and historical metrics.	metric
customer_id	customer_id	The unique identifier for the Google Ads customer account.	dimension
customer_name	customer_name	The name associated with the Google Ads customer account.	dimension
date	date	Represents the specific date for which metrics are reported or forecasted. This field helps in analyzing performance over distinct periods.	dimension
geo_targets	geo_targets	The geographical locations or regions selected for keyword research or campaign forecasting.	dimension
high_top_of_page_bid_micros	high_top_of_page_bid_micros	The estimated 80th percentile (high range) of the top-of-page bid for a keyword, measured in micros. This indicates the higher end of what advertisers historically paid for a keyword to appear at the top of the search results page.	metric
high_top_of_page_bid_micros_converted	high_top_of_page_bid_micros_converted	The high range estimate of the top-of-page bid for the keyword, converted to the standard currency unit.	metric
keyword_idea_text	keyword_idea_text	The suggested keyword text generated by the API based on seed keywords or URLs.	dimension
language	language	The language targeted for keyword research or campaign forecasting, identified by its constant ID.	dimension
low_top_of_page_bid_micros	low_top_of_page_bid_micros	The estimated 20th percentile (low range) of the top-of-page bid for a keyword, measured in micros. This indicates the lower end of what advertisers historically paid for a keyword to appear at the top of the search results page.	metric
low_top_of_page_bid_micros_converted	low_top_of_page_bid_micros_converted	The low range estimate of the top-of-page bid for the keyword, converted to the standard currency unit.	metric
month	month	The month for which historical keyword data, such as search volumes, is reported.	metric
monthly_searches	monthly_searches	The approximate number of searches for a keyword within a specific month.	metric
report_date	report_date	The date for which the data in the report is valid. This field is used to specify the time period for which keyword planning data, such as historical metrics or forecast metrics, is retrieved.	dimension
search_query	search_query	The keyword or search term being analyzed for ideas or historical performance.	dimension
site	site	The URL of a webpage or entire website used as a ‘seed’ to generate keyword ideas.	dimension
year	year	The year for which historical keyword data is reported.	metric