Brandwatch

Account Type

string

Account Type is the type of account ('individual' or 'organisational') that a Twitter author has. This is a Twitter specific metric and will be null for mentions not originating from Twitter.

dimension

Author

string

Author is the nick name, user name or full name of the person who posted a mention. The name depends on the site on which it has been found.

dimension

Author City

string

Author City is the city with which the tweet's author is associated. This is a Twitter specific metric and will be null for mentions not originating from Twitter.

dimension

Author Continent

string

Author Continent is the continent with which the tweet's author is associated. This is a Twitter specific metric and will be null for mentions not originating from Twitter.

dimension

Author Country

string

Author Country is the country with which the tweet's author is associated. This is a Twitter specific metric and will be null for mentions not originating from Twitter.

dimension

Author County

string

Author County is the county with which the tweet's author is associated. This is a Twitter specific metric and will be null for mentions not originating from Twitter.

dimension

Author State

string

Author State is the state with which the tweet's author is associated. This is a Twitter specific metric and will be null for mentions not originating from Twitter.

dimension

Blog Comments

long

Blog Comments is the number of comments a blog has. This metric is specific to mentions from a blog page type and will be 0 for mentions originating from any other source.

metric

Category

string

A user-defined label that has one level of hierarchy associated with it which can be applied as metadata to a Mention. A single Category will be comprised of one or multiple Subcategories. A Category must have at least one Subcategory.

dimension

Checked

string

Checked is part of the Brandwatch workflow functionality and can be used to indicate that a mention has been reviewed.

dimension

City

string

City is the name of the city from which the mention originated.

dimension

Continent

string

The continent from which the mention originated.

dimension

Country

string

Country is the country from which the mention originated.

dimension

Day

date

Chart by the days that mentions were from.

dimension

Day of the Week

string

Chart by the day of week that mentions were from.

dimension

Domains

string

Domain is the domain name of the website from which the mention originated.

dimension

End Date

date

The end of the date range that contains the Mentions.

dimension

Facebook Audience Comments

long

The number of Audiences' comments on facebook.

metric

Facebook Audience Posts

long

The number of Audiences' posts on facebook.

metric

Facebook Comments

long

The number of comments on facebook.

metric

Facebook Likes

long

The number of likes on facebook.

metric

Facebook Owner Comments

long

The number of Owners' comments on facebook.

metric

Facebook Owner Posts

long

The number of Owners' posts on facebook.

metric

Facebook Posts

long

Facebook Posts is the number of messages in the forum thread at the time the mention was found.

metric

Facebook Shares

long

Facebook Shares is number of times that a Facebook mention has been shared. This is a Facebook specific metric and will be 0 for mentions not originating from Facebook.

metric

Forum Posts

long

Forum Posts is the number of messages in the forum thread at the time the mention was found. This metric is specific to mentions from a forum page type and will be 0 for mentions originating from any other source.

metric

Forum Views

long

Form Views is the number of times the forum thread has been viewed by people at the time the mention was found. This metric is specific to mentions from a forum page type and will be 0 for mentions originating from any other source.

metric

Gender

string

Gender is the gender ('male' 'female' 'unknown') of an author. This is a Twitter specific metric and will be 'unknown' for mentions not originating from Twitter.

dimension

Hour

string

Chart by the hours that mentions were from.

dimension

Hour of Day

string

Chart by the hour of day that mentions were from.

dimension

Impressions

long

Impressions is the potential number of viewers of a tweet. This is calculated by taking the sum of the followers of the account that originally posted a tweet and the followers of any accounts that retweeted it. This is a Twitter specific metric and will be 0 for mentions not originating from Twitter.

metric

Influence

long

Influence is the Kred Influence score of the author of this mention at the time the mention was found (1-1000). This is a metric provided by an external data provider Kred. This is a Twitter specific metric and will be 0 for mentions not originating from Twitter.

metric

Language

string

Language is the shortcode for the language in which the mention was written.

dimension

Mention Volume

long

Mention volume of the brand.

metric

Mixed Category

string

Includes both promotion and prevention focused message frames.

dimension

Month

string

Chart by the months that mentions were from.

dimension

Net Sentiment

float

Aggregate by net sentiment score (-5 to +5).

metric

Outreach

long

Outreach is the Kred Outreach score of the author of this mention at the time the mention was found (1-12). This is a metric provided by an external data provider Kred. This is a Twitter specific metric and will be 0 for mentions not originating from Twitter.

metric

Page Type

string

Page Type describes the kind of website the mention was found on e.g. a blog or forum.

dimension

Parent Category

string

Name of the parent category.

dimension

Priority

string

Priority is part of the Brandwatch workflow functionality and can be used to indicate the priority of a mention (e.g. 'high' 'medium' 'low'). If the mention has never been marked with a priority this field will be null.

dimension

Profession

string

Profession is an array of the professions that are mentioned in the Twitter bio of the individual (not organization) that authored the mention. This is a Twitter specific metric and will be an empty list for mentions not originating from Twitter.

dimension

Project ID

string

An ID of the Project Name.

dimension

Project Name

string

A silo within a Brandwatch user’s account to contain all their searches, settings and configurations.

dimension

Query

string

A keyword-based search utilizing Boolean operators to scan for matching results across select social networks and publicly accessible open websites.

dimension

Query Group

string

Chart by the query groups that mentions are stored in. Use when passing through specific Query Group IDs.

dimension

Query ID

string

Query Id is the unique identifier for the query that the mention originated from in Brandwatch.

dimension

Reach

long

Reach is the sum of the Influence of the author and all of the authors who have retweeted. This is a Twitter specific metric and will be 0 for mentions not originating from Twitter.

metric

Start Date

date

The beginning of the date range that contains the Mentions.

dimension

State

string

State is the name of the state from which the mention originated.

dimension

Tag

string

A simple user-defined label that can be applied as metadata to a Mention.

dimension

Users who have been Assignee

string

Users who have been Assignee.

dimension

Week

string

Chart by the weeks that mentions were from.

dimension

added

string

Added is the date when the mention was added to the Brandwatch query (either by regular crawling or a backfill).

dimension

assignment

string

Assignment is part of the Brandwatch workflow functionality and allows you to send a mention to another Brandwatch user to check.

dimension

authorCityCode

string

Author City Code is the shortcode for the city with which a tweet's author is associated. This is a Twitter specific metric and will be null for mentions not originating from Twitter.

dimension

authorCityName

string

The name of Author City.

dimension

authorContinentCode

string

Author Continent Code is the shortcode for the continent with which the tweet's author is associated. This is a Twitter specific metric and will be null for mentions not originating from Twitter.

dimension

authorContinentName

string

The name of Author Continent.

dimension

authorCountryCode

string

Author Country Code is the shortcode for the country with which the tweet's author is associated. This is a Twitter specific metric and will be null for mentions not originating from Twitter.

dimension

authorCountryName

string

The name of Author Country.

dimension

authorCountyCode

string

Author County Code is the shortcode for the county with which the tweet's author is associated. This is a Twitter specific metric and will be null for mentions not originating from Twitter.

dimension

authorCountyName

string

The name of Author County.

dimension

authorGender

string

Gender of an author.

dimension

authorInterest.0

string

The level of Author Interest.

dimension

authorInterest.1

string

The level of Author Interest.

dimension

authorInterest.2

string

The level of Author Interest.

dimension

authorInterest.3

string

The level of Author Interest.

dimension

authorInterest.4

string

The level of Author Interest.

dimension

authorInterest.5

string

The level of Author Interest.

dimension

authorLocation

string

Author Location is the location with which the tweet's author is associated. This is displayed in shortcode in the following format: continent country state county city. This is a Twitter specific metric and will be null for mentions not originating from Twitter.

dimension

authorName

string

Name of the author.

dimension

authorProfessions.0.jobTitle

string

Job Title as a profession that is mentioned in the Twitter bio of the author.

dimension

authorProfessions.0.profession

string

Profession as a profession that is mentioned in the Twitter bio of the author.

dimension

authorProfessions.1.jobTitle

string

Job Title as a profession that is mentioned in the Twitter bio of the author.

dimension

authorProfessions.1.profession

string

Profession as a profession that is mentioned in the Twitter bio of the author.

dimension

authorProfessions.2.jobTitle

string

Job Title as a profession that is mentioned in the Twitter bio of the author.

dimension

authorProfessions.2.profession

string

Profession as a profession that is mentioned in the Twitter bio of the author.

dimension

authorReach

long

Author Reach is the sum of the Influence of the author.

metric

authorStateCode

string

Author State Code is the shortcode for the state with which the tweet's author is associated. This is a Twitter specific metric, and will be null for mentions not originating from Twitter.

dimension

authorStateName

string

The name of Author State.

dimension

authorVolume

long

The number of Author the topic appears on.

metric

avatarUrl

string

Avatar URL is the URL of the author's Twitter avatar. This is only available for mentions originating from Facebook Instagram or Twitter.

dimension

averageDurationOfVisit

long

Average Duration of Visit is a metric pertaining to the traffic for the site that the mention originated from. It is the average number of minutes spent on the website by visitors.

metric

averageVisits

float

Average Visits is a metric pertaining to the traffic for the site that the mention originated from. It is calculated by taking the total number of visits to the site and dividing it by the total number of visitors to the site.

metric

backlinks

long

Backlinks is the number of pages across the web that link to this website. This is a metric provided by an external data provider.

metric

burst

long

The rate that the topic has emerged over time.

metric

categories

long

Categories is an array of IDs of any categories that are applied to the mention.

metric

categoryDetails

string

Category Details is an array of details (ID of the category, name of the category ID of the parent category name of the parent category) for each of the categories that is applied to the mention.

dimension

cityCode

string

City Code is the shortcode for the city from which the mention originated.

dimension

classifications

string

The process in which ideas and objects are recognized, differentiated, and understood.

dimension

continentCode

string

Continent Code is the shortcode for the continent from which the mention originated.

dimension

continet

string

Continent is the name of the continent from which the mention originated.

dimension

countryCode

string

Country Code is the shortcode for the country from which the mention originated.

dimension

countryName

string

Country is the name of the country from which the mention originated.

dimension

date

date

Date is the date when the mention was posted.

dimension

displayUrls

date

Display URLs are the shortened links that appear in a mention. This is a Twitter specific metric and will be null for mentions not originating from Twitter.

dimension

engagement

long

Deprecated.

metric

expandedUrls

string

Display URLs are the full URLs for any shortened links that appear in a mention. This is a Twitter specific metric and will be null for mentions not originating from Twitter.

dimension

facebookAuthorId

string

Facebook Author Id is the unique id of the Facebook author. This is a Facebook specific metric and will be null for mentions not originating from Facebook.

dimension

facebookComments

long

Facebook Comments is the number of comments on a Facebook mention. This is a Facebook specific metric and will be 0 for mentions not originating from Facebook.

metric

facebookLikes

long

Facebook Likes is the number of Likes on a Facebook mention. This is a Facebook specific metric and will be 0 for mentions not originating from Facebook.

metric

facebookRole

string

Facebook Role is the role of the Facebook user who authored the post ('owner' or 'audience'). A Facebook role of 'owner' would indicate that the author is posting on their own page whereas a Facebook role of 'audience' would indicate that an author is posting on someone else's Facebook page. This is a Facebook specific metric and will be null for mentions not originating from Facebook.

dimension

facebookSubtype

string

Facebook Subtype is the type of media shared in a Facebook mention ('link' 'photo' 'status' or 'video'). This is equivalent to the Facebook Media Type shown in the front end of the Brandwatch Analytics platform. This is a Facebook specific metric and will be null for mentions not originating from Facebook.

dimension

fullText

string

The full text.

dimension

fullname

string

Full Name is the full name of the author who posted the mention.

dimension

id

string

Id is a unique identifier given to each mention by Brandwatch.

dimension

impact

long

Impact is a Brandwatch metric to measure the potential impact of an author, site or mention. It's a logarithmic scale between 0-100 normalised for your data to help you find what's most interesting. The impact score takes into account how much potential a mention has to be seen as well as how many times a mention has been viewed shared or retweeted.

metric

impactAmplification

long

Internally used to calculate the Impact Score.

metric

impactReach

long

Internally used to calculate the Reach Score.

metric

impactRelevancy

long

The number of impact relevancy.

metric

importanceAmplification

long

The number of importance Amplification.

metric

importanceReach

long

The number of importance Reach.

metric

insightsHashtag

string

Insights Hashtags is an array of hashtags identified within the mention. This is a Twitter and Instagram specific metric and will be empty for mentions not originating from Twitter or Instagram.

dimension

insightsMentioned

string

Insights Mentioned is an array of user handles identified within the mention. This is a Twitter and Instagram specific metric and will be empty for mentions not originating from Twitter or Instagram.

dimension

instagramCommentCount

long

Instagram Comment Count is the number of comments on an Instagram mention. This is an Instagram specific metric and will be 0 for mentions not originating from Instagram.

metric

instagramFollowerCount

long

Instagram Followers Count is the number of followers of the Instagram mention's author. This is an Instagram specific metric and will be 0 for mentions not originating from Instagram.

metric

instagramFollowingCount

long

Instagram Following Count is the number of users that the author of an Instagram mention is following. This is an Instagram specific metric and will be 0 for mentions not originating from Instagram.

metric

instagramInteractionsCount

long

Instagram Interactions Count is the sum of likes and posts on an Instagram mention. This is an Instagram specific metric and will be 0 for mentions not originating from Instagram.

metric

instagramLikeCount

long

Instagram Like Count is the number of likes on an Instagram mention. This is an Instagram specific metric and will be 0 for mentions not originating from Instagram.

metric

instagramPostCount

long

Instagram Post Count is the number of posts on an Instagram mention. This is an Instagram specific metric and will be 0 for mentions not originating from Instagram.

metric

interest

string

Interest is an array of the interests that are mentioned in the Twitter bio of the individual (not organization) that authored the mention. This is a Twitter specific metric and will be an empty list for mentions not originating from Twitter.

dimension

label

string

A sequence of characters that identifies a location within source code.

dimension

lastAssignmentDate

datetime

Last Assignment Date is part of the Brandwatch workflow functionality and shows the date when the mention was last assigned to a Brandwatch user. If the mention has never been assigned to a user this field will be null.

dimension

latitude

float

Latitude of a geo-tagged Tweet. This is a Twitter specific metric and will be 0 for mentions not originating from Twitter as well as mentions that have not been goe-tagged.

metric

locationName

string

Location name of a geo-tagged Instagram mentions. This is an Instagram specific metric and will be null for mentions not originating from Instagram as well as mentions that have not been geo-tagged.

dimension

longitude

float

Longitude of a geo-tagged Tweet. This is a Twitter specific metric and will be 0 for mentions not originating from Twitter as well as mentions that have not been geo-tagged.

metric

matchPositions

string

Match Positions is an array of details about words from the mention that matched the query string.

dimension

mediaFilter

string

Media Filter is the image filter that was used on an Instagram mention. This is an Instagram specific metric, and will be null for mentions not originating from Instagram.

dimension

mediaUrls

string

Media URLs is a list of the URLs associated with any media (e.g. photo video) attached to the mention.

dimension

monthlyVisitors

long

Monthly Visitors is a metric pertaining to the traffic for the site that the mention originated from. It is the total number of unique visitors who have been to the website that month.

metric

mozRank

float

mozRank measures site credibility similar to Google's PageRank. It's on a scale of 1-10 where 10 is most credible. This is a metric provided by an external data provider Moz.

metric

name

string

The name.

dimension

noteIds

string

Note Ids is part of the Brandwatch workflow functionality and shows an array of the ids of any notes that have been added to the mention.

dimension

originalUrl

string

Original URL is the URL of the tweet. If the tweet is a retweet or a reply it will be the URL of the original being retweeted or replied to. This is a Twitter specific metric and will be null for mentions not originating from Twitter.

dimension

pageType.blog

string

The kind of website the mention was found.

dimension

pageType.facebook

string

The kind of website the mention was found.

dimension

pageType.forum

string

The kind of website the mention was found.

dimension

pageType.general

string

The kind of website the mention was found.

dimension

pageType.image

string

The kind of website the mention was found.

dimension

pageType.instagram

string

The kind of website the mention was found.

dimension

pageType.licensed

string

The kind of website the mention was found.

dimension

pageType.microblog

string

The kind of website the mention was found.

dimension

pageType.news

string

The kind of website the mention was found.

dimension

pageType.print

string

The kind of website the mention was found.

dimension

pageType.review

string

The kind of website the mention was found.

dimension

pageType.twitter

string

The kind of website the mention was found.

dimension

pageType.video

string

The kind of website the mention was found.

dimension

pagesPerVisit

long

Pages Per Visit is a metric pertaining to the traffic for the site that the mention originated from. It is the average number of pages viewed by people visiting the website. This is equivalent to the Avg. Pages metric shown in the front end of the Brandwatch Analytics platform.

metric

percentFemaleVisitors

float

Percent Female Visitors is a metric pertaining to the traffic for the site that the mention originated from. It is the percentage of that site's visitors that are female.

metric

percentMaleVisitors

float

Percent Male Visitors is a metric pertaining to the traffic for the site that the mention originated from. It is the percentage of that site's visitors that are male.

metric

queries.0.id

string

Query id.

dimension

queries.0.name

string

Query name.

dimension

queries.0.volume

string

Query volume.

dimension

queryName

string

Query Name is the name of the query that the mention originated from in Brandwatch.

dimension

reachEstimate

long

Reach Estimate is a score created by Brandwatch to estimate how many individuals may have seen a piece of content. It's available for multiple data sources and enables the user to compare reach of content from different platforms and track development over time.

metric

replyTo

string

Reply To is the URL of the original tweet that this tweet is in reply to. This is a Twitter specific metric and will be null for mentions not originating from Twitter and for tweets that are not a reply to any earlier tweet.

dimension

resourceId

string

Resource Id is the unique identifier assigned to a mention when it is indexed in our database. This is for reference when using the Brandwatch API.

dimension

resourceType

string

Deprecated.

dimension

retweetOf

string

Retweet Of is the URL of the original tweet that this tweet is a retweet of. This is a Twitter specific metric and will be null for mentions not originating from Twitter and for tweets that are not a retweet of any earlier tweet.

dimension

retweets

long

The number of retweets.

metric

sentiment

string

Sentiment is the tone of the mention: positive negative or neutral.

dimension

sentiment.negative

float

Negative tone of the mention.

metric

sentiment.neutral

float

Neutral tone of the mention.

metric

sentiment.positive

float

Positive tone of the mention.

metric

sentimentScore

float

Avarage sentiment score.

metric

shortUrls

string

Short URLs are the shortened links that appear in a mention. This is a Twitter specific metric and will be null for mentions not originating from Twitter.

dimension

snippet

string

Snippet is a snippet of the mention text that best matches the query.

dimension

starred

string

Starred is part of the Brandwatch workflow functionality and can be used to indicate that a mention is interesting or to mark it for any other purpose you choose.

dimension

stateCode

string

State Code is the shortcode for the state from which the mention originated.

dimension

status

string

Status is part of the Brandwatch workflow functionality and can be used to indicate the status of a mention (e.g. 'open' 'pending' 'closed'). If the mention has never been marked with a status this field will be null.

dimension

subtype

string

Subtype is the same as the Media Type in the UI and indicates the type of media included within a Facebook Twitter or Instagram mention.

dimension

tags

string

Tags is an array of the names of any tags that are applied to the mention.

dimension

threadAuthor

string

Thread Author is the name of the author of the original mention in the thread.

dimension

threadCreated

datetime

Thread Created is the date when the original mention in the thread was posted.

dimension

threadEntryType

string

Thread Entry Type is the type of mention (post reply share) for mentions in a thread.

dimension

threadId

string

Thread Id is the unique identifier of the thread (as provided by Twitter or Facebook).

dimension

threadURL

string

Thread URL is the URL of the full thread which this mention appears in.

dimension

title

string

Title is the title of the mention, as determined by Brandwatch.

dimension

topauthors

string

Shows who writes about the brand the most.

dimension

topsites

string

Shows on what websites the brand has the most mentions.

dimension

toptweeters

string

Shows who tweets about the brand the most.

dimension

trackedLinkClicks

long

Deprecated.

metric

trackedLinks

long

Deprecated.

metric

twitterAtMentions

long

The number of twitter at mention.

metric

twitterAuthorId

string

Twitter Author Id is the unique id of the Twitter author. This is a Twitter specific metric and will be null for mentions not originating from Twitter.

dimension

twitterAvatar

string

The URL of the author's Twitter avatar.

dimension

twitterFollowers

long

Twitter Followers is the number of followers of the Twitter mention's author. This is a Twitter specific metric and will be 0 for mentions not originating from Twitter.

metric

twitterFollowing

long

Twitter Following is the number of users that the author of a Twitter mention is following. This is a Twitter specific metric and will be 0 for mentions not originating from Twitter.

metric

twitterInfluence

long

The number of twitter infuence.

metric

twitterOutreach

long

The number of twitter Outreach.

metric

twitterPageTitle

string

The title of the twitter page.

dimension

twitterPostCount

long

Twitter Post Count is the total number of tweets that the author of the mention has posted. This is a Twitter specific metric and will be 0 for mentions not originating from Twitter.

metric

twitterReplyCount

long

Twitter Reply Count is the total number of replies to a tweet. This is a Twitter specific metric and will be 0 for mentions not originating from Twitter.

metric

twitterRetweets

long

Twitter Retweet Count is the total number of times that a tweet has been retweeted. This is a Twitter specific metric and will be 0 for mentions not originating from Twitter.

metric

twitterRole

string

Twitter Role is the role of the Twitter user who authored the post ('owner' or 'audience'). A Twitter role of 'owner' would indicate that the author is posting on their own channel whereas a Twitter role of 'audience' would indicate that an author is posting on someone else's channel. This is a Twitter specific metric and will be null for mentions not originating from Twitter.

dimension

twitterTweets

long

The number of the tweets.

metric

twitterVerified

string

Twitter Verified indicates if the author of the mention is verified on Twitter (These are large accounts usually celebrities). This is a Twitter specific metric and will be false for all mentions not originating from Twitter.

dimension

type

string

The type of the tweets.

dimension

updated

date

Updated is the date when the mention was last modified.

dimension

url

string

URL is the URL of the mention.

dimension

volume

long

The number of Mentions the topic appears in.

metric

wordCount

long

Deprecated.

metric