API Docs

Version:  1.0

POST/v1.0/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.0/bulk


Parameters

Query Params
apikey:
required
string
Your API key.

Body Params
urls:
required
string
one URL per line

Result Format

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

Documentation

Node.js
Python
Php
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);

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

Shell

POST api.sharedcount.com/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.