Awario: Most-used fields

The table below gives information about most-used fields that you can import from Awario. 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
Total Mentions	mentions	The total count of all social media and web mentions for a specific alert or query within a given period. This is an aggregated analytics metric.	metric
alert_id	alert_id	A unique identifier for the monitoring alert that collected the mentions or insights.	dimension
alert_name	alert_name	The name of the monitoring alert configured in Awario.	dimension
alert_type	alert_type	The type of monitoring alert, indicating whether it’s for mentions or leads.	dimension
countries_mentions	countries_mentions	The count of mentions originating from a specific country. This is an aggregated insight related to geographical distribution.	metric
countries_name	countries_name	The name of the country where mentions originated. This field is typically aggregated in insights reports, showing top countries by mention volume.	dimension
date	date	The date when the mention was published or the time period for aggregated insights. Dates can be used for filtering mentions and insights.	dimension
end_date	end_date	The end date of the time period for which mentions or insights data is retrieved.	dimension
incomplete_period	incomplete_period	Indicates if the current time period for which insights are provided is incomplete (e.g., the current day, week, or month that has not fully passed).	dimension
mention_author_audience	mention_author_audience	The estimated audience size or influence of the author who created the mention. While ‘reach’ is a broader metric, this refers to the author’s specific audience potential.	metric
mention_author_avatar	mention_author_avatar	The URL to the author’s avatar or profile picture.	dimension
mention_author_description	mention_author_description	A descriptive text about the author of the mention, often their bio or a summary of their profile.	dimension
mention_author_entities_name_highlighted_text_0_end_index	mention_author_entities_name_highlighted_text_0_end_index	The end index of the first highlighted text within the author’s name, indicating where a specific keyword or entity ends.	dimension
mention_author_entities_name_highlighted_text_0_start_index	mention_author_entities_name_highlighted_text_0_start_index	The start index of the first highlighted text within the author’s name, indicating where a specific keyword or entity begins.	dimension
mention_author_entities_name_highlighted_text_0_text	mention_author_entities_name_highlighted_text_0_text	The actual text that was highlighted within the author’s name, often corresponding to keywords being monitored.	dimension
mention_author_name	mention_author_name	The name or handle of the author or user who published the social media mention. This field can be used for filtering mentions.	dimension
mention_author_url	mention_author_url	The URL to the author’s profile or page on the respective social media platform or website.	dimension
mention_author_written_by	mention_author_written_by	The name of the author or contributor, often provided for mentions from news and blog sources.	dimension
mention_done	mention_done	A boolean indicator specifying whether the mention has been marked as ‘done’ or processed within the Awario platform.	dimension
mention_id	mention_id	A unique identifier for the specific social media mention, allowing for individual tracking and retrieval.	dimension
mention_language	mention_language	The language in which the social media mention was originally published. It can be used as a filter or for insights on language distribution.	dimension
mention_location_country	mention_location_country	The country identified as the origin of the social media mention. This field is available for filtering and aggregated insights.	dimension
mention_location_latitude	mention_location_latitude	The latitude coordinate of the location associated with the mention, if geo-tagged information is available.	metric
mention_location_longitude	mention_location_longitude	The longitude coordinate of the location associated with the mention, if geo-tagged information is available.	metric
mention_reach	mention_reach	The estimated number of unique individuals who have potentially seen the social media mention. It can be filtered by and is available as an insight type.	metric
mention_sentiment	mention_sentiment	The emotional tone or sentiment of the social media mention, categorized as positive, negative, or neutral. This is a key feature for sentiment analysis and insights.	dimension
mention_snippet	mention_snippet	A short excerpt or preview of the content of the social media mention. The Mentions Report provides full metadata for individual mentions.	dimension
mention_source	mention_source	The platform or website where the social media mention originated (e.g., Facebook, Twitter, news-blogs). It’s a key filter and insight type.	dimension
mention_starred	mention_starred	A boolean indicator specifying whether the mention has been marked as ‘starred’ for importance or follow-up within the Awario platform.	dimension
mention_title	mention_title	The title associated with the social media mention, typically applicable to articles, blog posts, or web results rather than short social media posts.	dimension
mention_url	mention_url	The direct URL or link to the original social media mention, enabling access to the source content.	dimension
mentions_count	mentions_count	The aggregated count of mentions for a given period or filter.	metric
project_id	project_id	A unique identifier for the project under which alerts are managed in Awario.	dimension
project_name	project_name	The name of the project associated with the alerts in Awario.	dimension
sentiment_negative	sentiment_negative	The count of mentions classified with a negative sentiment.	metric
sentiment_neutral	sentiment_neutral	The count of mentions classified with a neutral sentiment.	metric
sentiment_positive	sentiment_positive	The count of mentions classified with a positive sentiment.	metric
start_date	start_date	The start date of the time period for which mentions or insights data is retrieved.	dimension
timestamp	timestamp	The date and time when the social media mention was published, typically provided in UTC timestamp format.	dimension
topic_cloud_mentions	topic_cloud_mentions	The count of mentions associated with a specific topic within the Topic Cloud.	metric
topic_cloud_name	topic_cloud_name	The name of a topic identified in the Topic Cloud, representing key themes in mentions.	dimension