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 |