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.

Authentication

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

Share Count

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

Parameters

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

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 Count

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