Skip to main content

API Reference

The Social API is a REST API for getting social share counts & follower counts from the majority of popular social platforms in the world.

The API is authenticated by passing an Authorization header containing your API key with your request.

GET /ENDPOINT HTTP/1.1
Host: api.donreach.com
Authorization: YOUR_API_KEY

Retrieve social share counts for a URL using the /shares endpoint.

Parameters

Parameter Description
url (required) The URL of the page you want to fetch the social shares for.
providers (required) A comma seperated list of provider IDs to get the share count from.
callback (optional) The JavaScript callback to execute (for JSONP).

Example

GET /shares?providers=facebook,google,twitter&url=http://9gag.com/ HTTP/1.1
Host: api.donreach.com
Authorization: YOUR_API_KEY

Which returns the following:

{
  "shares": {
    "facebook": 473897,
    "google": 86494,
    "twitter": 122435
  },
  "total": 682826,
  "url": "http://9gag.com/"
}

Providers

Provider ID
Google+ google
Facebook facebook
Qzone qzone
Twitter twitter
Reddit reddit
VK vk
Sina Weibo weibo
LinkedIn linkedin
Odnoklassniki odnoklassniki
Mail.ru mailru
Tumblr tumblr
Pinterest pinterest
Hatena hatena
Pocket pocket
Hacker News hackernews
Xing xing
Wykop wykop
Renren renren
StumbleUpon stumbleupon
Buffer buffer
Mixi mixi
Scoop.it scoopit
Diigo diigo
Nk.pl nk
Draugiem draugiem
Delicious delicious
Kaixin001 kaixin001
Fancy fancy
Surfingbird surfingbird
BibSonomy bibsonomy
vkrugudruzei.ru vkrugudruzei
Yummly yummly
BizSugar bizsugar
DesignFloat designfloat
Blog Engage blogengage
Pusha pusha
Svejo svejo
Yuuby yuuby
moShare moshare

Enable Twitter Count

Twitter counts are retrieved using newsharecounts.com. To enable them please visit newsharecounts.com and register your website (it’s free).

Follower counts for social profiles are retrieved using the /followers endpoint.

Important: follower counts are still in BETA and the response format is likely to change in the near future.

Parameters

Pass all the social profiles for which you’d like to request the follower count to the API as GET parameters, using the provider ID as the parameter name and your profile username, ID or URL as the value.

Example

In the following example we’re fetching the follower counts for Twitter & Facebook.

GET /followers?twitter=abemedia&facebook=abemedia HTTP/1.1
Host: api.donreach.com
Authorization: YOUR_API_KEY

Heads up: you can also use profile URLs instead of usernames/IDs e.g. /followers?twitter=abemedia is the same as /followers?twitter=https://twitter.com/abemedia.

Which returns the following:

{
  "followers": {
    "facebook": 101,
    "twitter": 529
  },
  "total": 630
}

Providers

Provider ID
Google+ google
YouTube youtube
Facebook facebook
Twitter twitter
Instagram instagram
Twitch twitch
Tumblr tumblr
Pinterest pinterest
Github github
SoundCloud soundcloud
Vimeo vimeo
Spotify spotify
Steam steam
Medium medium
Flickr flickr
Behance behance
Bitbucket bitbucket
Dribbble dribbble
Envato envato
Foursquare foursquare
Typepad typepad
MixCloud mixcloud
Flipboard flipboard
Meneame meneame
Vine vine
Diigo diigo
Delicious delicious
Forrst forrst
folkd folkd