Brandwatch: Most-used fields

The table below gives information about most-used fields that you can import from Brandwatch. 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
Account Type	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.	dimension
Blog Comments	blogComments	Blog Comments is the number of comments a blog has. This metric is specific to mentions from a blog page type and will be 0 for mentions originating from any other source.	metric
Category	categories	A user-defined label that has one level of hierarchy associated with it which can be applied as metadata to a Mention. A single Category will be comprised of one or multiple Subcategories. A Category must have at least one Subcategory.	dimension
Category ID	Category ID		metric
Checked	checked	Checked is part of the Brandwatch workflow functionality and can be used to indicate that a mention has been reviewed.	dimension
End Date	End Date	The end of the date range that contains the Mentions.	dimension
Facebook Comments	facebookComments	The number of comments on facebook.	metric
Facebook Likes	facebookLikes	The number of likes on facebook.	metric
Facebook Shares	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.	metric
Forum Posts	forumPosts	Forum Posts is the number of messages in the forum thread at the time the mention was found. This metric is specific to mentions from a forum page type and will be 0 for mentions originating from any other source.	metric
Forum Views	forumViews	Form Views is the number of times the forum thread has been viewed by people at the time the mention was found. This metric is specific to mentions from a forum page type and will be 0 for mentions originating from any other source.	metric
Gender	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.	dimension
Impressions	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.	metric
Influence	influence	Influence is the Kred Influence score of the author of this mention at the time the mention was found (1-1000). This is a metric provided by an external data provider Kred. This is a Twitter specific metric and will be 0 for mentions not originating from Twitter.	metric
Mention Volume	volume	Mention volume of the brand.	metric
Outreach	outreach	Outreach is the Kred Outreach score of the author of this mention at the time the mention was found (1-12). This is a metric provided by an external data provider Kred. This is a Twitter specific metric and will be 0 for mentions not originating from Twitter.	metric
Priority	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.	dimension
Project ID	Project ID	An ID of the Project Name.	metric
Project Name	Project Name	A silo within a Brandwatch user’s account to contain all their searches, settings and configurations.	dimension
Query Group ID	Query Group ID		metric
Query ID	Query ID	Query Id is the unique identifier for the query that the mention originated from in Brandwatch.	metric
Reach	reach	Reach is the sum of the Influence of the author and all of the authors who have retweeted. This is a Twitter specific metric and will be 0 for mentions not originating from Twitter.	metric
Sentiment	sentiment		dimension
Start Date	Start Date	The beginning of the date range that contains the Mentions.	dimension
Status	status		dimension
Tag	tags	A simple user-defined label that can be applied as metadata to a Mention.	dimension
Topic	Topic		dimension
Twitter Followers	twitterFollowers		metric
added	added	Added is the date when the mention was added to the Brandwatch query (either by regular crawling or a backfill).	dimension
author	author		dimension
authorAccountType	authorAccountType		dimension
authorCity	authorCity		dimension
authorCityCode	authorCityCode	Author City Code is the shortcode for the city with which a tweet’s author is associated. This is a Twitter specific metric and will be null for mentions not originating from Twitter.	dimension
authorContinent	authorContinent		dimension
authorContinentCode	authorContinentCode	Author Continent Code is the shortcode for the continent with which the tweet’s author is associated. This is a Twitter specific metric and will be null for mentions not originating from Twitter.	dimension
authorCountry	authorCountry		dimension
authorCountryCode	authorCountryCode	Author Country Code is the shortcode for the country with which the tweet’s author is associated. This is a Twitter specific metric and will be null for mentions not originating from Twitter.	dimension
authorCounty	authorCounty		dimension
authorCountyCode	authorCountyCode	Author County Code is the shortcode for the county with which the tweet’s author is associated. This is a Twitter specific metric and will be null for mentions not originating from Twitter.	dimension
authorGender	authorGender	Gender of an author.	dimension
authorLocation	authorLocation	Author Location is the location with which the tweet’s author is associated. This is displayed in shortcode in the following format: continent country state county city. This is a Twitter specific metric and will be null for mentions not originating from Twitter.	dimension
authorName	authorName	Name of the author.	dimension
authorState	authorState		dimension
authorStateCode	authorStateCode	Author State Code is the shortcode for the state with which the tweet’s author is associated. This is a Twitter specific metric, and will be null for mentions not originating from Twitter.	dimension
authorVerifiedType	authorVerifiedType		dimension
authors	Authors		metric
avatarUrl	avatarUrl	Avatar URL is the URL of the author’s Twitter avatar. This is only available for mentions originating from Facebook Instagram or Twitter.	dimension
averageDurationOfVisit	averageDurationOfVisit	Average Duration of Visit is a metric pertaining to the traffic for the site that the mention originated from. It is the average number of minutes spent on the website by visitors.	metric
averageVisits	averageVisits	Average Visits is a metric pertaining to the traffic for the site that the mention originated from. It is calculated by taking the total number of visits to the site and dividing it by the total number of visitors to the site.	metric
backlinks	backlinks	Backlinks is the number of pages across the web that link to this website. This is a metric provided by an external data provider.	metric
blogName	blogName		dimension
blueskyAuthorId	blueskyAuthorId		dimension
blueskyFollowers	blueskyFollowers		dimension
blueskyFollowing	blueskyFollowing		dimension
blueskyLikes	blueskyLikes		dimension
blueskyPosts	blueskyPosts		dimension
blueskyQuotes	blueskyQuotes		dimension
blueskyReplies	blueskyReplies		dimension
blueskyReposts	blueskyReposts		dimension
canApplyMarkup	canApplyMarkup		dimension
canApplySegmentation	canApplySegmentation		dimension
canApplyWorkflow	canApplyWorkflow		dimension
canEditMarkup	canEditMarkup		dimension
canEditMetadata	canEditMetadata		dimension
canEditSegmentation	canEditSegmentation		dimension
canEditWorkflow	canEditWorkflow		dimension
categories	Category	Categories is an array of IDs of any categories that are applied to the mention.	dimension
categoryDetails	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.	dimension
cities	City		dimension
city	city		dimension
cityCode	cityCode	City Code is the shortcode for the city from which the mention originated.	dimension
classifications	classifications	The process in which ideas and objects are recognized, differentiated, and understood.	dimension
contentSource	contentSource		dimension
contentSourceName	contentSourceName		dimension
continent	continent		dimension
continentCode	continentCode	Continent Code is the shortcode for the continent from which the mention originated.	dimension
copyright	copyright		dimension
counties	County		dimension
countries	Country		dimension
country	country		dimension
countryCode	countryCode	Country Code is the shortcode for the country from which the mention originated.	dimension
countryName	countryName	Country is the name of the country from which the mention originated.	dimension
county	county		dimension
countyCode	countyCode		dimension
custom	custom		dimension
dailyVisitors	dailyVisitors		metric
data.authorAccountType	data.authorAccountType		dimension
data.authorCityCode	data.authorCityCode		dimension
data.authorCityName	data.authorCityName		dimension
data.authorContinentCode	data.authorContinentCode		dimension
data.authorContinentName	data.authorContinentName		dimension
data.authorCountryCode	data.authorCountryCode		dimension
data.authorCountryName	data.authorCountryName		dimension
data.authorCountyCode	data.authorCountyCode		dimension
data.authorCountyName	data.authorCountyName		dimension
data.authorGender	data.authorGender		dimension
data.authorName	data.authorName		dimension
data.authorReach	data.authorReach		metric
data.authorStateCode	data.authorStateCode		dimension
data.authorStateName	data.authorStateName		dimension
data.averageDurationOfVisit	data.averageDurationOfVisit		metric
data.averageVisits	data.averageVisits		metric
data.backlinks	data.backlinks		metric
data.countryCode	data.countryCode		dimension
data.countryName	data.countryName		dimension
data.domain	data.domain		dimension
data.facebookAuthorId	data.facebookAuthorId		metric
data.facebookComments	data.facebookComments		metric
data.facebookLikes	data.facebookLikes		metric
data.impact	data.impact		metric
data.impactAmplification	data.impactAmplification		metric
data.impactReach	data.impactReach		metric
data.monthlyVisitors	data.monthlyVisitors		metric
data.mozRank	data.mozRank		metric
data.pagesPerVisit	data.pagesPerVisit		metric
data.percentFemaleVisitors	data.percentFemaleVisitors		metric
data.percentMaleVisitors	data.percentMaleVisitors		metric
data.sentiment.negative	data.sentiment.negative		metric
data.sentiment.neutral	data.sentiment.neutral		metric
data.sentiment.positive	data.sentiment.positive		metric
data.twitterAtMentions	data.twitterAtMentions		metric
data.twitterAvatar	data.twitterAvatar		dimension
data.twitterFollowers	data.twitterFollowers		metric
data.twitterFollowing	data.twitterFollowing		metric
data.twitterInfluence	data.twitterInfluence		metric
data.twitterOutreach	data.twitterOutreach		metric
data.twitterReplyCount	data.twitterReplyCount		metric
data.twitterRetweets	data.twitterRetweets		metric
data.twitterTweets	data.twitterTweets		metric
data.twitterVerified	data.twitterVerified		dimension
date	date	Date is the date when the mention was posted.	dimension
days	Day		dimension
displayUrls	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.	dimension
domain	domain		dimension
domains	Domain		dimension
engagement	engagement	Deprecated.	metric
engagementType	engagementType		dimension
entityInfo	entityInfo		dimension
expandedUrls	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.	dimension
facebookAuthorId	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.	dimension
facebookRole	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.	dimension
facebookSubtype	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.	dimension
forumPosts	Forum Posts		metric
fullname	fullname	Full Name is the full name of the author who posted the mention.	dimension
gender	Gender		dimension
guid	guid		metric
hour	hour		dimension
hourOfDay	Hour of Day		dimension
id	id	Id is a unique identifier given to each mention by Brandwatch.	dimension
imageInfo	imageInfo		dimension
impact	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.	metric
importanceAmplification	importanceAmplification	The number of importance Amplification.	metric
importanceReach	importanceReach	The number of importance Reach.	metric
impressions	Impressions		metric
insightsHashtag	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.	dimension
insightsMentioned	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.	dimension
instagramCommentCount	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.	metric
instagramFollowerCount	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.	metric
instagramFollowingCount	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.	metric
instagramInteractionsCount	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.	metric
instagramLikeCount	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.	metric
instagramPostCount	instagramPostCount	Instagram Post Count is the number of posts on an Instagram mention. This is an Instagram specific metric and will be 0 for mentions not originating from Instagram.	metric
interest	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.	dimension
itemReview	itemReview		dimension
language	language		dimension
languages	Language		dimension
lastAssignmentDate	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.	dimension
latitude	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.	metric
linkedinComments	linkedinComments		metric
linkedinEngagement	linkedinEngagement		metric
linkedinImpressions	linkedinImpressions		metric
linkedinLikes	linkedinLikes		metric
linkedinShares	linkedinShares		metric
linkedinSponsored	linkedinSponsored		dimension
linkedinVideoViews	linkedinVideoViews		metric
locationName	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.	dimension
longitude	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.	metric
matchPositions	matchPositions	Match Positions is an array of details about words from the mention that matched the query string.	dimension
mediaFilter	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.	dimension
mediaType	mediaType		dimension
mediaUrls	mediaUrls	Media URLs is a list of the URLs associated with any media (e.g. photo video) attached to the mention.	dimension
mentions	mentions		metric
monthlyVisitors	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.	metric
months	Month		dimension
mozRank	mozRank	mozRank measures site credibility similar to Google’s PageRank. It’s on a scale of 1-10 where 10 is most credible. This is a metric provided by an external data provider Moz.	metric
noteIds	noteIds	Note Ids is part of the Brandwatch workflow functionality and shows an array of the ids of any notes that have been added to the mention.	dimension
originalUrl	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.	dimension
pageType	pageType		dimension
pageType.blog	pageType.blog	The kind of website the mention was found.	metric
pageType.bluesky	pageType.bluesky		metric
pageType.facebook	pageType.facebook	The kind of website the mention was found.	metric
pageType.forum	pageType.forum	The kind of website the mention was found.	metric
pageType.general	pageType.general	The kind of website the mention was found.	metric
pageType.image	pageType.image	The kind of website the mention was found.	metric
pageType.instagram	pageType.instagram	The kind of website the mention was found.	metric
pageType.linkedin	pageType.linkedin		metric
pageType.news	pageType.news	The kind of website the mention was found.	metric
pageType.podcast	pageType.podcast		metric
pageType.reddit	pageType.reddit		metric
pageType.review	pageType.review	The kind of website the mention was found.	metric
pageType.threads	pageType.threads		metric
pageType.tiktok	pageType.tiktok		metric
pageType.tumblr	pageType.tumblr		metric
pageType.twitter	pageType.twitter	The kind of website the mention was found.	metric
pageType.video	pageType.video	The kind of website the mention was found.	metric
pageTypeName	pageTypeName		dimension
pagesPerVisit	pagesPerVisit	Pages Per Visit is a metric pertaining to the traffic for the site that the mention originated from. It is the average number of pages viewed by people visiting the website. This is equivalent to the Avg. Pages metric shown in the front end of the Brandwatch Analytics platform.	metric
parentBlogName	parentBlogName		dimension
parentCategories	Parent Category		dimension
parentPostId	parentPostId		dimension
percentFemaleVisitors	percentFemaleVisitors	Percent Female Visitors is a metric pertaining to the traffic for the site that the mention originated from. It is the percentage of that site’s visitors that are female.	metric
percentMaleVisitors	percentMaleVisitors	Percent Male Visitors is a metric pertaining to the traffic for the site that the mention originated from. It is the percentage of that site’s visitors that are male.	metric
professions	professions		dimension
pubType	pubType		dimension
publisherSubType	publisherSubType		dimension
queries	Query		dimension
queries.0.id	queries.0.id	Query id.	metric
queries.0.name	queries.0.name	Query name.	dimension
queryGroups	Query Group		dimension
queryId	queryId		metric
queryName	queryName	Query Name is the name of the query that the mention originated from in Brandwatch.	dimension
rating	rating		dimension
rawMetadata	rawMetadata		dimension
reachEstimate	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.	metric
redditScore	redditScore		dimension
region	region		dimension
regionCode	regionCode		dimension
replyTo	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.	dimension
resourceId	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.	dimension
resourceType	resourceType	Deprecated.	dimension
retweetOf	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.	dimension
retweets	retweets	The number of retweets.	metric
rootBlogName	rootBlogName		dimension
rootPostId	rootPostId		dimension
sentiment	Sentiment	Sentiment is the tone of the mention: positive negative or neutral.	dimension
sentiment.negative	sentiment.negative	Negative tone of the mention.	metric
sentiment.neutral	sentiment.neutral	Neutral tone of the mention.	metric
sentiment.positive	sentiment.positive	Positive tone of the mention.	metric
shortUrls	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.	dimension
snippet	snippet	Snippet is a snippet of the mention text that best matches the query.	dimension
starred	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.	dimension
state	state		dimension
stateCode	stateCode	State Code is the shortcode for the state from which the mention originated.	dimension
status	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.	dimension
subtype	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.	dimension
threadAuthor	threadAuthor	Thread Author is the name of the author of the original mention in the thread.	dimension
threadCreated	threadCreated	Thread Created is the date when the original mention in the thread was posted.	dimension
threadEntryType	threadEntryType	Thread Entry Type is the type of mention (post reply share) for mentions in a thread.	dimension
threadId	threadId	Thread Id is the unique identifier of the thread (as provided by Twitter or Facebook).	metric
threadURL	threadURL	Thread URL is the URL of the full thread which this mention appears in.	dimension
threadsReplies	threadsReplies		dimension
threadsReposts	threadsReposts		dimension
threadsShares	threadsShares		dimension
tiktokComments	tiktokComments		metric
tiktokLikes	tiktokLikes		metric
tiktokShares	tiktokShares		metric
time	time		dimension
title	title	Title is the title of the mention, as determined by Brandwatch.	dimension
topsites	topsites	Shows on what websites the brand has the most mentions.	dimension
trackedLinkClicks	trackedLinkClicks	Deprecated.	metric
trackedLinks	trackedLinks	Deprecated.	dimension
tweets	tweets		metric
twitterAuthorId	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.	dimension
twitterFollowers	Twitter Followers	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.	metric
twitterFollowing	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.	metric
twitterLikeCount	twitterLikeCount		dimension
twitterPostCount	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.	metric
twitterReplyCount	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.	metric
twitterRetweets	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.	metric
twitterRole	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.	dimension
twitterVerified	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.	dimension
unifiedSourceName	unifiedSourceName		dimension
updated	updated	Updated is the date when the mention was last modified.	dimension
url	url	URL is the URL of the mention.	dimension
volume	Mention Volume	The number of Mentions the topic appears in.	metric
weblogTitle	weblogTitle		dimension
website	website		dimension
weeks	Week		dimension
wordCount	wordCount	Deprecated.	dimension