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 TypeaccountTypeDimension
Indicates the type of account ('individual' or 'organisational') for a social media author, primarily for Twitter (X) mentions.
AuthorsMetric
Represents the number of unique authors contributing to a set of mentions. This can be used as a metric in aggregations.
CategorycategoriesDimension
User-defined labels used to group mentions, often with hierarchical subcategories.
End DateDimension
The end date and time for the period during which mentions are retrieved.
Facebook CommentsfacebookCommentsMetric
The number of comments a piece of content has received on Facebook.
Facebook LikesfacebookLikesMetric
The number of likes a piece of content has received on Facebook.
Facebook SharesfacebookSharesMetric
The number of times a piece of content has been shared on Facebook.
Project IDMetric
The unique identifier for a Brandwatch project from which data is collected.
Project NameDimension
The user-defined name of the Brandwatch project.
QueryDimension
A keyword-based search utilizing Boolean operators to scan for matching results across select social networks and publicly accessible open websites.
Query Group IDMetric
A unique identifier for a group of related queries within the Brandwatch platform.
Query IDMetric
A unique identifier for a specific Brandwatch query.
Start DateDimension
The start date and time for the period during which mentions are retrieved.
TagtagsDimension
Represents a custom label that users can apply to mentions for categorization or organization within Brandwatch.
Twitter FollowerstwitterFollowersMetric
The number of followers an author has on Twitter.
accountTypeDimension
The type of account (e.g., individual, organizational) of the author, primarily for social media platforms like X (formerly Twitter).
addedDimension
The date and time when the mention or item was first recorded in the system.
assignmentDimension
Details about the user or team to whom a mention or task has been assigned for action or review.
authorDimension
The name or identifier of the author or creator of the social media post or online content.
authorVerifiedTypeDimension
The category of verification held by the X (formerly Twitter) author, such as 'blue', 'business', or 'government'.
avatarUrlDimension
The URL of the author's profile picture or avatar.
blogNameDimension
The name of the Tumblr page.
blueskyAuthorIdDimension
The unique identifier for the author on the Bluesky social platform.
blueskyFollowersDimension
The number of followers an author has on Bluesky.
blueskyFollowingDimension
The number of users the Bluesky author is following, specific to mentions originating from Bluesky.
blueskyLikesDimension
The number of likes a post has received on Bluesky.
blueskyPostsDimension
The total number of posts made by the Bluesky author, specific to mentions originating from Bluesky.
blueskyQuotesDimension
The total number of times a Bluesky post has been quoted or reposted with commentary.
blueskyRepliesDimension
The total number of replies received by a Bluesky post.
blueskyRepostsDimension
The total number of times a Bluesky post has been reposted (reshared as is).
canEditWorkflowDimension
Indicates if a user has permissions to edit workflows related to mentions or tasks.
categoriesDimension
A list of user-defined labels with a hierarchical structure that can be applied to mentions for advanced filtering and data segmentation.
categoryDetailsDimension
Provides additional information about the categories (e.g., topic, theme) applied to a mention for organization and analysis.
cityDimension
The city from which the content originated or is geographically associated with the author.
cityCodeDimension
The geographical code representing the city from which the content originated.
classificationsDimension
A list of classifications or tags applied to the content, which can include both automated topic detection and custom user-defined categories.
commentsMetric
The total number of comments received on a piece of content.
contentSourceDimension
The programmatic identifier for the type of platform or origin from which the content was ingested.
contentSourceNameDimension
A human-readable name for the source of the content (e.g., "Blogs", "YouTube", "Facebook", "X", "Review", "News").
continentDimension
The continent from which the content originated or is geographically associated with the author.
continentCodeDimension
The geographical code representing the continent from which the content originated.
copyrightDimension
Copyright information specifically for LexisNexis mentions.
countryDimension
The country from which the content originated or is geographically associated with the author.
countryCodeDimension
The geographical code representing the country from which the content originated.
customDimension
Contains a list of custom-defined properties for mentions uploaded through the Data Upload API.
dailyVisitorsMetric
The number of unique users visiting the website of origin in a day. This metric is derived internally by Brandwatch's data science team.
dateDimension
The date when the content was published or detected.
displayUrlsDimension
A list of URLs intended for display, often a shortened or user-friendly version of the original URL.
domainDimension
The domain name of the website where the content was published.
engagementTypeDimension
The type of interaction or engagement associated with a mention (e.g., comment, retweet, like).
entityInfoDimension
This field contains an array of details about entities (AI terms) identified within the mention text, including an entity ID, confidence score, and a link to its WikiData entry.
expandedUrlsDimension
The full, unshortened versions of any URLs found within the mention's content.
facebookAuthorIdDimension
The unique identifier for the author on Facebook.
facebookRoleDimension
The role of the Facebook user who authored the post ('owner' or 'audience').
facebookSubtypeDimension
The specific media type for Facebook mentions, equivalent to the Media Type shown in the Brandwatch Analytics platform UI.
fullnameDimension
The full name of the author or creator of the content associated with the mention.
genderDimension
The inferred gender of the author of the content.
guidDimension
A globally unique identifier for the specific mention.
idMetric
A unique identifier assigned to various Brandwatch objects, such as mentions, projects, queries, or categories.
imageInfoDimension
Contains details about images associated with the mention, such as URLs or metadata.
impactMetric
A metric indicating the overall influence or significance of the content or author.
impressionsMetric
The number of times the content or mention was potentially viewed or exposed to an audience.
insightsHashtagDimension
Twitter hashtag insights providing data on popular hashtags.
insightsMentionedDimension
An array of user handles identified within Twitter (X) and Instagram mentions.
instagramCommentCountMetric
The number of comments an Instagram post has received.
instagramFollowerCountMetric
The number of followers an Instagram author has.
instagramFollowingCountMetric
The number of accounts an Instagram author is following.
instagramInteractionsCountMetric
The total number of interactions (likes, comments, etc.) an Instagram post has received.
instagramLikeCountMetric
The number of likes an Instagram post has received.
instagramPostCountMetric
The total number of posts an Instagram author has made.
interestDimension
An array of interests mentioned in the X (formerly Twitter) bio of the individual author.
itemReviewDimension
The star review rating (1-5) for review mentions.
languageDimension
The language in which the content is written, detected and standardized by Brandwatch.
lastAssignmentDateDimension
The date and time when the mention or an associated task was last assigned to a user or team.
latitudeDimension
The latitude of a geo-tagged Twitter (X) post.
likesMetric
The number of likes a social media post has received.
linkedinCommentsMetric
The number of comments a piece of content has received on LinkedIn.
linkedinEngagementMetric
The total engagement (likes, comments, shares, video views) a piece of content has received on LinkedIn.
linkedinImpressionsMetric
The estimated number of times a piece of content has been viewed on LinkedIn.
linkedinLikesMetric
The number of likes a piece of content has received on LinkedIn.
linkedinSharesMetric
The number of times a piece of content has been shared on LinkedIn.
linkedinSponsoredDimension
A boolean indicator of whether a LinkedIn post is a sponsored advertisement.
linkedinVideoViewsMetric
The number of video views a piece of content has received on LinkedIn.
locationNameDimension
The name of the location for geo-tagged Instagram mentions.
longitudeDimension
The longitude of a geo-tagged Twitter (X) post.
matchPositionsDimension
Indicates the character or word positions within the mention's content where the query terms were found.
mediaFilterDimension
A filter applied to mentions based on the presence of specific media types (e.g., images, videos).
mediaTypeDimension
The specific media type of the content, such as "link", "photo", "status", or "video", primarily for Facebook mentions.
mediaUrlsDimension
URLs pointing to any multimedia content (e.g., videos, audio) included in the mention.
monthlyVisitorsMetric
The estimated number of unique visitors a website receives per month.
nameDimension
The name of an object, such as a category, project, or query.
originalUrlDimension
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.
pageTypeDimension
The specific type of page or content source, such as 'news' or 'forum'.
pageType.blogMetric
Indicates if the content originated from a blog platform.
pageType.blueskyMetric
Indicates if the content originated from the Bluesky social platform.
pageType.facebookMetric
Indicates if the content originated from Facebook.
pageType.forumMetric
Indicates if the content originated from an online forum.
pageType.instagramMetric
Indicates if the content originated from Instagram.
pageType.linkedinMetric
Indicates if the content originated from LinkedIn.
pageType.newsMetric
Indicates if the content originated from a news website.
pageType.podcastMetric
Indicates if the content originated from a podcast.
pageType.redditMetric
Indicates if the content originated from Reddit.
pageType.reviewMetric
Indicates if the content originated from a review site.
pageType.threadsMetric
Indicates if the content originated from the Threads social platform.
pageType.tiktokMetric
Indicates if the content originated from TikTok.
pageType.tumblrMetric
Indicates if the content originated from Tumblr.
pageType.twitterMetric
Indicates if the content originated from X (formerly Twitter).
pageType.{NUM}Metric
Identifies the type of platform or source where the content originated, such as a blog, social media platform, or news site. The '{NUM}' is a placeholder for specific page type identifiers.
pageTypeNameDimension
The human-readable name corresponding to the pageType classification.
parentBlogNameDimension
The name of the parent page on Tumblr, used to track content reblogged from a specific Tumblr page.
parentPostIdDimension
The unique ID of the parent post on Tumblr, used to track reblogs of a specific post.
professionsDimension
An array of professions mentioned in the X (formerly Twitter) bio of the individual author.
pubTypeDimension
The name of the publisher of the content source or the user-defined name of the custom content source.
publisherSubTypeDimension
A more specific subtype defined by the publisher, providing additional detail about the content type.
queries.{NUM}.idMetric
The unique identifier for a specific query within a collection of queries.
queries.{NUM}.nameDimension
The name of a specific query within a collection of queries.
queries.{NUM}.volumeMetric
The volume of mentions or data associated with a specific query.
queryIdDimension
A unique identifier for a specific Brandwatch query.
queryNameDimension
The name of the Brandwatch query that retrieved the content.
ratingDimension
The star rating (1-5) provided for review mentions.
rawMetadataDimension
A free-form text string containing custom metadata, available only in user-uploaded custom content sources.
reachEstimateMetric
The estimated potential reach of the mentions, often used as an aggregate value in charts.
redditScoreDimension
The score of a Reddit post, reflecting its popularity or upvote count.
regionDimension
The region or state from which the content originated or is geographically associated with the author.
regionCodeDimension
The geographical code representing the region or state from which the content originated.
replyToDimension
Information about the original content or author to which this mention is a direct reply.
resourceIdDimension
A unique identifier assigned to the mention when it is indexed in the Brandwatch database, used for API referencing.
retweetOfDimension
The URL of the original tweet that this post is a retweet of.
retweetsMetric
The total number of times the content has been reposted or retweeted, specifically for Twitter (X) mentions.
rootBlogNameDimension
The name of the original or primary blog in a series of linked blog posts.
rootPostIdDimension
The unique identifier of the original or first post in a threaded conversation or content chain.
sentimentDimension
The emotional tone of the mention's content, typically classified as positive, negative, or neutral.
sentiment.negativeMetric
The count or percentage of mentions classified with a negative emotional tone.
sentiment.neutralMetric
The count or percentage of mentions classified with a neutral emotional tone.
sentiment.positiveMetric
The count or percentage of mentions classified with a positive emotional tone.
sharesMetric
The total number of times a piece of content has been shared across social media platforms.
shortUrlsDimension
Any shortened URLs (e.g., bit.ly, t.co) present in the mention's content.
snippetDimension
A short excerpt or summary of the mention's content.
socialSharesMetric
The total number of times content has been shared on social media, encompassing various platforms.
starredDimension
This field is part of the Brandwatch workflow, indicating whether a mention has been marked as important or for a specific purpose.
statusDimension
The current processing status of the mention or its associated tasks within the platform.
subtypeDimension
A publisher-defined subtype, providing additional detail about the content type. For example, 'IMAGE' for Instagram.
tagsDimension
A list of user-defined tags applied to individual mentions or groups of mentions for categorization or organization.
threadAuthorDimension
The name of the author who initiated the original post in a conversational thread.
threadCreatedDimension
The date and time when the original post in a conversational thread was created.
threadEntryTypeDimension
The type of entry within a discussion thread (e.g., original post, reply).
threadIdDimension
The unique identifier of the thread, as provided by X (formerly Twitter) or Facebook.
threadURLDimension
The URL to the full conversation thread or discussion where the mention originated.
threadsRepliesDimension
The total number of replies within the thread of a social media post, specific to platforms like X (formerly Twitter) or Bluesky.
threadsRepostsDimension
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.
threadsSharesDimension
The total number of times a Threads post has been shared.
tiktokCommentsDimension
The number of comments a TikTok video has received.
tiktokLikesMetric
The number of likes a TikTok video has received.
tiktokSharesDimension
The number of times a TikTok video has been shared.
titleDimension
The title of the content, such as a news article headline, blog post title, or subject of a support ticket.
tweetsMetric
The total number of original tweets by an author or related to a topic within Twitter (now X) insights.
twitterAuthorIdDimension
The unique identifier of the X (formerly Twitter) author.
twitterFollowersMetric
The number of followers an author has on X (formerly Twitter).
twitterFollowingMetric
The number of accounts an author is following on Twitter.
twitterLikeCountDimension
The total number of likes received on a Twitter post.
twitterPostCountMetric
The total number of posts made by the Twitter author.
twitterReplyCountMetric
The total number of replies received by a Twitter post.
twitterRetweetsMetric
The total number of times a Twitter post has been retweeted.
twitterRoleDimension
The role of the Twitter user who authored the post, such as 'owner' or 'audience'.
twitterVerifiedDimension
A boolean indicator if the Twitter author's account is verified.
unifiedSourceNameDimension
A human-readable name identifying the aggregated source of the content (e.g., 'Blogs', 'YouTube', 'Facebook', 'News').
updatedDimension
The date and time when the mention or its associated data was last modified or updated in the system.
urlDimension
The primary URL where the content was published.
volumeMetric
The total number of mentions, often used as an aggregate metric in charts and reports.
weblogTitleDimension
The name or identifier of the specific author on a forum or weblog.