API Docs

Version:  1.0

GET/v1.0/bulk

BETA: Get a large number of recently-posted URLs all at once to calculate bulk social counts.


Definition

https://api.sharedcount.com/v1.0/bulk


Parameters

Query Params
bulk_id:
required
string
The bulk_id provided by the /bulk POST call.

apikey:
required
stringYOUR_APP_KEY
force:	string
Set this parameter to 1 force results to return even if not all URLs have completed processing.

Result Format

Success
Incomplete
Text
{
    "data": {
        "http://google.com/": {
            "StumbleUpon": 11000,
            "Pinterest": 1436815,
            "LinkedIn": 1920,
            "Facebook": {
              "total_count":4629449,
              "comment_count":225136,
              "reaction_count":1258082,
              "share_count":3145819,
              "comment_plugin_count":412
            },
            "GooglePlusOne": 12219845
        },
        "http://stackoverflow.com/": {
            "...snip...": "98 URLs not shown for brevity..(snip).."
        }

    },
    "_meta": {
        "urls_completed": 100,
        "bulk_id": "a4f8f0fd436995987dbef98bbff9accc61282c63",
        "completed": true,
        "urls_queued": 100
}
{"data": [],
  "_meta": {
    "urls_completed": 90,
    "bulk_id": "a4f8f0fd436995987dbef98bbff9accc61282c63",
    "completed": false,
    "urls_queued": 100
    }
  }
No Content

Documentation

Node.js
Python
Php
npm i sharedcount-sdk

const SharedCountApi = require('sharedcount-sdk');
let sharedCountApiInstance = new SharedCountApi(YOUR_API_KEY);
 
//Get bulk_id from bulk post response, then using bulkGet to get result
var bulkId = bulkPostResponse.data.bulk_id;
var bulkResponse = sharedCountApiInstance.bulkGet(bulkId);
pip install sharedcountsdk

from sharedcountsdk import SharedCountApi
sharedCountApiInstance = SharedCountApi('YOUR_API_KEY')

#Get bulk_id from bulk post response, then using bulkGet to get result
bulkId=bulkPostResponse['bulk_id']
bulkResponse=sharedCountApiInstance.bulkGet(bulkId) 
composer require sharedcount/sharedcount-sdk

require __DIR__ . '/vendor/sharedcount/sharedcount-sdk/lib/api.php';
$sharedcountApiInstance = new SharedcountApi('YOUR_API_KEY');

#Get bulk_id from bulk post response, then using bulkGet to get result
$bulkId = $bulkPostResponse['bulk_id'];
$bulkResponse = $sharedcountApiInstance->bulkGet($bulkId);