A command-line and programmatic interface to various social sharecount endpoints.
Project description
Social shares.
A command-line utility and Python library to access the social share counts for a particular URL.
Usage
Usage: socialshares […] [options]
Options: -h, –help Show this screen. -p, –plain Plain output. -r , –retry Retry fetching up to times [default: 1] -e, –exit Exit with an error code when not all counts could be fetched.
Some examples:
# fetch count for all supported platforms, try up to three times
$ socialshares http://www.kalzumeus.com/2010/06/17/falsehoods-programmers-believe-about-names/
# fetch only facebook and twitter
$ socialshares http://www.theguardian.com/politics facebook twitter --retry 2
Supported platforms
Platform |
Description |
---|---|
google +1’s |
|
facebook likes |
|
pinterest pins |
|
reddit ups and downs (summed across posts) |
|
twitter tweets and retweets containing the URL |
Platforms are fetched in parallel and retried (once by default). If no platforms are specified, just facebook and twitter will be returned.
Output
By default, socialshares outputs JSON:
{
"reddit": {
"downs": 0,
"ups": 6
},
"google": 20,
"facebook": 1498,
"twitter": 300,
"pinterest": 1
}
Use the --plain flag if instead you’d like space-separated output.
$ socialshares http://www.theguardian.com/politics twitter
57
Usage from Python
import socialshares
counts = socialshares.fetch(url, ['facebook', 'pinterest'])
Installation
pip install socialshares
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.