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
A boolean flag indicating 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 gender of the author of a mention, typically 'male', 'female', or 'unknown'. This is a Twitter-specific metric.
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
Part of the Brandwatch workflow functionality, indicating the importance level of a mention (e.g., 'high', 'medium', '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
The detected sentiment of a mention, typically categorized as 'positive', 'negative', or 'neutral'. It can also be edited.
Start Date Dimension
The start date and time for the period during which mentions are retrieved.
Status status Dimension
A user-assigned level indicating the current state of a mention within the Brandwatch workflow.
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 added to the Brandwatch query, either through regular crawling or a backfill process.
assignment Dimension
Information related to the assignment of the mention within a workflow, potentially indicating who it's assigned to or its assignment status.
author Dimension
The name of the author who created the mention. This field can be edited for certain page types.
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
An array of objects providing detailed information about the categories assigned to a mention, including their ID, name, parent ID, and parent name.
city Dimension
The name of the city where the mention originated.
cityCode Dimension
The shortcode identifier for the city where the mention originated (e.g., 'bos1').
classifications Dimension
A list of classifications associated with the mention, which can include various categories like emotions (e.g., 'emotions:Anger').
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 name of the continent where the mention originated.
continentCode Dimension
The shortcode identifier for the continent where the mention originated.
copyright Dimension
Copyright information specifically for LexisNexis mentions.
country Dimension
The name of the country where the mention originated.
countryCode Dimension
The shortcode identifier for the country where the mention originated (e.g., 'us').
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
The type of engagement associated with the mention, such as likes, shares, or comments.
entityInfo Dimension
An array containing details about entities (AI-powered keywords or concepts) identified within the mention's text.
expandedUrls Dimension
A list of full, unshortened URLs found within the mention content.
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 full name of the author who posted the mention.
guid Dimension
A globally unique identifier for the mention.
id Metric
A unique identifier assigned to various Brandwatch objects, such as mentions, projects, queries, or categories.
imageInfo Dimension
An array containing detailed analysis of images within a mention, including URL, MD5 hash, dimensions, dominant color, and detected 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 detected language of the mention's content.
lastAssignmentDate Dimension
The date when the mention was last assigned to a Brandwatch user as part of the workflow functionality.
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 providing details about the words within the mention that matched the query string, including their start position, length, and the matching text.
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 media files (e.g., images, videos) embedded in 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 that the mention originated from a blog.
pageType.bluesky Metric
Indicates that the mention originated from Bluesky.
pageType.facebook Metric
Indicates that the mention originated from Facebook.
pageType.forum Metric
Indicates that the mention originated from a forum.
pageType.instagram Metric
Indicates that the mention originated from Instagram.
pageType.linkedin Metric
Indicates that the mention originated from LinkedIn.
pageType.news Metric
Indicates that the mention originated from a news source.
pageType.podcast Metric
Indicates that the mention originated from a podcast.
pageType.reddit Metric
Indicates that the mention originated from Reddit.
pageType.review Metric
Indicates that the mention originated from a review site.
pageType.threads Metric
Indicates that the mention originated from Threads.
pageType.tiktok Metric
Indicates that the mention originated from TikTok.
pageType.tumblr Metric
Indicates that the mention originated from Tumblr.
pageType.twitter Metric
Indicates that the mention originated from Twitter (now X).
pageType.{NUM} Metric
A placeholder representing specific page types or platforms where a mention originated, such as a blog, forum, or social media platform.
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 name of the region (e.g., state, province) where the mention originated.
regionCode Dimension
The shortcode identifier for the region where the mention originated.
replyTo Dimension
The URL of the original post that this mention is a reply to, typically for social media platforms like X (Twitter).
resourceId Dimension
A unique identifier for the specific mention, used for referencing and editing.
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
A list of shortened URLs present in the mention's content.
snippet Dimension
A short excerpt or summary of the mention's full text.
socialShares Dimension
The total number of times content has been shared on social media, encompassing various platforms.
starred Dimension
A boolean flag indicating whether a mention has been marked as 'starred' or 'bookmarked' by a user.
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 full conversation thread in which this mention appears.
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 article, blog post, or content associated with the mention.
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 was last modified.
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.