API Docs

POST/v1.1/bulk

Post a large number of URLs all at once to calculate bulk social counts. (This page is incomplete.)

Definition

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

Parameters

curl POST 'https://api.sharedcount.com/v1.1/bulk?apikey=YOUR_API_KEY' --header 'Content-Type: text/plain' --data-raw \
'https://www.nytimes.com/ \
 https://www.wsj.com/ \
 https://edition.cnn.com/'

npm i sharedcount-sdk

const SharedCountApi = require('sharedcount-sdk');
let sharedCountApiInstance = new SharedCountApi('YOUR_API_KEY');
 
//Post a large number of URLs all at once to calculate bulk social counts.
var urls = ['url1', 'url2'];
var bulkPostResponse = sharedCountApiInstance.bulkPost(urls);

pip install sharedcountsdk

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

#Post a large number of URLs all at once to calculate bulk social counts.
urls = ["urls", "url2"]
bulkPostResponse=sharedCountApiInstance.bulkPost(urls)

composer require sharedcount/sharedcount-sdk

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

//Post a large number of URLs all at once to calculate bulk social counts.
$urls = array('url1', 'url2');
$bulkPostResponse = $sharedcountApiInstance->bulkPost($urls);

Result Format

{"count":921,"bulk_id":"4a7d9ca68177713593c713cc584a7edf9ee9017c"}

Documentation

URLs are transmitted one per line in the POST body, with a trailing line-break after the final URL.

Shell

POST api.sharedcount.com/v1.1/bulk?apikey=YOUR_APP_KEY

Request Body:
http://www.google.com/
http://www.amazon.com/

Successfully completed API queries done via batching will count against your daily API quota. Requests exceeding your API quota will be rejected. Under the covers, the bulk endpoint acts as a layer on top of the existing API; one which handles the queueing and processing of a large number of queries for the purposes of reducing transit overhead.

When you make your POST request, you'll receive a response giving you a bulk_id, and also the number of URLs that were accepted and queued for querying. Invalid URLs will be silently ignored.

Use theGET /bulkcall to retrieve your data from the endpoint after posting.