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	Indicates the type of account (‘individual’ or ‘organisational’) for a social media author, primarily for Twitter (X) mentions.	dimension
Authors	Authors	Represents the number of unique authors contributing to a set of mentions. This can be used as a metric in aggregations.	metric
Category	categories	User-defined labels used to group mentions, often with hierarchical subcategories.	dimension
Category ID	Category ID	The unique identifier for a user-defined category.	metric
Checked	checked	Indicates if a mention has been reviewed or interacted with by a user as part of the Brandwatch workflow.	dimension
End Date	End Date	The end date and time for the period during which mentions are retrieved.	dimension
Facebook Comments	facebookComments	The number of comments a piece of content has received on Facebook.	metric
Facebook Likes	facebookLikes	The number of likes a piece of content has received on Facebook.	metric
Facebook Shares	facebookShares	The number of times a piece of content has been shared on Facebook.	metric
Gender	gender	The gender of the author of the mention, specified as ‘male’, ‘female’, or ‘unknown’. This is often a Twitter-specific metric.	dimension
Impressions	impressions	The total number of times a piece of content appears on a user’s screen, indicating visibility. It can also refer to the potential number of viewers of a post.	metric
Mention Volume	Mention Volume	The total number of mentions found for a specific query or time period.	metric
Priority	priority	A user-assigned level indicating the importance of a mention in the Brandwatch workflow.	dimension
Project ID	Project ID	The unique identifier for a Brandwatch project from which data is collected.	metric
Project Name	Project Name	The user-defined name of the Brandwatch project.	dimension
Query	Query	A keyword-based search utilizing Boolean operators to scan for matching results across select social networks and publicly accessible open websites.	dimension
Query Group	Query Group	A user-defined collection of Queries and Channels for the purpose of analyzing the aggregation of all the results returned by that set.	dimension
Query Group ID	Query Group ID	The unique identifier for the Brandwatch query group that contains the mentions.	metric
Query ID	Query ID	A unique identifier for a specific Brandwatch query.	metric
Sentiment	sentiment	The sentiment score or classification (e.g., positive, negative, neutral) detected in the mention’s content.	dimension
Start Date	Start Date	The start date and time for the period during which mentions are retrieved.	dimension
Status	status	A user-assigned level indicating the current state of a mention within the Brandwatch workflow.	dimension
Tag	tags	Represents a custom label that users can apply to mentions for categorization or organization within Brandwatch.	dimension
Twitter Followers	twitterFollowers	The number of followers an author has on Twitter.	metric
accountType	accountType	The type of account (e.g., individual, organizational) of the author, primarily for social media platforms like X (formerly Twitter).	dimension
added	added	The date and time when the mention was added to the Brandwatch query, either through regular crawling or a backfill process.	dimension
assignment	assignment	The date when the mention was assigned to a user for review or action.	dimension
author	author	Information about the author who created the mention, such as their profile or ID.	dimension
authorAccountType	authorAccountType	The type of account (‘individual’ or ‘organisational’) that a social media author has, primarily for X (formerly Twitter) mentions.	dimension
authorGender	authorGender	The gender (‘male’, ‘female’, ‘unknown’) of an author, often available for specific platforms like X (formerly Twitter).	dimension
authorInterest.{NUM}	authorInterest.{NUM}	Represents an interest mentioned in the author’s social media bio, specifically from X (formerly Twitter).	dimension
authorName	authorName	The name of the author of the mention.	dimension
authorVerifiedType	authorVerifiedType	The category of verification held by the X (formerly Twitter) author, such as ‘blue’, ‘business’, or ‘government’.	dimension
avatarUrl	avatarUrl	The URL of the author’s profile picture or avatar.	dimension
blogName	blogName	The name of the Tumblr page.	dimension
blueskyAuthorId	blueskyAuthorId	The unique identifier for the author on the Bluesky social platform.	dimension
blueskyFollowers	blueskyFollowers	The number of followers an author has on Bluesky.	metric
blueskyFollowing	blueskyFollowing	The number of users the Bluesky author is following, specific to mentions originating from Bluesky.	metric
blueskyLikes	blueskyLikes	The number of likes a post has received on Bluesky.	metric
blueskyPosts	blueskyPosts	The total number of posts made by the Bluesky author, specific to mentions originating from Bluesky.	metric
blueskyQuotes	blueskyQuotes	The total number of times a Bluesky post has been quoted or reposted with commentary.	metric
blueskyReplies	blueskyReplies	The total number of replies received by a Bluesky post.	metric
blueskyReposts	blueskyReposts	The total number of times a Bluesky post has been reposted (reshared as is).	metric
canApplyWorkflow	canApplyWorkflow	Indicates if the user or system has permission to apply workflow actions (e.g., assign, check, star, set priority/status) to mentions within the Brandwatch platform.	dimension
canEditMetadata	canEditMetadata	Indicates if the user or system has permission to edit metadata of mentions (e.g., sentiment, categories, tags, location) within the Brandwatch platform.	dimension
canEditWorkflow	canEditWorkflow	Indicates if the user or system has permission to modify workflow settings or states of mentions (e.g., assigning, checking, starring, setting priority or status) within the Brandwatch platform.	dimension
categories	categories	A list of user-defined labels with a hierarchical structure that can be applied to mentions for advanced filtering and data segmentation.	dimension
categoryDetails	categoryDetails	Detailed information about the categories assigned to the mention, which can be custom or predefined.	dimension
city	city	The name of the city from which the mention originated.	dimension
cityCode	cityCode	The short code for the city from which the mention originated.	dimension
classifications	classifications	Detailed information about how the mention has been classified, potentially including custom tags or rules.	dimension
comments	comments	The total number of comments received on a piece of content.	metric
contentSource	contentSource	The programmatic identifier for the type of platform or origin from which the content was ingested.	dimension
contentSourceName	contentSourceName	A human-readable name for the source of the content (e.g., “Blogs”, “YouTube”, “Facebook”, “X”, “Review”, “News”).	dimension
continent	continent	The name of the continent from which the mention originated.	dimension
continentCode	continentCode	The short code for the continent from which the mention originated.	dimension
copyright	copyright	Copyright information specifically for LexisNexis mentions.	dimension
country	country	The name of the country from which the mention originated.	dimension
countryCode	countryCode	The short code for the country from which the mention originated.	dimension
countryName	countryName	The full name of the country from which the mention originated.	dimension
custom	custom	Contains a list of custom-defined properties for mentions uploaded through the Data Upload API.	dimension
dailyVisitors	dailyVisitors	The number of unique users visiting the website of origin in a day. This metric is derived internally by Brandwatch’s data science team.	metric
date	date	The date when the content was published or detected.	dimension
displayUrls	displayUrls	A list of URLs intended for display, often a shortened or user-friendly version of the original URL.	dimension
domain	domain	The domain name of the website where the content was published.	dimension
engagementType	engagementType	The type of user interaction or engagement with the mention, such as likes, shares, or comments.	dimension
entityInfo	entityInfo	An array of details describing entities (AI terms) found in the mention text, including entity ID, confidence (e.g., HIGH, MEDIUM, LOW, VERY_LOW), and URL to external data like WikiData.	dimension
expandedUrls	expandedUrls	The full, original URLs that appear in a mention after any shortening services have been resolved.	dimension
facebookAuthorId	facebookAuthorId	The unique identifier for the author on Facebook.	dimension
facebookRole	facebookRole	The role of the Facebook user who authored the post (‘owner’ or ‘audience’).	dimension
facebookSubtype	facebookSubtype	The specific media type for Facebook mentions, equivalent to the Media Type shown in the Brandwatch Analytics platform UI.	dimension
fullname	fullname	The full name of the author who posted the mention.	dimension
guid	guid	A globally unique identifier for the mention or related entity.	dimension
id	id	A unique identifier assigned to various Brandwatch objects, such as mentions, projects, queries, or categories.	metric
imageInfo	imageInfo	An array of details from the analysis done on images in a mention, including URL, MD5 hash, dimensions (width and height), dominant color, and detected elements (logos, objects, actions, scenes).	dimension
impact	impact	A metric indicating the overall influence or significance of the content or author.	metric
insightsHashtag	insightsHashtag	Twitter hashtag insights providing data on popular hashtags.	dimension
insightsMentioned	insightsMentioned	An array of user handles identified within Twitter (X) and Instagram mentions.	dimension
instagramCommentCount	instagramCommentCount	The number of comments an Instagram post has received.	metric
instagramFollowerCount	instagramFollowerCount	The number of followers an Instagram author has.	metric
instagramFollowingCount	instagramFollowingCount	The number of accounts an Instagram author is following.	metric
instagramInteractionsCount	instagramInteractionsCount	The total number of interactions (likes, comments, etc.) an Instagram post has received.	metric
instagramLikeCount	instagramLikeCount	The number of likes an Instagram post has received.	metric
instagramPostCount	instagramPostCount	The total number of posts an Instagram author has made.	metric
interest	interest	An array of interests mentioned in the X (formerly Twitter) bio of the individual author.	dimension
itemReview	itemReview	The star review rating (1-5) for review mentions.	dimension
language	language	The detected language of the mention’s content, often represented by a language code.	dimension
lastAssignmentDate	lastAssignmentDate	The date and time when the mention was last assigned to a user or team for review or action.	dimension
latitude	latitude	The latitude of a geo-tagged Twitter (X) post.	metric
likes	likes	The number of likes a social media post has received.	metric
linkedinComments	linkedinComments	The number of comments a piece of content has received on LinkedIn.	metric
linkedinEngagement	linkedinEngagement	The total engagement (likes, comments, shares, video views) a piece of content has received on LinkedIn.	metric
linkedinImpressions	linkedinImpressions	The estimated number of times a piece of content has been viewed on LinkedIn.	metric
linkedinLikes	linkedinLikes	The number of likes a piece of content has received on LinkedIn.	metric
linkedinShares	linkedinShares	The number of times a piece of content has been shared on LinkedIn.	metric
linkedinSponsored	linkedinSponsored	A boolean indicator of whether a LinkedIn post is a sponsored advertisement.	dimension
linkedinVideoViews	linkedinVideoViews	The number of video views a piece of content has received on LinkedIn.	metric
locationName	locationName	The name of the location for geo-tagged Instagram mentions.	dimension
longitude	longitude	The longitude of a geo-tagged Twitter (X) post.	metric
matchPositions	matchPositions	An array of objects providing details (start position, length, text) about words from the mention that matched the query string.	dimension
mediaFilter	mediaFilter	A filter applied to mentions based on the presence of specific media types (e.g., images, videos).	dimension
mediaType	mediaType	The specific media type of the content, such as “link”, “photo”, “status”, or “video”, primarily for Facebook mentions.	dimension
mediaUrls	mediaUrls	A list of URLs pointing to media files (e.g., images, videos) embedded in or attached to the mention.	dimension
monthlyVisitors	monthlyVisitors	The estimated number of unique visitors a website receives per month.	metric
name	name	The name of an object, such as a category, project, or query.	dimension
originalUrl	originalUrl	The URL of an original X (formerly Twitter) post. If the post is a repost or a reply, it will be the URL of the original post instead.	dimension
pageType	pageType	The specific type of page or content source, such as ‘news’ or ‘forum’.	dimension
pageType.blog	pageType.blog	Indicates if the mention originated from a blog.	metric
pageType.bluesky	pageType.bluesky	Indicates if the mention originated from the Bluesky social network.	metric
pageType.facebook	pageType.facebook	Indicates if the mention originated from Facebook.	metric
pageType.forum	pageType.forum	Indicates if the mention originated from an online forum.	metric
pageType.instagram	pageType.instagram	Indicates if the mention originated from Instagram.	metric
pageType.linkedin	pageType.linkedin	Indicates if the mention originated from LinkedIn.	metric
pageType.news	pageType.news	Indicates if the mention originated from a news website.	metric
pageType.podcast	pageType.podcast	Indicates if the mention originated from a podcast.	metric
pageType.reddit	pageType.reddit	Indicates if the mention originated from Reddit.	metric
pageType.review	pageType.review	Indicates if the mention originated from a review website.	metric
pageType.threads	pageType.threads	Indicates if the mention originated from Threads.	metric
pageType.tiktok	pageType.tiktok	Indicates if the mention originated from TikTok.	metric
pageType.tumblr	pageType.tumblr	Indicates if the mention originated from Tumblr.	metric
pageType.twitter	pageType.twitter	Indicates if the mention originated from X (formerly Twitter).	metric
pageTypeName	pageTypeName	The human-readable name corresponding to the pageType classification.	dimension
parentBlogName	parentBlogName	The name of the parent page on Tumblr, used to track content reblogged from a specific Tumblr page.	dimension
parentPostId	parentPostId	The unique ID of the parent post on Tumblr, used to track reblogs of a specific post.	dimension
professions	professions	An array of professions mentioned in the X (formerly Twitter) bio of the individual author.	dimension
pubType	pubType	The name of the publisher of the content source or the user-defined name of the custom content source.	dimension
publisherSubType	publisherSubType	A more specific subtype defined by the publisher, providing additional detail about the content type.	dimension
queries.{NUM}.id	queries.{NUM}.id	The unique identifier for a specific query within a collection of queries.	metric
queries.{NUM}.name	queries.{NUM}.name	The name of a specific query within a collection of queries.	dimension
queries.{NUM}.volume	queries.{NUM}.volume	The volume of mentions or data associated with a specific query.	metric
queryId	queryId	A unique identifier for a specific Brandwatch query.	metric
queryName	queryName	The name of the Brandwatch query that retrieved the content.	dimension
rating	rating	The star rating (1-5) provided for review mentions.	dimension
rawMetadata	rawMetadata	A free-form text string containing custom metadata, available only in user-uploaded custom content sources.	dimension
reachEstimate	reachEstimate	The estimated potential reach of the mentions, often used as an aggregate value in charts.	metric
redditScore	redditScore	The score of a Reddit post, reflecting its popularity or upvote count.	metric
region	region	The name of the geographical region from which the mention originated.	dimension
regionCode	regionCode	The short code for the geographical region from which the mention originated.	dimension
replyTo	replyTo	The URL of the original post that this mention is in reply to. This is a Twitter-specific field.	dimension
resourceId	resourceId	The unique identifier assigned to a mention when it is indexed in the Brandwatch database.	dimension
retweetOf	retweetOf	The URL of the original tweet that this post is a retweet of.	dimension
retweets	retweets	The total number of times the content has been reposted or retweeted, specifically for Twitter (X) mentions.	metric
rootBlogName	rootBlogName	The name of the original or primary blog in a series of linked blog posts.	dimension
rootPostId	rootPostId	The unique identifier of the original or first post in a threaded conversation or content chain.	dimension
sentiment.negative	sentiment.negative	The count or percentage of mentions classified with a negative emotional tone.	metric
sentiment.neutral	sentiment.neutral	The count or percentage of mentions classified with a neutral emotional tone.	metric
sentiment.positive	sentiment.positive	The count or percentage of mentions classified with a positive emotional tone.	metric
shares	shares	The total number of times a piece of content has been shared across social media platforms.	metric
shortUrls	shortUrls	Shortened URLs present within the mention’s content, typically found in social media posts.	dimension
snippet	snippet	A short excerpt or summary of the mention text that best matches the query.	dimension
socialShares	socialShares	The total number of times content has been shared on social media, encompassing various platforms.	metric
starred	starred	Indicates if a mention has been marked as significant or important by a user within the workflow.	dimension
subtype	subtype	A publisher-defined subtype, providing additional detail about the content type. For example, ‘IMAGE’ for Instagram.	dimension
tags	tags	A list of user-defined tags applied to individual mentions or groups of mentions for categorization or organization.	dimension
threadAuthor	threadAuthor	The name of the author who initiated the original post in a conversational thread.	dimension
threadCreated	threadCreated	The date and time when the original post in a conversational thread was created.	dimension
threadEntryType	threadEntryType	The type of entry within a discussion thread (e.g., original post, reply).	dimension
threadId	threadId	The unique identifier of the thread, as provided by X (formerly Twitter) or Facebook.	metric
threadURL	threadURL	The URL of the conversation thread to which the mention belongs.	dimension
threadsReplies	threadsReplies	The total number of replies within the thread of a social media post, specific to platforms like X (formerly Twitter) or Bluesky.	dimension
threadsReposts	threadsReposts	The total number of times a social media post has been reposted or reshared within its thread, specific to platforms like X (formerly Twitter) or Bluesky.	dimension
threadsShares	threadsShares	The total number of times the conversation thread associated with the mention has been shared across platforms.	dimension
tiktokComments	tiktokComments	The number of comments a TikTok video has received.	metric
tiktokLikes	tiktokLikes	The number of likes a TikTok video has received.	metric
tiktokShares	tiktokShares	The number of times a TikTok video has been shared.	metric
title	title	The title of the mention, as determined by Brandwatch.	dimension
topsites	topsites	Refers to aggregated data about top websites from which mentions originate, often used for performance analysis.	dimension
topsites ID	topsites ID	A unique identifier for a top site where mentions originate, used in aggregated reports.	dimension
tweets	tweets	The total number of original tweets by an author or related to a topic within Twitter (now X) insights.	metric
twitterAuthorId	twitterAuthorId	The unique identifier of the X (formerly Twitter) author.	dimension
twitterFollowers	twitterFollowers	The number of followers an author has on X (formerly Twitter).	metric
twitterFollowing	twitterFollowing	The number of accounts an author is following on Twitter.	metric
twitterLikeCount	twitterLikeCount	The total number of likes received on a Twitter post.	metric
twitterPostCount	twitterPostCount	The total number of posts made by the Twitter author.	metric
twitterReplyCount	twitterReplyCount	The total number of replies received by a Twitter post.	metric
twitterRetweets	twitterRetweets	The total number of times a Twitter post has been retweeted.	metric
twitterRole	twitterRole	The role of the Twitter user who authored the post, such as ‘owner’ or ‘audience’.	dimension
twitterVerified	twitterVerified	A boolean indicator if the Twitter author’s account is verified.	dimension
unifiedSourceName	unifiedSourceName	A human-readable name identifying the aggregated source of the content (e.g., ‘Blogs’, ‘YouTube’, ‘Facebook’, ‘News’).	dimension
updated	updated	The date and time when the mention was last modified.	dimension
url	url	The primary URL where the content was published.	dimension
volume	volume	The total number of mentions, often used as an aggregate metric in charts and reports.	metric
weblogTitle	weblogTitle	The name or identifier of the specific author on a forum or weblog.	dimension