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. You can also use this API to fetch the share counts for a single URL.

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:

general_article,video,list,how_to_article,what_post,why_post,infographic.

By default, all article types are returned.

general_article – articles that are not videos
video – videos (from YouTube or elsewhere)
list – articles that are lists (ie. 10 places to visit)
how_to_article – how to articles (ie. How to cook rice)
what_post – articles whose headline start with “What” (ie. What is minimalism?)
why_post – articles whose headline start with “Why” (ie. Why we need minimum income)
infographic – articles that have infographics

Example Value: list,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

12) domains (optional) pass one or more domains comma separated to see content just from those sites.

Example Value: example.com,example2.com

13) blocked_domains (optional) use to remove unwanted domains from results, also accepts one or more domains separated by a comma

Example Value: spam.com,junk.com

 

Example Request

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

Example Response

{  
   "results":[  
      {
         author_name: "Aleyda Solis",
         alexa_rank: 11711,
         pinterest_shares: 9,
         num_words: 1660,
         twitter_shares: 710,
         language: "en",
         og_url: "https://searchengineland.com/monitoring-web-migrations-a-checklist-for-an-effective-switch-291131",
         video: 0,
         title: "Monitoring web migrations: A checklist for moving from one site to another",
         evergreen_score: 0.96,
         total_shares_with_pinterest: 1164, //deprecated - use total_shares
         article_amplifiers: [
         "sengineland",
         "aleyda"
         ],
         domain_name: "searchengineland.com",
         updated_at: 1518525885,
         facebook_likes: 62,
         id: "3540668502",
         facebook_comments: 5,
         thumbnail: "https://searchengineland.com/figz/wp-content/seloads/2014/08/checklist-ss-1920.jpg",
         twitter_user_id: 145875066,
         total_facebook_shares: 223,
         url: "https://searchengineland.com/monitoring-web-migrations-a-checklist-for-an-effective-switch-291131",
         linkedin_shares: 222,
         facebook_shares: 156,
         num_linking_domains: 2,
         subdomain: "searchengineland.com",
         published_date: 1518447454,
         total_shares: 1164,
         article_types: [
                  "all_content",
                  "general_article"
         ],
         general_article: 1, //deprecated - use article_types
         how_to_article: 0, //deprecated  - use article_types
         infographic: 0, //deprecated - use article_types
         list: 0, //deprecated - use article_types
         what_post: 0, //deprecated - use article_types
         why_post: 0, //deprecated - use article_types
         display_title: "Monitoring web migrations: A checklist for moving from one site to another"
},
{
         ...
},
   ],
   "total_pages":226,
   "display_code":null,
   "search_type":"keyword"
}

5