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
Category	categories	User-defined labels used to group mentions, often with hierarchical subcategories.	dimension
Checked	checked	Indicates whether a mention has been reviewed or marked as checked within the Brandwatch workflow functionality.	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 (‘male’, ‘female’, ‘unknown’) of an author. This is a platform-specific metric, often originating from X (formerly Twitter).	dimension
Impressions	impressions	The number of times content has been displayed to users, available as a metric in aggregated reports.	metric
Priority	priority	Represents the priority level assigned to a mention within the Brandwatch workflow, such as ‘high’, ‘medium’, or ‘low’.	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 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 emotional tone of a mention, categorized as ‘positive’, ‘negative’, or ‘neutral’ by Brandwatch’s sentiment analysis. This can be automatically assigned or manually edited.	dimension
Start Date	Start Date	The start date and time for the period during which mentions are retrieved.	dimension
Status	status	Represents the current status of a mention within the Brandwatch workflow, typically ‘open’, ‘pending’, or ‘closed’.	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
added	added	The date when the mention was added to the Brandwatch query, either by regular crawling or a backfill.	dimension
author	author	The nickname, username, or full name of the person who posted a mention. The specific name format depends on the site where it was found.	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 blog where the mention originated.	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
categoryDetails	categoryDetails	A complex object containing details about the categories assigned to a mention, including ‘id’, ‘name’, ‘parentId’, and ‘parentName’ for hierarchical classification.	dimension
city	city	The name of the city from which the mention originated.	dimension
cityCode	cityCode	The shortcode for the city from which the mention originated (e.g., ‘bos1’).	dimension
classifications	classifications	A complex object or array that provides detailed classifications for the mention, helping to categorize content beyond simple tags.	dimension
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 shortcode for the continent from which the mention originated.	dimension
copyright	copyright	Copyright information associated with a mention, typically for mentions originating from sources like Lexis Nexis.	dimension
country	country	The name of the country from which the mention originated.	dimension
countryCode	countryCode	The shortcode for the country from which the mention originated (e.g., ‘us’).	dimension
date	date	The date when the content was published or detected.	dimension
displayUrls	displayUrls	Shortened URLs that appear within the mention’s content, primarily for social media mentions like those from X (formerly Twitter).	dimension
domain	domain	The domain name of the website where the content was published.	dimension
engagementType	engagementType	The type of engagement related to the mention, such as likes, shares, or comments.	dimension
entityInfo	entityInfo	Provides detailed information about entities (e.g., people, organizations, places) identified within the mention.	dimension
expandedUrls	expandedUrls	The original, full URLs before any shortening was applied, providing the complete link from the mention.	dimension
facebookAuthorId	facebookAuthorId	The unique identifier for the author on Facebook.	metric
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.	metric
imageInfo	imageInfo	An array of details regarding images found within the mention, such as URL, MD5 hash, dimensions, dominant color, and identified logos, objects, actions, or 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 the mention, specific to platforms like X (formerly Twitter) and Instagram.	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 item being reviewed in a review mention.	dimension
language	language	The detected language of the mention’s content, often represented by a language code (e.g., ‘en’ for English). Implied by API filters.	dimension
lastAssignmentDate	lastAssignmentDate	The date when the mention was last assigned to a user for review or action within the Brandwatch workflow.	dimension
latitude	latitude	The geographical latitude coordinate associated with the mention’s origin.	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
logoImages	logoImages	An array containing information or URLs related to logos identified within a mention or associated content.	dimension
longitude	longitude	The geographical longitude coordinate associated with the mention’s origin.	metric
matchPositions	matchPositions	An array of details about words from the mention that matched the query string, including start position, length, and matching text.	dimension
mediaFilter	mediaFilter	A filter applied to specify particular types of media to include or exclude from results.	dimension
mediaType	mediaType	The general type of media source from which the mention originated (e.g., ‘news’, ‘blog’, ‘social’, ‘forum’).	dimension
mediaUrls	mediaUrls	A list of URLs pointing to any media content (e.g., images, videos) embedded in or associated with the mention.	dimension
monthlyVisitors	monthlyVisitors	The estimated number of unique visitors a website receives per month.	metric
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
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
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
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.	dimension
region	region	The name of the geographical region from which the mention originated, providing a broader location context than city or country.	dimension
regionCode	regionCode	The shortcode for the geographical region from which the mention originated.	dimension
replyTo	replyTo	For social media mentions, this field indicates the identifier of the mention to which the current mention is a reply.	dimension
resourceId	resourceId	A unique identifier for the mention within Brandwatch, essential for referencing and editing specific mentions.	dimension
resourceType	resourceType	A deprecated field that previously described the type of resource.	dimension
retweetOf	retweetOf	The URL of the original tweet that this post is a retweet of.	dimension
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
shortUrls	shortUrls	A list of shortened URLs found within the mention’s content. Similar to ‘displayUrls’.	dimension
snippet	snippet	A brief excerpt or summary of the mention’s content.	dimension
starred	starred	Indicates whether a mention has been marked as ‘starred’ within the Brandwatch platform, typically for flagging important content.	dimension
subtype	subtype	A more specific classification of the mention type, e.g., ‘COMMENT’, ‘REPLY’, ‘RETWEET’, or ‘QUOTE’.	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 original thread or conversation to which the mention belongs, commonly found in forums or social media discussions.	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 article, blog post, or other content from which the mention originated.	dimension
twitterAuthorId	twitterAuthorId	The unique identifier of the X (formerly Twitter) author.	dimension
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.	dimension
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
updated	updated	The date and time when the mention’s data was last updated in the system.	dimension
url	url	The primary URL where the content was published.	dimension
weblogTitle	weblogTitle	The title of the weblog or blog where the mention was published. This is synonymous with ‘blogName’.	dimension