Share Counts API

in

Note: This API is separate to our regular API and access must be arranged by contacting help@buzzsumo.com, regular API keys will not work.

The Share Counts API returns the share counts for up to 10 URLs at once. Calling the API will also trigger an update for each URL, if we don’t have the URL in our index currently then we will attempt to index it. You may then call the API again with the same URL to retrieve an updated count.

 

Resource URL

POST https://sharecounts-api.buzzsumo.com/share_counts.json?api_key=YOUR_API_KEY_HERE
JSON PAYLOAD:
{  
   "urls":[  
      "http://www.squaremile.com/you-can-now-buy-a-2m-jet-from-harrods2/",
      "http://www.ebay.com/itm/Mens-Nike-Air-Jordan-Future-Premium-652141-050-/301586799139",
      "http://wapbaze.org/videos/11845/video-luyek-jekanmo-ft-b-red.html",
      "http://highschoolsports.silive.com/news/article/673706060311713734/nda-kicks-off-tennis-season-with-strong-showing-against-sea/?hootPostID=f5b6d9cee6c5b0494221b6fd100df217",
      "http://master0.net/monsterhunter/post-1293/",
      "http://www.ebay.com/itm/Air-jordan-Retro-1-High-OG-ROYAL-DS-/131461076835",
      "https://www.interaction-design.org/ux-daily/300/the-ux-tools-series-great-tools-for-mind-mapping-flow-charting-and-site-mapping",
      "http://www.numa.paris/content/view/full/64624",
      "http://tammytwkr.pixnet.net/blog/post/179529576-%5b%e4%bb%a3%e8%a8%82%5d-%e9%9f%93%e5%9c%8b%e5%85%ac%e6%bc%94%e6%84%9b%e8%88%9e%e5%8b%95",
      "https://www.youtube.com/watch?v=_l5Vy50RNlg"
   ]
}

 

Note: urls can contain at most 10 urls.
RESPONSE:
{  
   "results":[  
      {  
         "url":"http://www.squaremile.com/you-can-now-buy-a-2m-jet-from-harrods2/",
         "error":"This URL has not been indexed by BuzzSumo. We will now index it and get share counts. Please call this API again in a few hours."
      },
      {  
         "url":"http://www.ebay.com/itm/Mens-Nike-Air-Jordan-Future-Premium-652141-050-/301586799139",
         "twitter":0,
         "facebook":0,
         "linkedin":0,
         "google_plus":0,
         "pinterest":0,
         "article_id":482000327
      },
      {  
         "url":"http://wapbaze.org/videos/11845/video-luyek-jekanmo-ft-b-red.html",
         "twitter":0,
         "facebook":7,
         "linkedin":0,
         "google_plus":0,
         "pinterest":0,
         "article_id":826051041
      },
      {  
         "url":"http://highschoolsports.silive.com/news/article/673706060311713734/nda-kicks-off-tennis-season-with-strong-showing-against-sea/?hootPostID=f5b6d9cee6c5b0494221b6fd100df217",
         "twitter":2,
         "facebook":0,
         "linkedin":0,
         "google_plus":0,
         "pinterest":0,
         "article_id":757903348
      },
      {  
         "url":"http://master0.net/monsterhunter/post-1293/",
         "twitter":2,
         "facebook":0,
         "linkedin":0,
         "google_plus":0,
         "pinterest":0,
         "article_id":769869601
      },
      {  
         "url":"http://www.ebay.com/itm/Air-jordan-Retro-1-High-OG-ROYAL-DS-/131461076835",
         "twitter":0,
         "facebook":0,
         "linkedin":0,
         "google_plus":0,
         "pinterest":0,
         "article_id":454619143
      },
      {  
         "url":"https://www.interaction-design.org/ux-daily/300/the-ux-tools-series-great-tools-for-mind-mapping-flow-charting-and-site-mapping",
         "twitter":26,
         "facebook":13,
         "linkedin":29,
         "google_plus":6,
         "pinterest":3,
         "article_id":379161222
      },
      {  
         "url":"http://www.numa.paris/content/view/full/64624",
         "twitter":4,
         "facebook":1,
         "linkedin":0,
         "google_plus":0,
         "pinterest":0,
         "article_id":623994858
      },
      {  
         "url":"http://tammytwkr.pixnet.net/blog/post/179529576-%5b%e4%bb%a3%e8%a8%82%5d-%e9%9f%93%e5%9c%8b%e5%85%ac%e6%bc%94%e6%84%9b%e8%88%9e%e5%8b%95",
         "twitter":0,
         "facebook":1623,
         "linkedin":0,
         "google_plus":0,
         "pinterest":0,
         "article_id":675348751
      },
      {  
         "url":"https://www.youtube.com/watch?v=_l5Vy50RNlg",
         "twitter":2,
         "facebook":3,
         "linkedin":0,
         "google_plus":1,
         "pinterest":0,
         "article_id":694667934
      }
   ]
}
As seen above “results” will be array of share count info, same order as urls passed in. We will do intelligent url normalization (i.e. look at http/https, remove/add trailing slash, remove/add www). If urls is not in our index, we will return this:
{  
   "url":"http://www.squaremile.com/you-can-now-buy-a-2m-jet-from-harrods2/",   
   "error":"This URL has not been indexed by BuzzSumo."
}
After the call, all URLs will have their share counts updated within 2.5 hours.
If a URL has been shared on social media and our bots are able to crawl the website then typically we will have it in our index within a day.

1