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.
Account Type accountType Dimension
Indicates the type of account ('individual' or 'organisational') for a social media author, primarily for Twitter (X) mentions.
Authors Metric
Represents the number of unique authors contributing to a set of mentions. This can be used as a metric in aggregations.
Category categories Dimension
User-defined labels used to group mentions, often with hierarchical subcategories.
Checked checked Dimension
Indicates whether a mention has been reviewed as part of the Brandwatch workflow.
End Date Dimension
The end date and time for the period during which mentions are retrieved.
Facebook Comments facebookComments Metric
The number of comments a piece of content has received on Facebook.
Facebook Likes facebookLikes Metric
The number of likes a piece of content has received on Facebook.
Facebook Shares facebookShares Metric
The number of times a piece of content has been shared on Facebook.
Gender gender Dimension
The inferred or provided gender of the author or creator of the content.
Impressions impressions Metric
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.
Priority priority Dimension
Specifies the priority level assigned to a mention within the Brandwatch workflow, such as 'high', 'medium', or 'low'.
Project ID Metric
The unique identifier for a Brandwatch project from which data is collected.
Project Name Dimension
The user-defined name of the Brandwatch project.
Query Dimension
A keyword-based search utilizing Boolean operators to scan for matching results across select social networks and publicly accessible open websites.
Query ID Metric
A unique identifier for a specific Brandwatch query.
Sentiment sentiment Dimension
Indicates the emotional tone of the mention, categorized as 'positive', 'negative', or 'neutral'.
Start Date Dimension
The start date and time for the period during which mentions are retrieved.
Status status Dimension
Defines the current status of a mention within the Brandwatch workflow, such as 'open', 'pending', or 'closed'.
Tag tags Dimension
Represents a custom label that users can apply to mentions for categorization or organization within Brandwatch.
Twitter Followers twitterFollowers Metric
The number of followers an author has on Twitter.
accountType Dimension
The type of account (e.g., individual, organizational) of the author, primarily for social media platforms like X (formerly Twitter).
added Dimension
The date and time when the mention was initially added to the Brandwatch query.
assignment Dimension
Indicates if a mention has been assigned to a Brandwatch user for review as part of the workflow, often showing the assignee's email address.
author Dimension
The name or identifier of the author or creator of the social media post or online content.
authorVerifiedType Dimension
The category of verification held by the X (formerly Twitter) author, such as 'blue', 'business', or 'government'.
avatarUrl Dimension
The URL of the author's profile picture or avatar.
blogName Dimension
The name of the Tumblr page.
blueskyAuthorId Dimension
The unique identifier for the author on the Bluesky social platform.
blueskyFollowers Dimension
The number of followers an author has on Bluesky.
blueskyFollowing Dimension
The number of users the Bluesky author is following, specific to mentions originating from Bluesky.
blueskyLikes Dimension
The number of likes a post has received on Bluesky.
blueskyPosts Dimension
The total number of posts made by the Bluesky author, specific to mentions originating from Bluesky.
blueskyQuotes Dimension
The total number of times a Bluesky post has been quoted or reposted with commentary.
blueskyReplies Dimension
The total number of replies received by a Bluesky post.
blueskyReposts Dimension
The total number of times a Bluesky post has been reposted (reshared as is).
canEditMetadata Dimension
Indicates whether the metadata for a mention can be edited through the API, including sentiment, categories, tags, workflow status, and location.
canEditWorkflow Dimension
Indicates whether the workflow status of a mention can be modified.
categories Dimension
A list of user-defined labels with a hierarchical structure that can be applied to mentions for advanced filtering and data segmentation.
categoryDetails Dimension
Provides detailed information for each category applied to a mention, including its ID, name, parent ID, and parent name.
city Dimension
The city from which the content originated or is geographically associated with the author.
cityCode Dimension
The geographical code representing the city from which the content originated.
classifications Dimension
A list of classifications or tags applied to the content, which can include both automated topic detection and custom user-defined categories.
comments Metric
The total number of comments received on a piece of content.
contentSource Dimension
The programmatic identifier for the type of platform or origin from which the content was ingested.
contentSourceName Dimension
A human-readable name for the source of the content (e.g., "Blogs", "YouTube", "Facebook", "X", "Review", "News").
continent Dimension
The continent from which the content originated or is geographically associated with the author.
continentCode Dimension
The geographical code representing the continent from which the content originated.
copyright Dimension
Copyright information specifically for LexisNexis mentions.
country Dimension
The country from which the content originated or is geographically associated with the author.
countryCode Dimension
The geographical code representing the country from which the content originated.
custom Dimension
Contains a list of custom-defined properties for mentions uploaded through the Data Upload API.
dailyVisitors Metric
The number of unique users visiting the website of origin in a day. This metric is derived internally by Brandwatch's data science team.
date Dimension
The date when the content was published or detected.
displayUrls Dimension
A list of URLs intended for display, often a shortened or user-friendly version of the original URL.
domain Dimension
The domain name of the website where the content was published.
engagementType Dimension
Specifies the type of engagement for the mention, such as 'COMMENT', 'REPLY', 'RETWEET', or 'QUOTE'.
entityInfo Dimension
Contains an array of details about entities (AI terms) identified within the mention text, including their WikiData ID, confidence score, and WikiData URL.
expandedUrls Dimension
A list of the full, expanded URLs for any shortened links present in the mention, particularly relevant for X (Twitter) mentions.
facebookAuthorId Dimension
The unique identifier for the author on Facebook.
facebookRole Dimension
The role of the Facebook user who authored the post ('owner' or 'audience').
facebookSubtype Dimension
The specific media type for Facebook mentions, equivalent to the Media Type shown in the Brandwatch Analytics platform UI.
fullname Dimension
The complete name of the author who created the mention.
guid Dimension
A content source-specific unique identifier for the mention.
id Metric
A unique identifier assigned to various Brandwatch objects, such as mentions, projects, queries, or categories.
imageInfo Dimension
Provides an array of details resulting from the analysis of images within a mention, including URL, MD5 hash, dimensions, dominant color, and identified logos, objects, actions, and scenes.
impact Metric
A metric indicating the overall influence or significance of the content or author.
insightsHashtag Dimension
Twitter hashtag insights providing data on popular hashtags.
insightsMentioned Dimension
An array of user handles identified within Twitter (X) and Instagram mentions.
instagramCommentCount Metric
The number of comments an Instagram post has received.
instagramFollowerCount Metric
The number of followers an Instagram author has.
instagramFollowingCount Metric
The number of accounts an Instagram author is following.
instagramInteractionsCount Metric
The total number of interactions (likes, comments, etc.) an Instagram post has received.
instagramLikeCount Metric
The number of likes an Instagram post has received.
instagramPostCount Metric
The total number of posts an Instagram author has made.
interest Dimension
An array of interests mentioned in the X (formerly Twitter) bio of the individual author.
itemReview Dimension
The star review rating (1-5) for review mentions.
language Dimension
The language in which the content is written, detected and standardized by Brandwatch.
lastAssignmentDate Dimension
The date and time when the mention was most recently assigned to a user within the Brandwatch workflow.
latitude Metric
The latitude of a geo-tagged Twitter (X) post.
likes Metric
The number of likes a social media post has received.
linkedinComments Metric
The number of comments a piece of content has received on LinkedIn.
linkedinEngagement Metric
The total engagement (likes, comments, shares, video views) a piece of content has received on LinkedIn.
linkedinImpressions Metric
The estimated number of times a piece of content has been viewed on LinkedIn.
linkedinLikes Metric
The number of likes a piece of content has received on LinkedIn.
linkedinShares Metric
The number of times a piece of content has been shared on LinkedIn.
linkedinSponsored Dimension
A boolean indicator of whether a LinkedIn post is a sponsored advertisement.
linkedinVideoViews Metric
The number of video views a piece of content has received on LinkedIn.
locationName Dimension
The name of the location for geo-tagged Instagram mentions.
longitude Metric
The longitude of a geo-tagged Twitter (X) post.
matchPositions Dimension
An array containing details about the parts of the mention text that matched the search query, including start position, length, and the matching text itself.
mediaFilter Dimension
A filter applied to mentions based on the presence of specific media types (e.g., images, videos).
mediaType Dimension
The specific media type of the content, such as "link", "photo", "status", or "video", primarily for Facebook mentions.
mediaUrls Dimension
A list of URLs pointing to any attached media, such as photos or videos, within the mention.
monthlyVisitors Metric
The estimated number of unique visitors a website receives per month.
name Dimension
The name of an object, such as a category, project, or query.
originalUrl Dimension
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.
pageType Dimension
The specific type of page or content source, such as 'news' or 'forum'.
pageType.blog Metric
Indicates if the mention originated from a blog content source. This field is derived from the deprecated 'pageType' field, with 'contentSource' now being the preferred field to identify the origin of the mention.
pageType.bluesky Metric
Indicates if the mention originated from a Bluesky content source. This field is derived from the deprecated 'pageType' field, with 'contentSource' now being the preferred field to identify the origin of the mention.
pageType.facebook Metric
Indicates if the mention originated from a Facebook content source. This field is derived from the deprecated 'pageType' field, with 'contentSource' now being the preferred field to identify the origin of the mention.
pageType.forum Metric
Indicates if the mention originated from a forum content source. This field is derived from the deprecated 'pageType' field, with 'contentSource' now being the preferred field to identify the origin of the mention.
pageType.instagram Metric
Indicates if the mention originated from an Instagram content source. This field is derived from the deprecated 'pageType' field, with 'contentSource' now being the preferred field to identify the origin of the mention.
pageType.linkedin Metric
Indicates if the mention originated from a LinkedIn content source. This field is derived from the deprecated 'pageType' field, with 'contentSource' now being the preferred field to identify the origin of the mention.
pageType.news Metric
Indicates if the mention originated from a news content source. This field is derived from the deprecated 'pageType' field, with 'contentSource' now being the preferred field to identify the origin of the mention.
pageType.podcast Metric
Indicates if the mention originated from a podcast content source. This field is derived from the deprecated 'pageType' field, with 'contentSource' now being the preferred field to identify the origin of the mention.
pageType.reddit Metric
Indicates if the mention originated from a Reddit content source. This field is derived from the deprecated 'pageType' field, with 'contentSource' now being the preferred field to identify the origin of the mention.
pageType.review Metric
Indicates if the mention originated from a review content source. This field is derived from the deprecated 'pageType' field, with 'contentSource' now being the preferred field to identify the origin of the mention.
pageType.threads Metric
Indicates if the mention originated from a Threads content source. This field is derived from the deprecated 'pageType' field, with 'contentSource' now being the preferred field to identify the origin of the mention.
pageType.tiktok Metric
Indicates if the mention originated from a TikTok content source. This field is derived from the deprecated 'pageType' field, with 'contentSource' now being the preferred field to identify the origin of the mention.
pageType.tumblr Metric
Indicates if the mention originated from a Tumblr content source. This field is derived from the deprecated 'pageType' field, with 'contentSource' now being the preferred field to identify the origin of the mention.
pageType.twitter Metric
Indicates if the mention originated from a X (Twitter) content source. This field is derived from the deprecated 'pageType' field, with 'contentSource' now being the preferred field to identify the origin of the mention.
pageType.{NUM} Metric
Represents the type of page or content source from which the mention originated. The specific value '{NUM}' indicates the particular type, such as 'blog', 'facebook', or 'twitter'. This field is deprecated; 'contentSource' should be used instead.
pageTypeName Dimension
The human-readable name corresponding to the pageType classification.
parentBlogName Dimension
The name of the parent page on Tumblr, used to track content reblogged from a specific Tumblr page.
parentPostId Dimension
The unique ID of the parent post on Tumblr, used to track reblogs of a specific post.
professions Dimension
An array of professions mentioned in the X (formerly Twitter) bio of the individual author.
pubType Dimension
The name of the publisher of the content source or the user-defined name of the custom content source.
publisherSubType Dimension
A more specific subtype defined by the publisher, providing additional detail about the content type.
queries.{NUM}.id Metric
The unique identifier for a specific query within a collection of queries.
queries.{NUM}.name Dimension
The name of a specific query within a collection of queries.
queries.{NUM}.volume Metric
The volume of mentions or data associated with a specific query.
queryId Metric
A unique identifier for a specific Brandwatch query.
queryName Dimension
The name of the Brandwatch query that retrieved the content.
rating Dimension
The star rating (1-5) provided for review mentions.
rawMetadata Dimension
A free-form text string containing custom metadata, available only in user-uploaded custom content sources.
reachEstimate Metric
The estimated potential reach of the mentions, often used as an aggregate value in charts.
redditScore Metric
The score of a Reddit post, reflecting its popularity or upvote count.
region Dimension
The region or state from which the content originated or is geographically associated with the author.
regionCode Dimension
The geographical code representing the region or state from which the content originated.
replyTo Dimension
The URL of the original post to which this mention is a reply, primarily for X (Twitter) mentions.
resourceId Dimension
A unique identifier assigned to the mention when it is indexed in the Brandwatch database, used for API referencing.
retweetOf Dimension
The URL of the original tweet that this post is a retweet of.
retweets Metric
The total number of times the content has been reposted or retweeted, specifically for Twitter (X) mentions.
rootBlogName Dimension
The name of the original or primary blog in a series of linked blog posts.
rootPostId Dimension
The unique identifier of the original or first post in a threaded conversation or content chain.
sentiment.negative Metric
The count or percentage of mentions classified with a negative emotional tone.
sentiment.neutral Metric
The count or percentage of mentions classified with a neutral emotional tone.
sentiment.positive Metric
The count or percentage of mentions classified with a positive emotional tone.
shares Metric
The total number of times a piece of content has been shared across social media platforms.
shortUrls Dimension
An array of shortened URLs present in the mention, particularly relevant for X (Twitter) mentions.
snippet Dimension
A brief excerpt of the mention text that is most relevant to the search query.
socialShares Dimension
The total number of times content has been shared on social media, encompassing various platforms.
starred Dimension
A boolean indicator used within the Brandwatch workflow to mark a mention as important or for other custom purposes.
subtype Dimension
A publisher-defined subtype, providing additional detail about the content type. For example, 'IMAGE' for Instagram.
tags Dimension
A list of user-defined tags applied to individual mentions or groups of mentions for categorization or organization.
threadAuthor Dimension
The name of the author who initiated the original post in a conversational thread.
threadCreated Dimension
The date and time when the original post in a conversational thread was created.
threadEntryType Dimension
The type of entry within a discussion thread (e.g., original post, reply).
threadId Metric
The unique identifier of the thread, as provided by X (formerly Twitter) or Facebook.
threadURL Dimension
The URL of the complete discussion thread in which the mention is located.
threadsReplies Dimension
The total number of replies within the thread of a social media post, specific to platforms like X (formerly Twitter) or Bluesky.
threadsReposts Dimension
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.
threadsShares Dimension
The total number of times a Threads post has been shared.
tiktokComments Dimension
The number of comments a TikTok video has received.
tiktokLikes Dimension
The number of likes a TikTok video has received.
tiktokShares Dimension
The number of times a TikTok video has been shared.
title Dimension
The title of the content, such as a news article headline, blog post title, or subject of a support ticket.
tweets Metric
The total number of original tweets by an author or related to a topic within Twitter (now X) insights.
twitterAuthorId Dimension
The unique identifier of the X (formerly Twitter) author.
twitterFollowers Metric
The number of followers an author has on X (formerly Twitter).
twitterFollowing Metric
The number of accounts an author is following on Twitter.
twitterLikeCount Metric
The total number of likes received on a Twitter post.
twitterPostCount Metric
The total number of posts made by the Twitter author.
twitterReplyCount Metric
The total number of replies received by a Twitter post.
twitterRetweets Metric
The total number of times a Twitter post has been retweeted.
twitterRole Dimension
The role of the Twitter user who authored the post, such as 'owner' or 'audience'.
twitterVerified Dimension
A boolean indicator if the Twitter author's account is verified.
unifiedSourceName Dimension
A human-readable name identifying the aggregated source of the content (e.g., 'Blogs', 'YouTube', 'Facebook', 'News').
updated Dimension
The date and time when the mention record was last modified in the Brandwatch system.
url Dimension
The primary URL where the content was published.
volume Metric
The total number of mentions, often used as an aggregate metric in charts and reports.
weblogTitle Dimension
The name or identifier of the specific author on a forum or weblog.