BuzzSumo: Most-used fields

BuzzSumo: Most-used fields#

The table below gives information about most-used fields that you can import from BuzzSumo. 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.

API name

Adverity UI name

Description

Use in Adverity

alert_date

alert_date

The date when an alert was triggered or recorded.

dimension

alert_id

alert_id

The unique identifier for an alert configured in BuzzSumo.

dimension

alexa_rank

alexa_rank

The Alexa Rank of a domain, indicating its popularity relative to other websites.

metric

angry_count

angry_count

The total number of “angry” reactions to a piece of content on platforms like Facebook.

metric

angry_count_int

angry_count_int

The integer count of “angry” reactions.

metric

angry_count_percentage

angry_count_percentage

The percentage of total reactions that are “angry” reactions.

metric

api_request_count

api_request_count

The count of API requests made within a specific period or against a particular API key.

metric

article_amplifiers

article_amplifiers

This field identifies the key individuals or platforms (influencers) that have shared, promoted, or significantly engaged with a specific article, contributing to its broader reach and visibility.

dimension

article_id

article_id

The unique identifier for a specific article.

dimension

article_type

article_type

The categorization or type of content, such as a blog post, news article, or video.

dimension

article_types

article_types

A list of categorizations or types associated with the content.

dimension

author_details

author_details

Detailed information about the author of the content.

dimension

author_image

author_image

The URL or path to the author’s profile image.

dimension

author_name

author_name

The name of the author who created the content.

dimension

author_name_truncated

author_name_truncated

A truncated version of the author’s name.

dimension

auto_added

auto_added

Indicates whether a specific item or entry, such as an article or mention, was automatically added to a collection or alert, typically by the BuzzSumo system.

dimension

avg_retweets

avg_retweets

The average number of retweets for an influencer’s content. This can be used to sort influencer search results.

metric

created_at

created_at

The timestamp when the record or entity was created.

dimension

display_bio

display_bio

A short biography or descriptive text intended for public display, often for an influencer.

dimension

display_title

display_title

The title of an article or content item, formatted for display.

dimension

domain_authority

domain_authority

An SEO metric representing the predictive ranking strength of a domain in search engine results.

metric

domain_name

domain_name

The domain name where the content is published.

dimension

ecommerce

ecommerce

A metric that provides data related to e-commerce content, which might include performance indicators or categorizations for articles and mentions relevant to online sales and retail.

metric

estimated_num_followers

estimated_num_followers

The estimated number of followers for an influencer or social media profile.

dimension

estimated_num_followers_int

estimated_num_followers_int

The integer value of the estimated number of followers.

metric

estimated_num_following

estimated_num_following

The estimated number of users that a social media profile is following.

metric

evergreen_score

evergreen_score

A score indicating the long-term relevance and sustained performance of a piece of content.

metric

evergreen_score_int

evergreen_score_int

The integer value of the evergreen score.

metric

evergreen_score_raw

evergreen_score_raw

The raw, unscaled value of the evergreen score.

metric

facebook_comments

facebook_comments

The total number of comments received on Facebook for the content.

metric

facebook_comments_int

facebook_comments_int

The integer count of Facebook comments.

metric

facebook_likes

facebook_likes

The total number of “likes” received on Facebook for the content.

metric

facebook_likes_int

facebook_likes_int

The integer count of Facebook likes.

metric

facebook_shares

facebook_shares

The total number of shares received on Facebook for the content.

metric

facebook_shares_int

facebook_shares_int

The integer count of Facebook shares.

metric

following

following

Represents the number of followers an influencer has, or indicates if a specific topic or influencer is being followed.

metric

general_article

general_article

Indicates if the content item is classified as a general article, distinguishing it from other content formats.

metric

haha_count

haha_count

The total number of “haha” reactions to a piece of content on platforms like Facebook.

metric

haha_count_int

haha_count_int

The integer count of “haha” reactions.

metric

haha_count_percentage

haha_count_percentage

The percentage of total reactions that are “haha” reactions.

metric

how_to_article

how_to_article

Specifies if the content is a ‘how-to’ guide or tutorial.

metric

id

id

A unique identifier for the record or entity (e.g., article, alert, project, influencer).

dimension

image

image

The URL or path to the main image associated with the content.

dimension

influencer_id

influencer_id

The unique identifier for a specific influencer.

dimension

infographic

infographic

Denotes if the content item is an infographic.

metric

instagram_authority

instagram_authority

A metric representing the influence or authority of an Instagram profile.

metric

instagram_username

instagram_username

The Instagram username associated with an influencer profile.

dimension

interview

interview

Identifies the content as an interview.

metric

is_journalist

is_journalist

A boolean indicator if the identified person is a journalist.

dimension

last_api_request_at

last_api_request_at

The timestamp of the last API request made for a particular data stream or resource.

dimension

last_fetched_twitter_sharers_at

last_fetched_twitter_sharers_at

The timestamp indicating when the list of Twitter sharers for an article was last retrieved.

dimension

last_share_count_update_fetch_at

last_share_count_update_fetch_at

The timestamp indicating when the share count data was last fetched from social platforms.

dimension

last_share_count_update_request_at

last_share_count_update_request_at

The timestamp indicating when a request was last made to update the share count data.

dimension

linked

linked

This field represents the number of external links (backlinks) pointing to a piece of content, indicating its authority and visibility across the web.

metric

linkedin_shares

linkedin_shares

The total number of shares received on LinkedIn for the content.

dimension

linking_domains

linking_domains

A list of domains that are linking to the content.

metric

list

list

This field represents a collection or array of data items, such as a list of articles, influencers, or mentions retrieved from the BuzzSumo API.

metric

list_id

list_id

The unique identifier for a list or collection in BuzzSumo.

dimension

list_post

list_post

Indicates if the content is structured as a list post or listicle.

dimension

location

location

The geographical location associated with an influencer or content.

dimension

love_count

love_count

The total number of “love” reactions to a piece of content on platforms like Facebook.

metric

love_count_int

love_count_int

The integer count of “love” reactions.

metric

love_count_percentage

love_count_percentage

The percentage of total reactions that are “love” reactions.

metric

meta_keywords

meta_keywords

Keywords extracted from the meta tags of the content.

dimension

name

name

The name of an entity, such as a project, alert, or influencer.

dimension

newsletter

newsletter

Specifies if the content is a newsletter.

metric

num_articles_published

num_articles_published

The total number of articles published by a specific author or from a particular domain.

metric

num_influential_mentions

num_influential_mentions

The total number of mentions from influential sources.

dimension

num_linking_domains

num_linking_domains

The total number of unique domains that are linking to the content.

metric

num_mentions

num_mentions

The total number of times a topic, brand, or keyword has been mentioned online.

metric

num_words

num_words

The total word count of the article or content.

metric

og_url

og_url

The Open Graph (OG) URL for the content, used by social media platforms to identify the canonical URL and associated metadata.

dimension

original_display_bio

original_display_bio

The original or unedited biography for display, often for an influencer.

dimension

page_authority

page_authority

An SEO metric representing the predictive ranking strength of a specific web page in search engine results.

metric

pagerank

pagerank

Reflects the authority or importance of a web page or domain, indicating its ranking strength within search results. While ‘Pagerank’ is a specific algorithm, this field represents a generalized measure of content or domain authority, similar to ‘domain_authority’ which is a metric available in BuzzSumo.

metric

person_type

person_type

The classification or type of person, such as an influencer, journalist, or blogger.

dimension

pinterest_shares

pinterest_shares

The total number of shares received on Pinterest for the content.

metric

pinterest_shares_int

pinterest_shares_int

The integer count of Pinterest shares.

metric

podcast

podcast

Denotes if the content item is a podcast.

metric

presentation

presentation

Specifies if the content is a presentation or slide deck.

metric

press_release

press_release

Identifies the content as a press release.

metric

pretty_url

pretty_url

A clean, user-friendly, or canonical URL for the content item.

dimension

publications

publications

A list of publications or media outlets where an author has published content.

dimension

published_date

published_date

The date when the content was originally published.

dimension

published_date_diff

published_date_diff

The difference in time from the current date to the content’s publication date.

dimension

published_date_epoch

published_date_epoch

The publication date of the content represented as an epoch timestamp.

metric

reply_ratio

reply_ratio

The ratio of replies to a social media post, serving as an indicator of engagement.

metric

reply_ratio_int

reply_ratio_int

An integer representation of the reply ratio, often used for simplified sorting or comparison.

metric

report_date

report_date

The date on which the report data was generated or collected.

dimension

retweet_ratio

retweet_ratio

The ratio of retweets to a social media post, indicating its virality and reach on platforms like Twitter.

metric

retweet_ratio_int

retweet_ratio_int

An integer representation of the retweet ratio, often used for simplified sorting or comparison.

metric

review

review

Specifies if the content item is a review.

metric

sad_count

sad_count

The total number of “sad” reactions to a piece of content on platforms like Facebook.

metric

sad_count_int

sad_count_int

The integer count of “sad” reactions.

metric

sad_count_percentage

sad_count_percentage

The percentage of total reactions that are “sad” reactions.

metric

stats_updated_at

stats_updated_at

The timestamp indicating when the associated statistics were last updated.

dimension

subdomain

subdomain

The subdomain of the URL where the content is published.

dimension

thumbnail

thumbnail

The URL or path to a thumbnail image associated with the content.

dimension

title

title

The main title of the article or content.

dimension

total_facebook_shares

total_facebook_shares

The aggregated total number of shares on Facebook.

metric

total_facebook_shares_int

total_facebook_shares_int

The integer count of total Facebook shares.

metric

total_reactions_percentage

total_reactions_percentage

The total percentage of all reactions across supported social platforms.

metric

total_reactions_without_likes

total_reactions_without_likes

The sum of all social media reactions, excluding “likes”.

metric

total_reactions_without_likes_int

total_reactions_without_likes_int

The integer count of total social media reactions, excluding “likes”.

metric

total_reddit_engagements

total_reddit_engagements

The total number of engagements (e.g., upvotes, comments) received on Reddit for the content.

metric

total_reddit_engagements_int

total_reddit_engagements_int

The integer count of total Reddit engagements.

metric

total_shares

total_shares

The aggregated total number of shares across all monitored social media platforms.

metric

total_shares_int

total_shares_int

The integer count of total shares across all monitored social media platforms.

metric

trending_score

trending_score

A score indicating the current popularity or trendiness of content within a specified timeframe.

metric

twitter_id_str

twitter_id_str

The Twitter user ID represented as a string.

dimension

twitter_screen_name

twitter_screen_name

The Twitter screen name (handle) of an influencer or author.

dimension

twitter_shares

twitter_shares

The total number of times the content has been shared on Twitter.

metric

twitter_shares_int

twitter_shares_int

The integer count of Twitter shares.

metric

twitter_user_id

twitter_user_id

The unique numeric identifier for a Twitter user.

dimension

type

type

The type or category of the entity or data record.

dimension

updated_at

updated_at

The timestamp when the record or entity was last updated.

dimension

url

url

The Uniform Resource Locator (URL) of the content or resource.

dimension

url_share_ratio

url_share_ratio

The ratio of times a URL has been shared across various social media platforms, indicating its overall social engagement.

metric

url_share_ratio_int

url_share_ratio_int

An integer representation of the URL share ratio, often used for simplified sorting or comparison.

metric

username

username

The username associated with a social media profile or author.

dimension

verified

verified

A boolean indicator signifying if a social media account or profile is verified.

dimension

video

video

Indicates if the content item is a video.

metric

video_length

video_length

The duration or length of the video content.

metric

workspace_id

workspace_id

A unique identifier for a specific workspace or project within the BuzzSumo platform.

dimension

workspaces

workspaces

A collection or list of workspaces accessible to the user, where projects and alerts are managed.

dimension

wow_count

wow_count

The total number of “wow” reactions to a piece of content on platforms like Facebook.

metric

wow_count_int

wow_count_int

The integer count of “wow” reactions.

metric

wow_count_percentage

wow_count_percentage

The percentage of total reactions that are “wow” reactions.

metric

youtube_comments

youtube_comments

The total number of comments received on a YouTube video.

dimension

youtube_comments_int

youtube_comments_int

The integer count of YouTube comments.

dimension

youtube_dislikes

youtube_dislikes

The total number of dislikes received on a YouTube video.

dimension

youtube_dislikes_int

youtube_dislikes_int

The integer count of YouTube dislikes.

dimension

youtube_likes

youtube_likes

The total number of likes received on a YouTube video.

dimension

youtube_likes_int

youtube_likes_int

The integer count of YouTube likes.

dimension

youtube_trending_score

youtube_trending_score

A score indicating the current popularity or trendiness of a YouTube video.

dimension

youtube_views

youtube_views

The total number of views received on a YouTube video.

dimension

youtube_views_int

youtube_views_int

The integer count of YouTube views.

dimension