Google Trends: Most-used fields

The table below gives information about most-used fields that you can import from Google Trends. 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
Related queries	Related queries	Provides search queries that are related to the input keywords, categorized into ‘Top’ queries (most popular) and ‘Rising’ queries (those with significant growth in search interest).	dimension
category	category	An integer code representing the search category, allowing users to filter trends by specific topics like Business, Entertainment, or Sports. A value of 0 typically represents all categories.	dimension
date	date	The calendar date associated with the search trend data.	dimension
end	end	The end date and time of the data collection period for a specific trend or report.	dimension
ended_at	ended_at	The end date and time of the data collection period for a specific trend or search interest query.	dimension
formattedTime	formattedTime	A human-readable string representing the time point for which the search interest data is provided. This can be formatted in various granularities such as hourly, daily, weekly, or monthly, depending on the requested time range and aggregation.	dimension
formattedValue	formattedValue	A numerical representation of the search interest for a specific keyword or topic at a particular point in time, scaled relative to other data points. This value indicates the popularity of a search query.	dimension
geoCode	geoCode	A standardized code representing a geographic region, used for filtering or reporting search interest by location.	dimension
geoName	geoName	The human-readable name of the geographic region, such as a country, state, or city.	dimension
hasData	hasData	A boolean indicator specifying whether search interest data is available for the corresponding time point. If true, data exists; if false, no data was recorded or is available for that period.	dimension
keyword	keyword	A specific word or phrase that users search for on Google, used to track search interest.	dimension
query	query	A search term or phrase submitted by users, often appearing in reports like ‘Related Queries’.	dimension
search_volume	search_volume	The raw, approximate number of searches for a given keyword or topic within the specified time frame. This value reflects the popularity of the search query.	metric
search_volume_growth	search_volume_growth	The percentage increase in search interest for a topic within a specific time window, indicating how rapidly its popularity is rising.	metric
start	start	The start date and time of the data collection period for a specific trend or report.	metric
started_at	started_at	The timestamp indicating the beginning of the trend or the start of the data collection period for search interest.	dimension
time	time	This field indicates the timestamp or the specific time range associated with the collected trend data. Its granularity can vary from years to minutes, depending on the specified time range for the report.	metric
trend_breakdown	trend_breakdown	A detailed analysis or categorization of a trend, such as its popularity across different geographical regions, related search queries, or associated topics.	dimension
trend_name	trend_name	The primary keyword, search term, or topic that the trend represents.	dimension
value	value	The numerical search interest value for a specific time period, scaled from 0 to 100. A value of 100 signifies the highest popularity for the term, while 0 indicates less than 1% of the peak popularity. These values are relative and not absolute search counts.	metric