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 country associated with the mention’s location, typically represented by its name.	dimension
date	date	The date and time when the mention was published or recorded, represented as a UTC timestamp in milliseconds.	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 data for a given time period is incomplete, typically found in time series insights.	dimension
mention_author_audience	mention_author_audience	The estimated audience reach or follower count of the author who published the mention.	metric
mention_author_avatar	mention_author_avatar	The URL to the avatar or profile picture of the author who published the mention.	dimension
mention_author_description	mention_author_description	A description or bio of the author who published the mention.	dimension
mention_author_entities_name_highlighted_text_0_end_index	mention_author_entities_name_highlighted_text_0_end_index	The end index of a highlighted text entity within the mention’s content snippet. This indicates the position where the highlighted segment concludes.	dimension
mention_author_entities_name_highlighted_text_0_start_index	mention_author_entities_name_highlighted_text_0_start_index	The start index of a highlighted text entity within the mention’s content snippet. This indicates the position where the highlighted segment begins.	dimension
mention_author_entities_name_highlighted_text_0_text	mention_author_entities_name_highlighted_text_0_text	The actual text of a highlighted entity found within the mention’s content snippet.	dimension
mention_author_name	mention_author_name	The display name or username of the author who published the mention.	dimension
mention_author_url	mention_author_url	The URL to the profile page or website of the author who published the mention.	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’ in the Awario platform, indicating it has been processed or acted upon.	dimension
mention_id	mention_id	A unique identifier for the individual mention record.	dimension
mention_language	mention_language	The language in which the mention was published, typically represented by an ISO language code (e.g., ‘en’ for English).	dimension
mention_location_country	mention_location_country	The ISO country code associated with the geographical location where the mention originated.	dimension
mention_location_latitude	mention_location_latitude	The geographical latitude coordinate associated with the mention’s origin.	metric
mention_location_longitude	mention_location_longitude	The geographical longitude coordinate associated with the mention’s origin.	metric
mention_reach	mention_reach	The estimated potential reach or viewership of the mention across its source platform.	metric
mention_sentiment	mention_sentiment	The sentiment expressed in the mention, categorized as positive, negative, or neutral.	dimension
mention_snippet	mention_snippet	A short excerpt or fragment of the mention’s content.	dimension
mention_source	mention_source	The platform or channel where the mention was found (e.g., ‘youtube’, ‘news-blogs’, ‘web’).	dimension
mention_starred	mention_starred	A boolean indicator specifying whether the mention has been marked as ‘starred’ or favorited in the Awario platform.	dimension
mention_title	mention_title	The title of the page or post where the mention was found.	dimension
mention_url	mention_url	The direct URL to the original mention on its source platform.	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 timestamp indicating when the mention was created or recorded, equivalent to the ‘date’ field and represented in UTC milliseconds.	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