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
Baidu baidu
Qzone qzone
Twitter twitter
VK vk
Reddit reddit
Sina Weibo weibo
LinkedIn linkedin
Mail.ru mailru
Odnoklassniki odnoklassniki
Tumblr tumblr
Pinterest pinterest
Pocket pocket
Hatena hatena
Scoop.it scoopit
Renren renren
Xing xing
Hacker News hackernews
Mixi mixi
Wykop wykop
Buffer buffer
StumbleUpon stumbleupon
Kaixin001 kaixin001
Yummly yummly
Nk.pl nk
Diigo diigo
Surfingbird surfingbird
Draugiem draugiem
Fancy fancy
Delicious delicious
BibSonomy bibsonomy
vkrugudruzei.ru vkrugudruzei
BizSugar bizsugar
DesignFloat designfloat
Blog Engage blogengage
Pusha pusha
Svejo svejo
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
Github github
Tumblr tumblr
Pinterest pinterest
SoundCloud soundcloud
Spotify spotify
Vimeo vimeo
Medium medium
Steam steam
Flickr flickr
Behance behance
Bitbucket bitbucket
Dribbble dribbble
Envato envato
Foursquare foursquare
MixCloud mixcloud
Typepad typepad
Flipboard flipboard
Meneame meneame
Diigo diigo
Vine vine
Forrst forrst
Delicious delicious
folkd folkd