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 |
|---|---|---|---|
Date |
Date |
The calendar date associated with the search trend data. |
metric |
Report End Date |
Report End Date |
The final date included in the data for a specific report. |
dimension |
Report Start Date |
Report Start Date |
The initial date included in the data for a specific report. |
dimension |
category |
category |
An identifier that filters search trend data by a predefined Google Trends category, such as ‘Autos & Vehicles’ or ‘Beauty & Fitness’. |
dimension |
country_code_iso |
country_code_iso |
The ISO 3166-1 alpha-2 country code representing the geographic region for which data is collected or filtered (e.g., ‘US’ for United States). |
dimension |
data_category |
data_category |
This field specifies the type of Google Trends report or data category being generated. Examples include ‘Interest Over Time’ for historical trends, ‘Interest by Region’ for geographical distribution, ‘Related Queries’, or ‘Related Topics’. |
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 timestamp indicating the end of a specific trend or data collection period. |
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 |
This field represents the search interest data point, typically scaled from 0 to 100, where 100 indicates peak popularity for the given search term, region, and time. For rapidly increasing related queries or topics, it may also show ‘Breakout’ to signify a tremendous increase in search frequency. |
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 |
keywords |
keywords |
A list of search terms or phrases used for analysis, allowing comparison of 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 relative popularity or interest level of a search query, represented as a numerical index rather than absolute search counts. |
metric |
search_volume_growth |
search_volume_growth |
The percentage or factor indicating the increase in search volume for a specific query over a recent period, often used in ‘Trending Now’ reports to highlight searches with significant traffic spikes. |
metric |
start |
start |
The start date and time of the data collection period for a specific trend or report. |
dimension |
started_at |
started_at |
The timestamp indicating the start of a specific trend or data collection period. |
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 |
topic.mid |
topic.mid |
A unique machine identifier for a related topic, often used to link to specific entities or concepts. |
dimension |
topic.title |
topic.title |
The human-readable title or name of a related topic. |
dimension |
topic.type |
topic.type |
The category or type of a related topic, such as a celebrity, product, or event. |
dimension |
trend_breakdown |
trend_breakdown |
Detailed data providing further context or categorization of a trend. This can include geographical distribution of search interest (‘Interest by Region’) or lists of related topics and queries (‘Related Topics / Related Queries’). |
dimension |
trend_name |
trend_name |
The descriptive name of a currently trending search topic or query. |
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 |