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
This field 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
This field represents the Brandwatch priority assigned to a mention, indicating its importance or urgency.
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
This field describes 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
This field represents the current workflow status of a mention, used for tracking and reporting purposes within Brandwatch.
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
This field records the date and time when the mention was initially added to the Brandwatch query, either through regular crawling or a backfill process.
assignment Dimension
This field indicates the Brandwatch user (by email address) to whom the mention has been assigned for review or action as part of the workflow.
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).
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
This field provides an array of details for each category applied to the mention, including the category's ID, name, and information about its parent category.
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
This field specifies the nature of the interaction, when the mention is a reply to a Facebook or Instagram comment, a repost (retweet), or a reply to or quote of an X (formerly Twitter) post.
entityInfo Dimension
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.
expandedUrls Dimension
This field contains a list of the full, unshortened URLs that appear within the mention.
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
This field provides the full name of the author who created the mention.
guid Dimension
This field represents a globally unique identifier for the mention. It likely corresponds to the 'id' field in the Brandwatch API, which is a unique identifier assigned to each 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
This boolean field indicates whether the mention originated from a blog source.
pageType.bluesky Metric
This boolean field indicates whether the mention originated from a Bluesky social media source.
pageType.facebook Metric
This boolean field indicates whether the mention originated from a Facebook source.
pageType.forum Metric
This boolean field indicates whether the mention originated from a forum source.
pageType.instagram Metric
This boolean field indicates whether the mention originated from an Instagram source.
pageType.linkedin Metric
This boolean field indicates whether the mention originated from a LinkedIn source.
pageType.news Metric
This boolean field indicates whether the mention originated from a news source.
pageType.podcast Metric
This boolean field indicates whether the mention originated from a podcast source.
pageType.reddit Metric
This boolean field indicates whether the mention originated from a Reddit source.
pageType.review Metric
This boolean field indicates whether the mention originated from a review site source.
pageType.threads Metric
This boolean field indicates whether the mention originated from a Threads social media source.
pageType.tiktok Metric
This boolean field indicates whether the mention originated from a TikTok source.
pageType.tumblr Metric
This boolean field indicates whether the mention originated from a Tumblr source.
pageType.twitter Metric
This boolean field indicates whether the mention originated from an X (formerly Twitter) source.
pageType.{NUM} Metric
The generic pageType field represents the type of online source where a mention originated, such as a blog, social media platform, or forum. Specific sub-fields like pageType.blog provide a boolean indication for a particular page type.
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
This field provides a list of shortened URLs present in the mention, particularly common in platforms like X (formerly Twitter).
snippet Dimension
This field contains a short excerpt of the mention's 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
This field is part of the Brandwatch workflow, indicating whether a mention has been marked as important or for a specific purpose.
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
This field provides the URL to the complete conversation 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.