API Docs

Version:  1.1

GET/v1.1/bulk

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


Definition

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


Parameters

NameTypeDescription Required
bulk_idstringThe bulk_id provided by the /bulk POST call.true
apikeystringYour API Key.true

Curl
Node.js
Python
Php
curl 'https://api.sharedcount.com/v1.1/bulk?apikey=YOUR_API_KEY&bulk_id=BULK_ID'
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);
 

Result Format

Success
Incomplete
Text
{
    "data": {
        "http://google.com/": {
            "Pinterest": 1436815,
            "Facebook": {
              "total_count":4629449,
              "comment_count":225136,
              "reaction_count":1258082,
              "share_count":3145819,
              "comment_plugin_count":412
            }
        },
        "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