API Information

There is a courtesy rate limit of 100,000 queries per day. If you expect to exceed that, please get in contact with us. While at this time we do not throttle usage, we reserve the right to do so in the future.

Values are cached for 5 minutes at a time. So, values may be up to 5 minutes old for repeated queries.

You can retrieve the counts from a JSON and JSONP API:
HTTP Endpoint: http://api.sharedcount.com/
HTTPS Endpoint: https://sharedcount.appspot.com/

Parameters

• url: The URL of the page, including http, and www., if applicable. At this time, we do not provide canonicalization services. URL Encode to minimize errors.
• callback (optional): define a callback function for JSONP

Note: The way in which you pass the URL will effect the results, depending on the service. Some services will return different results, depending on if you include a trailing slash on the URL.

Sources

We retrieve the data from the official 'Share' buttons provided by these major services. All of the services provide a JSON API for accessing the shared counts for particular URLs.

• Facebook*: http://api.ak.facebook.com/restserver.php?v=1.0&method=links.getStats&urls=%%URL%%&format=json
• Twitter: http://urls.api.twitter.com/1/urls/count.json?url=%%URL%%&callback=twttr.receiveCount
• Reddit:http://buttons.reddit.com/button_info.json?url=%%URL%%
• LinkedIn: http://www.linkedin.com/cws/share-count?url=%%URL%%
• Digg: http://widgets.digg.com/buttons/count?url=%%URL%%
• Delicious: http://feeds.delicious.com/v2/json/urlinfo/data?url=%%URL%%
• StumbleUpon: http://www.stumbleupon.com/services/1.01/badge.getinfo?url=%%URL%%
• Pinterest: http://api.pinterest.com/v1/urls/count.json?url=%%URL%%
• Google +1 +1 counts are retrieved via a JSON-RPC POST call.
  POST URL:
  https://clients6.google.com/rpc?key=AIzaSyCKSbrvQasunBoV16zDH9R33D88CeLr9gQ
  POST Body: [{"method":"pos.plusones.get","id":"p","params":{"nolog":true,"id":"%%URL%%","source":"widget","userId":"@viewer","groupId":"@self"},"jsonrpc":"2.0","key":"p","apiVersion":"v1"}]

Sample Code - PHP 5+


<?php
$url = ((!empty($_SERVER['HTTPS'])) ? "https://": "http://" ) . $_SERVER['SERVER_NAME'].$_SERVER['REQUEST_URI'];
$json = file_get_contents("http://api.sharedcount.com/?url=" . rawurlencode($url));
$counts = json_decode($json, true);
echo "This page has " . $counts["Twitter"] ." tweets, " . $counts["Facebook"]["like_count"] . " likes, and ". $counts["GooglePlusOne"] . "+1's";
?>

Result:

This page has 27 tweets, 1 likes, and 5+1's

Sample Code - JSONP

jQuery Plugin:

Result: