Mention Field Definitions

Field	Definition	Possible Values
accountType	Account Type is the type of account ('individual' or 'organisational') that a Twitter author has. This is a Twitter specific metric, and will be null for mentions not originating from Twitter.	null, "individual", "organisational"
added	Added is the date when the mention was added to the Brandwatch query (either by regular crawling or a backfill).	string
assignment	Assignment is part of the Brandwatch workflow functionality and allows you to send a mention to another Brandwatch user to check.	null, or the email address (string) of a User with access to the given Project
author	Author is the nick name, user name or full name of the person who posted a mention. The name depends on the site on which it has been found.	"", or the author (string) of the mention
authorCity	Deprecated
authorCityCode	Deprecated
authorContinent	Deprecated
authorContinentCode	Deprecated
authorCountry	Deprecated
authorCountryCode	Deprecated
authorCounty	Deprecated
authorCountyCode	Deprecated
authorLocation	Deprecated
authorState	Deprecated
authorStateCode	Deprecated
authorVerifiedType	Category of verification held by Twitter author	ie. "blue", "business", "government"
avatarUrl	Avatar URL is the URL of the author's Twitter avatar. This is only available for mentions originating from Facebook, Instagram or Twitter.	null, or the URL (string) of the author's avatar
averageDurationOfVisit	Deprecated
averageVisits	Deprecated
backlinks	Deprecated
blogComments	Deprecated
blogName	Name of the Tumblr page.	null or string
categories	Categories is an array of IDs of any categories that are applied to the mention.	Empty array, or a array of category IDs (int)
categoryDetails	Category Details is an array of details (ID of the category, name of the category, ID of the parent category, name of the parent category) for each of the categories that is applied to the mention.	Empty array, or an array of objects with details about each Category. These objects would each be in the format: {id: int, name: string, parentId: int, parentName: string}
checked	Checked is part of the Brandwatch workflow functionality and can be used to indicate that a mention has been reviewed.	TRUE, FALSE
city	City is the name of the city from which the mention originated.	null, or the city name (string)
cityCode	City Code is the shortcode for the city from which the mention originated.	null, or the city code (string) (e.g. "bos1")
classifications	Classifications is an array of details (ID of the classifier, ID of the classification, name of the classification, ID of the training set and the confidence score of the classification) for each classification that is applied to the Mention.	Omitted if empty or an array of objects with details of each classification.
continent	Continent is the name of the continent from which the mention originated.	null, or the continent name (string)
continentCode	Continent Code is the shortcode for the continent from which the mention originated.	null, or the continent code (string) (e.g. "n-a")
copyright	Copyright information for a Lexis Nexis mention	string
country	Country is the name of the country from which the mention originated.	null, or the country name (string)
countryCode	Country Code is the shortcode for the country from which the mention originated.	null, or the country code (string) (e.g. "us")
county	Deprecated	Alternative: region
countyCode	Deprecated	Alternative: regionCode
date	Date is the date when the mention was posted.	"YYYY-MM-DD'T'hh:mm:ss:xx.xx+xxxx"
displayUrls	Display URLs are the shortened links that appear in a mention. This is a Twitter specific metric, and will be null for mentions not originating from Twitter.	null, empty array, or a list of the shortened URLs (string)
domain	Domain is the domain name of the website from which the mention originated.	domain (string) that the mention originated from
engagement	Deprecated	null or int
entityInfo	An array of details describing entities (AI terms) found in the Mention text. "entityId": an integer number/identifier for the WikiData item associated with an entity "entityConfidence": An indication of how confident the AI engine is that it has found the correct match on WikiData (HIGH, MEDIUM, LOW, VERY_LOW) "url": Link to the WikiData entry describing the entity	Empty array or an array containing: "entityId", "entityConfidence" and "url".
expandedUrls	Display URLs are the full URLs for any shortened links that appear in a mention. This is a Twitter specific metric, and will be null for mentions not originating from Twitter.	null, empty list, or a list of the expanded URLs (string)
facebookAuthorId	Facebook Author Id is the unique id of the Facebook author. This is a Facebook specific metric, and will be null for mentions not originating from Facebook.	null, or the author id (string)
facebookComments	Facebook Comments is the number of comments on a Facebook mention. This is a Facebook specific metric, and will be 0 for mentions not originating from Facebook.	0, or a positive integer
facebookLikes	Facebook Likes is the number of Likes on a Facebook mention. This is a Facebook specific metric, and will be 0 for mentions not originating from Facebook.	0, or a positive integer
facebookRole	Facebook Role is the role of the Facebook user who authored the post ('owner' or 'audience'). A Facebook role of 'owner' would indicate that the author is posting on their own page, whereas a Facebook role of 'audience' would indicate that an author is posting on someone else's Facebook page. This is a Facebook specific metric, and will be null for mentions not originating from Facebook.	null, "owner", "audience"
facebookShares	Facebook Shares is number of times that a Facebook mention has been shared. This is a Facebook specific metric, and will be 0 for mentions not originating from Facebook.	0, or a positive integer
facebookSubtype	Facebook Subtype is the type of media shared in a Facebook mention ('link', 'photo', 'status' or 'video'). This is equivalent to the Facebook Media Type shown in the front end of the Brandwatch Analytics platform. This is a Facebook specific metric, and will be null for mentions not originating from Facebook.	null, "link", "photo", "status", "video"
forumPosts	Deprecated
forumViews	Deprecated	0, or a positive integer
fullname	Full Name is the full name of the author who posted the mention.	null, or author's full name (string)
gender	Gender is the gender ('male', 'female', 'unknown') of an author. This is a Twitter specific metric, and will be 'unknown' for mentions not originating from Twitter.	"male", "female", "unknown"
id	Deprecated
imageInfo	An array of details (URL of image, dimensions of image, dominant color of image, objects found in image, and scenes found in image) of the image analysis done on an image in a Mention. Additional information for image object and scene IDs can be found by using endpoints in the Objects & Logos article.	Empty array or array of details of image analysis
impact	Impact is a Brandwatch metric to measure the potential impact of an author, site or mention. It's a logarithmic scale between 0-100 normalised for your data to help you find what's most interesting. The impact score takes into account how much potential a mention has to be seen, as well as how many times a mention has been viewed, shared or retweeted.	A decimal from 0-100
importanceAmplification	Internally used to calculate the Impact Score.	0, or a positive integer
importanceReach	Internally used to calculate the Reach Score.	0, or a positive integer
impressions	Impressions is the potential number of viewers of a tweet. This is calculated by taking the sum of the followers of the account that originally posted a tweet, and the followers of any accounts that retweeted it. This is a Twitter specific metric, and will be 0 for mentions not originating from Twitter.	0, or a positive integer
influence	Deprecated
insightsHashtag	Insights Hashtags is an array of hashtags identified within the mention. This is a Twitter and Instagram specific metric, and will be empty for mentions not originating from Twitter or Instagram.	Empty array, or array of strings
insightsMentioned	Insights Mentioned is an array of user handles identified within the mention. This is a Twitter and Instagram specific metric, and will be empty for mentions not originating from Twitter or Instagram.	Empty array, or array of strings
instagramCommentCount	Instagram Comment Count is the number of comments on an Instagram mention. This is an Instagram specific metric, and will be 0 for mentions not originating from Instagram.	0, or a positive integer
instagramFollowerCount	Instagram Followers Count is the number of followers of the Instagram mention's author. This is an Instagram specific metric, and will be 0 for mentions not originating from Instagram.	0, or a positive integer
instagramFollowingCount	Instagram Following Count is the number of users that the author of an Instagram mention is following. This is an Instagram specific metric, and will be 0 for mentions not originating from Instagram.	0, or a positive integer
instagramInteractionsCount	Instagram Interactions Count is the sum of likes and posts on an Instagram mention. This is an Instagram specific metric, and will be 0 for mentions not originating from Instagram.	0, or a positive integer
instagramLikeCount	Instagram Like Count is the number of likes on an Instagram mention. This is an Instagram specific metric, and will be 0 for mentions not originating from Instagram.	0, or a positive integer
instagramPostCount	Instagram Post Count is the overall number of posts the author of an Instagram mention has made. This is an Instagram specific metric, and will be 0 for mentions not originating from Instagram.	0, or a positive integer
interest	Interest is an array of the interests that are mentioned in the Twitter bio of the individual (not organization) that authored the mention. This is a Twitter specific metric, and will be an empty list for mentions not originating from Twitter.	Empty array, or an array of interests. All possible interests are: "Animals & Pets", "Fine arts", "Automotive", "Beauty/Health & Fitness", "Books", "Business", "Environment", "Family & Parenting", "Fashion", "Movies", "Food & Drinks", "Games", "Music", "Photo & Video", "Politics", "Science", "Shopping", "Sports", "Technology", "Travel", "TV"
itemReview	The item being reviewed in a review mention	null or string
language	Language is the shortcode for the language in which the mention was written.	Shortcode for the language (string) (e.g."en")
lastAssignmentDate	Last Assignment Date is part of the Brandwatch workflow functionality and shows the date when the mention was last assigned to a Brandwatch user. If the mention has never been assigned to a user, this field will be null.	null, or "YYYY-MM-DD'T'hh:mm:ss:xx.xx+xxxx"
latitude	Latitude of a geo-tagged Tweet. This is a Twitter specific metric, and will be 0 for mentions not originating from Twitter as well as mentions that have not been goe-tagged.	float
linkedinComments	Number of comments on a LinkedIn mention. This is a LinkedIn specific metric and will be 0 for mentions not originating from LinkedIn.	int
linkedinEngagement	Number of likes, comments, clicks & shares divided by the number of impressions for a LinkedIn mention. This is a LinkedIn specific metric and will be 0 for mentions not originating from LinkedIn.	float
linkedinImpressions	Number of impressions on a LinkedIn mention. This is a LinkedIn specific metric and will be 0 for mentions not originating from LinkedIn.	int
linkedinLikes	Number of likes on a LinkedIn mention. This is a LinkedIn specific metric and will be 0 for mentions not originating from LinkedIn	int
linkedinShares	Number of times a LinkedIn mention has been shared. This is a LinkedIn specific metric and will be 0 for mentions not originating from LinkedIn.	int
linkedinSponsored	Whether the LinkedIn post is sponsored or organic	string; 'sponsored' or 'organic'
linkedinVideoViews	Number of times a user has viewed a LinkedIn video for longer than 3 seconds. This is a LinkedIn specific metric and will be 0 for mentions not originating from LinkedIn.	int
locationName	Location name of a geo-tagged Instagram mentions. This is an Instagram specific metric, and will be null for mentions not originating from Instagram as well as mentions that have not been geo-tagged.	null, or string
longitude	Longitude of a geo-tagged Tweet. This is a Twitter specific metric, and will be 0 for mentions not originating from Twitter as well as mentions that have not been geo-tagged.	float
matchPositions	Match Positions is an array of details about words from the mention that matched the query string.	Array of objects in the following format: {length: int, start: int, text: string}
mediaFilter	Media Filter is the image filter that was used on an Instagram mention. This is an Instagram specific metric, and will be null for mentions not originating from Instagram.	null, or the filter (string) used on the Instagram mention
mediaUrls	Media URLs is a list of the URLs associated with any media (e.g. photo, video) attached to the mention.	null, empty list, or a list of URLs (string)
monthlyVisitors	Monthly Visitors is a metric pertaining to the traffic for the site that the mention originated from. It is the total number of unique visitors who have been to the website that month.	0, or a positive integer
mozRank	Deprecated
noteIds	Deprecated
originalUrl	Original URL is the URL of the tweet. If the tweet is a retweet or a reply it will be the URL of the original being retweeted or replied to. This is a Twitter specific metric, and will be null for mentions not originating from Twitter.	null, or the URL (string) of the original tweet
outreach	Deprecated
pageTypeName	Describes the kind of website the mention was found on in a more human-readable way.	"Blogs", "YouTube", "Dark Web", "QQ", "Facebook", "Tumblr", "Instagram", "Forums", "Twitter", "VK", "Review", "Sina Weibo", "Reddit", "4Chan", "LexisNexis Licensed News", "News"
pagesPerVisit	Deprecated
parentPostId	The unique ID of the parent post on Tumblr. Used to track reblogs of a specific post from a specific page on Tumblr and reblogs of those.	null or int
parentBlogName	Name of the parent page on Tumblr. Used to track content reblogged from a specific Tumblr page.	null or string
percentFemaleVisitors	Deprecated
percentMaleVisitors	Deprecated
priority	Priority is part of the Brandwatch workflow functionality and can be used to indicate the priority of a mention (e.g. 'high', 'medium', 'low'). If the mention has never been marked with a priority, this field will be null.	null, "n/a", "low", "medium", "high"
professions	Profession is an array of the professions that are mentioned in the Twitter bio of the individual (not organization) that authored the mention. This is a Twitter specific metric, and will be an empty list for mentions not originating from Twitter.	Empty array, or an array of professions. All possible professions are: "Artist", "Executive", "Health practitioner", "Journalist", "Legal", "Politician", "Sales/Marketing/PR", "Scientist & Researcher", "Software developer & IT", "Sportpersons & Trainer", "Student", "Teacher & Lecturer"
pubType	Name of the publisher of content source or the user-defined name of the custom content source.	string
publisherSubType	A publisher-defined subtype	null or string (i.e "IMAGE" is an Instagram-defined subtype)
queryId	Query Id is the unique identifier for the query that the mention originated from in Brandwatch.	int
queryName	Query Name is the name of the query that the mention originated from in Brandwatch.	string
rating	Star review rating for review mentions	null or int 1-5
reach	Deprecated
reachEstimate	Reach Estimate is a score created by Brandwatch to estimate how many individuals may have seen a piece of content. It's available for multiple data sources and enables the user to compare reach of content from different platforms and track development over time.	0, or a positive integer
redditAuthorKarma	The author's total karma at the time the post/comment was created. For more information on Karma see here. Only available on Reddit mentions.	null, or a long
redditAuthorAwardeeKarma	The author's karma from receiving awards from other users at the time the post/comment was created. For more information on Karma see here. Only available on Reddit mentions.	null, or a long
redditAuthorAwarderKarma	The author's karma from giving awards to other users at the time the post/comment was created. For more information on Karma see here. Only available on Reddit mentions.	null, or a long
redditComments	Reddit Comments is the number of comments on a reddit post. This is a Reddit specific metric, and will be 0 for mentions not originating from Reddit. This value may not exactly reflect what is shown in the Reddit UI due to the way Reddit supply the data.	0, or a positive number
redditScore	Net votes on a reddit post or comment. Number of upvotes minus the number of downvotes. Updated hourly for a period of 7 days from the time it was initially posted. This value may not exactly reflect what is shown in the Reddit UI due to the way Reddit supply the data.	null, an integer
redditScoreUpvoteRatio	The portion of votes on a message which are upvotes, expressed as a ratio between 0.0 and 1.0. Only available for Reddit Posts, not comments. This value may not exactly reflect what is shown in the Reddit UI due to the way Reddit supply the data.	null, or a float between 0.0 and 1.0
region	Region is the name of the region from which the mention originated.	null, or the region name (string) (e.g "Alaska")
regionCode	Region code is the code of the region from which the mention originated	null, or the region code (string) (e.g "USA.AK")
replyTo	Reply To is the URL of the original tweet that this tweet is in reply to. This is a Twitter specific metric, and will be null for mentions not originating from Twitter and for tweets that are not a reply to any earlier tweet.	null, or the URL (string) of the original tweet
resourceId	Resource Id is the unique identifier assigned to a mention when it is indexed in our database. This is for reference when using the Brandwatch API.	string
resourceType	Soon to be removed	null or string
retweetOf	Retweet Of is the URL of the original tweet that this tweet is a retweet of. This is a Twitter specific metric, and will be null for mentions not originating from Twitter and for tweets that are not a retweet of any earlier tweet.	null, or the URL (string) of the original tweet
rootPostId	Unique ID of the root Tumblr mention. Used to track reblogs of a specific post on Tumblr as well as reblogs of those.	null or int
rootBlogName	Name of the root Tumblr page. Used to track mentions reblogged from a specific page and reblogs of that same content on Tumblr.	null or string
sentiment	Sentiment is the tone of the mention: positive, negative or neutral.	"positive", "negative", "neutral"
shortUrls	Short URLs are the shortened links that appear in a mention. This is a Twitter specific metric, and will be null for mentions not originating from Twitter.	null, empty array, or an array of the shortened URLs (string)
snippet	Snippet is a snippet of the mention text that best matches the query.	string
starred	Starred is part of the Brandwatch workflow functionality and can be used to indicate that a mention is interesting, or to mark it for any other purpose you choose.	TRUE, FALSE
state	Deprecated	Alternative: region
stateCode	Deprecated	Alternative: regionCode
status	Status is part of the Brandwatch workflow functionality and can be used to indicate the status of a mention (e.g. 'open', 'pending', 'closed'). If the mention has never been marked with a status, this field will be null.	null, "open", "pending", "closed"
subreddit	The subreddit that the post or comment belongs to. For more information on Subreddits, see here. Only available on Reddit mentions.	null, or a string
subredditSubscribers	The number of subscribers to the subreddit which the post/comment belongs to, at the time the post/comment was created. Only available on Reddit mentions.	null, or a non-negative long
subtype	Subtype is the same as the Media Type in the UI, and indicates the type of media included within a Facebook, Twitter, or Instagram mention.	null, "photo", "video", "other", "question", "link", "status"
tags	Tags is an array of the names of any tags that are applied to the mention.	Empty array, or an array of tag names (string)
threadAuthor	Thread Author is the name of the author of the original mention in the thread.	null, or the author name (string)
threadCreated	Thread Created is the date when the original mention in the thread was posted.	null, or "YYYY-MM-DD'T'hh:mm:ss:xx.xx+xxxx"
threadEntryType	Thread Entry Type is the type of mention (post, reply, share) for mentions in a thread.	null, "reply", "post", "share"
threadId	Thread Id is the unique identifier of the thread, (as provided by Twitter or Facebook).	"0", or a the thread id (string)
threadURL	Thread URL is the URL of the full thread which this mention appears in.	null, or the URL (string) of the thread
title	Title is the title of the mention, as determined by Brandwatch.	string
trackedLinkClicks	Deprecated	null
trackedLinks	Deprecated	null
twitterAuthorId	Twitter Author Id is the unique id of the Twitter author. This is a Twitter specific metric, and will be null for mentions not originating from Twitter.	null, or a string
twitterFollowers	Twitter Followers is the number of followers of the Twitter mention's author. This is a Twitter specific metric, and will be 0 for mentions not originating from Twitter.	0, or a positive integer
twitterFollowing	Twitter Following is the number of users that the author of a Twitter mention is following. This is a Twitter specific metric, and will be 0 for mentions not originating from Twitter.	0, or a positive integer
twitterLikeCount	The number of likes a tweet has received. This metric is updated once per hour so will lag behind what is reflected in the Twitter UI. Tweets posted before Brandwatch started collecting like data will have a null value.	null, or a positive long
twitterPostCount	Twitter Post Count is the total number of tweets that the author of the mention has posted. This is a Twitter specific metric, and will be 0 for mentions not originating from Twitter.	0, or a positive integer
twitterReplyCount	Twitter Reply Count is the total number of replies to a tweet. This is a Twitter specific metric, and will be 0 for mentions not originating from Twitter.	0, or a positive integer
twitterRetweets	Twitter Retweet Count is the total number of times that a tweet has been retweeted. This is a Twitter specific metric, and will be 0 for mentions not originating from Twitter.	0, or a positive integer
twitterRole	Twitter Role is the role of the Twitter user who authored the post ('owner' or 'audience'). A Twitter role of 'owner' would indicate that the author is posting on their own channel, whereas a Twitter role of 'audience' would indicate that an author is posting on someone else's channel. This is a Twitter specific metric, and will be null for mentions not originating from Twitter.	null, "owner", "audience"
twitterVerified	Twitter Verified indicates if the author of the mention is verified on Twitter (These are large accounts, usually celebrities). This is a Twitter specific metric, and will be false for all mentions not originating from Twitter.	TRUE, FALSE
updated	Updated is the date when the mention was last modified.	string
url	URL is the URL of the mention.	string
weblogTitle	Name or ID of the specific Reddit or forum author	"", string or int (id of author)
wordCount	Deprecated	null