Shareaholic
Use the Share Data APIs to access powerful analytics
to know your social referral metrics inside and out.
Understand how and which users are sharing and engaging with your content.

Learn Who Your Best Referrals Come From

Shareaholic tracks all of your important social media metrics including popular pages on your website, referral channels, and who the individual people are that are making referrals and spreading your webpages on the internet on your behalf bringing you back more traffic and new visitors without increasing your marketing budget.

Some of this data is now available via APIs, while more detailed reports about your website are available here. Don't fly blind; drive growth and engagement on your website backed with real and accurate data.

Share Data API Documentation

All API methods are accessible via very simple HTTP calls. We have optimized for ease of implementation, so you won’t see anything complicated. Most implementations of this API take less than 15 minutes to setup. Simply hit the provided URLs with their respective parameters, and you're done.

a) Share Count API

Answers how many times webpages from your website have been shared in a given timeframe.

URL: http://www.shareaholic.com/api/data/__anydomain__/sharecount/__timeframe__/
  • anydomain - the domain or sub-domain you want data returned for
  • timeframe - 1=share count for last 24 hours, 30=last 30 days
  • &callback= - an optional parameter; passes JSON response to the JavaScript callback function you specify

Example API Call:

http://www.shareaholic.com/api/data/driveinside.com/sharecount/30/?callback=myfunction

API Result:

myfunction({"sharecount":3373,"timeframe":30});

b) Top Users API

Answers who are the top users / sharers for a given website.

URL: http://www.shareaholic.com/api/data/__anydomain__/topusers/__count__/
  • anydomain - the domain or sub-domain you want data returned for
  • count - 5=return top 5 users (default), 20=maximum
  • &callback= - an optional parameter; passes JSON response to the JavaScript callback function you specify

Example API Call:

http://www.shareaholic.com/api/data/youtube.com/topusers/1/?callback=myfunction

API Result:

myfunction([{"picture_url":"http:\/\/shrimgs.s3.amazonaws.com\/profile_images\/388_48x48.png","username":"dcancel","points":263,"total_points":801}]);

  • picture_url - full path to the users avatar image
  • username - shareaholic username (Tip: you could also use this to link to a users public profile. ex.: http://www.shareaholic.com/username)
  • points - All users earn points as they share and discover your content. "points" are points an user earns on a specific domain.
  • total_points - "total_points" is the users' overall points tally across all domains.
All Top User stats are updated daily. Points are based on a rolling 30-day window.

Shareaholic API Branding Requirements

While the Shareaholic Share Data API is provided to you at no-cost, we require that you adhere to our branding requirements, as follows:

Attribution

All input and output elements must be accompanied by clear “Shareaholic” attribution.

Links

The following elements must be present and link to http://www.shareaholic.com using the standard linking format on your site.

  • Any displayed metrics must cite “Shareaholic” as the source
  • Any displayed metrics must provide an active link to http://www.shareaholic.com

Graphs & Logos

If Shareaholic data is used to create a graphical representation of Shareaholic’s metrics a Shareaholic logo needs to be present within or adjacent to the graphic. Please use an approved Shareaholic logo (below). It’s up to the discretion of the publisher where to specifically place the logo within or adjacent to the graphic.


Feedback

If you believe you have found a bug, or you’d like to request additional functionality, or you release something using this API, we’d love to hear from you.