A command-line and programmatic interface to various social sharecount endpoints.
Project description
A command-line utility and Python library to access the social share counts for a particular URL.
Usage
Usage: socialshares <url> [<platforms>...] [options] Options: -h, --help Show this screen. -p, --plain Plain output. -r <attempts>, --retry <attempts> Retry fetching up to <attempt> 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 again once (the default) for platforms that fail
$ 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.
Source Distribution
socialshares-0.1.1.tar.gz
(4.5 kB
view hashes)