Most Shared API

in API

API documentation > Most Shared API

The most shared API returns the most shared content for a specific domain, or topic/keyword. It returns the same results returned by our web interface.

Resource URL

GET http://api.buzzsumo.com/search/articles.json

Parameters

1) q (required) This is either a keyword, URL, or a domain/subdomain.

Example Value 1: marketing (returns articles related to marketing)

Example Value 2: buzzsumo.com/blog/future-lot-content/ (returns share counts for URL)

Example Value 3: buzzsumo.com (returns most shared content for domain)

Example Value 4: buzzsumo.com/blog (returns URLs from domain containing “/blog”)

2) result_type (optional) Sort the results by this social network. Default: total, Must be one: total, facebook, twitter, linkedin, pinterest, google_plus

Example Value: total

3) page (optional) the page to get results for. Default: 0, Pages start with 0, so to get the 1st page, pass page = 0.

Example Value: 0

4) num_days (optional) the number of days to search from today. If you pass 7, it will search for articles published in the past 7 days. Default: 1

Example Value: 7

5) article_type (optional) the type of articles to search for, comma separated (no spaces). Values can be any of the following: giveaway, infographic, general_article, guest_post, interview, video. Default: giveaway,infographic,general_article,guest_post,interview,video

Example Value: general_article,video

6) begin_date (optional) The begin date to search for in Unix epoch time. If num_days is specified, this field should not be passed, and will be ignored if passed. Only articles published >= this date will be returned.

Example Value: 1444123015

7) end_date (optional) The end date to search for in Unix epoch time. If num_days is specified, this field should not be passed, and will be ignored if passed.

Example Value: 1444123015

8) num_results (optional) The number of results to return. Default: 20

Example Value: 15

9) language (optional) filter results by language. Pass the two letter ISO code: https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes

Example Value: fr

10) tld (optional) filter results by top level domain. Pass just the tld, e.g. for French domains pass “fr”. For UK sites pass “uk”. Note “.co.uk” is not a top level domain, “uk” is.

Example Value: uk

11) exact_url only return the exact URL if found.

Example Value: true

Example Request

GET http://api.buzzsumo.com/search/articles.json?q=marketing&api_key=INSERT_API_KEY&result_type=total

Example Response

{  
   "results":[  
      {  
         "published_date":1444151143,
         "linkedin_shares":126,
         "google_plus_shares":5,
         "meta_keywords":"customer relationship",
         "twitter_user_id":2572467,
         "total_shares_with_pinterest":3386,
         "article_types":[  
            "general_article"
         ],
         "twitter_shares":740,
         "article_amplifiers":[  
            "craigbrownphd"
         ],
         "og_url":"http://www.entrepreneur.com/article/251355",
         "url":"http://www.entrepreneur.com/article/251355",
         "pinterest_shares":1,
         "id":"815583363",
         "total_shares":3386,
         "title":"Why You Should Drop the Client Who Demands You Drop Your Fee",
         "thumbnail":"https://assets.entrepreneur.com/content/3x2/822/1386894370-tipping-while-traveling-whom-tip-how-much.jpg",
         "subdomain":"www.entrepreneur.com",
         "author_name":"Jacqueline Whitmore",
         "num_words":631,
         "article_amplifier_images":[  
            "http://pbs.twimg.com/profile_images/210092499/cb1_bigger.jpg"
         ],
         "domain_name":"entrepreneur.com",
         "total_facebook_shares":2514,
         "giveaway":0,
         "infographic":0,
         "general_article":1,
         "guest_post":0,
         "interview":0,
         "video":0,
         "display_title":"Why You Should Drop the Client Who Demands You Drop Your Fee"
      },
      {  
         "published_date":1444125724,
         "linkedin_shares":338,
         "google_plus_shares":106,
         "twitter_user_id":446240,
         "total_shares_with_pinterest":2733,
         "article_types":[  
            "general_article"
         ],
         "twitter_shares":1728,
         "og_url":"http://www.socialmediaexaminer.com/how-to-run-an-instagram-influencer-campaign/",
         "url":"http://www.socialmediaexaminer.com/how-to-run-an-instagram-influencer-campaign/",
         "pinterest_shares":6,
         "id":"814583065",
         "total_shares":2733,
         "title":"How to Run an Instagram Influencer Campaign",
         "thumbnail":"http://www.socialmediaexaminer.com/wp-content/uploads/2015/10/sm-run-instagram-influencer-campaign-560.png",
         "subdomain":"www.socialmediaexaminer.com",
         "author_name":"Socialmedia Examiner",
         "num_words":1065,
         "domain_name":"socialmediaexaminer.com",
         "total_facebook_shares":555,
         "giveaway":0,
         "infographic":0,
         "general_article":1,
         "guest_post":0,
         "interview":0,
         "video":0,
         "display_title":"How to Run an Instagram Influencer Campaign"
      }
   ],
   "total_pages":226,
   "display_code":null,
   "search_type":"keyword"
}

Response Fields

total_shares This is the total number of shares for this article, counting facebook, twitter, linkedin, pinterest, and Google+

total_facebook_shares This is the total number of Facebook shares for this article

total_shares_with_pinterest This is a legacy field, which should always be equal to total_shares. It is safe to ignore.

giveaway Set to 1 if the article is a giveaway article.

guest_post Set to 1 if the article is a guest_post

video Set to 1 if the article is a video

general_article Set to 1 if the article is a general article (this is always 1 if it’s not a video)

published_date Time in epoch time when the article was first published.

thumbnail The og:image or twitter:image tag value if present in the article.

3