{ "info": { "author": "Stijn Debrouwere", "author_email": "stijn@debrouwere.org", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python", "Topic :: Scientific/Engineering :: Information Analysis" ], "description": "Social shares\n=============\n\n|Build Status|\n\nA command-line utility and Python library to access the social share\ncounts for a particular URL.\n\n**Note:** unfortunately this utility can no longer be used to fetch\ntweet and retweet counts, as Twitter has removed the API this\nfunctionality relied on. Facebook and other platforms still work.\n\nUsage\n-----\n\n::\n\n Usage:\n socialshares [...] [options]\n\n Options:\n -h, --help Show this screen.\n -p, --plain Plain output.\n -r , --retry Retry fetching up to times [default: 1]\n -e, --exit Exit with an error code when not all counts could be fetched.\n\nSome examples:\n\n.. code:: sh\n\n # fetch count for all supported platforms,\n # try again once (the default) for platforms that fail\n $ socialshares http://www.kalzumeus.com/2010/06/17/falsehoods-programmers-believe-about-names/\n\n # fetch only facebook\n $ socialshares http://www.theguardian.com/politics facebook --retry 2\n\nSupported platforms\n-------------------\n\n+-------------+----------------------------------------------+\n| Platform | Description |\n+=============+==============================================+\n| facebook | facebook shares and comments |\n+-------------+----------------------------------------------+\n| linkedin | linkedin shares |\n+-------------+----------------------------------------------+\n| google | google +1's |\n+-------------+----------------------------------------------+\n| pinterest | pinterest pins |\n+-------------+----------------------------------------------+\n| reddit | reddit ups and downs (summed across posts) |\n+-------------+----------------------------------------------+\n\nPlatforms are fetched in parallel and retried (once by default.) If no\nplatforms are specified, just facebook and twitter will be returned.\n\nUnsupported platforms\n---------------------\n\nThe following APIs unfortunately no longer exist, and have been removed\nfrom the interface.\n\n+---------------+--------------------------------------------------+\n| Platform | Description |\n+===============+==================================================+\n| twitter | twitter tweets and retweets containing the URL |\n+---------------+--------------------------------------------------+\n| facebookfql | facebook likes, shares and comments |\n+---------------+--------------------------------------------------+\n\nOutput\n------\n\nBy default, ``socialshares`` outputs JSON:\n\n.. code:: json\n\n {\n \"reddit\": {\n \"downs\": 0,\n \"ups\": 6\n },\n \"google\": 20,\n \"facebook\": 1498,\n \"twitter\": 300,\n \"pinterest\": 1\n }\n\nUse the ``--plain`` flag if instead you'd like space-separated output.\n\n.. code:: sh\n\n $ socialshares http://www.theguardian.com/politics twitter\n 57\n\nUsage from Python\n-----------------\n\n.. code:: python\n\n import socialshares\n counts = socialshares.fetch(url, ['facebook', 'pinterest'])\n\nInstallation\n------------\n\n.. code:: sh\n\n pip install socialshares\n # optionally, for asynchronous fetching\n pip install grequests\n\nIf `requests\\_futures `__ and\n(for Python 2.x) `futures `__\nare installed, ``social-shares`` will use these packages to speed up\nshare count fetching, by accessing the various social media APIs in\nparallel.\n\n.. |Build Status| image:: https://travis-ci.org/debrouwere/social-shares.svg?branch=master\n :target: https://travis-ci.org/debrouwere/social-shares", "description_content_type": null, "docs_url": null, "download_url": "https://github.com/debrouwere/social-shares/tarball/master", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/debrouwere/social-shares", "keywords": "data analytics facebook twitter googleplus pinterest", "license": "ISC", "maintainer": null, "maintainer_email": null, "name": "socialshares", "package_url": "https://pypi.org/project/socialshares/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/socialshares/", "project_urls": { "Download": "https://github.com/debrouwere/social-shares/tarball/master", "Homepage": "https://github.com/debrouwere/social-shares" }, "release_url": "https://pypi.org/project/socialshares/1.1.0/", "requires_dist": null, "requires_python": null, "summary": "A command-line and programmatic interface to various social sharecount endpoints.", "version": "1.1.0" }, "last_serial": 2342032, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "7f3952ab7cd932ee3bc5f0314c238c25", "sha256": "89fc59debd7ea14c213c36bb84fb0f87651a22141868725d47becb289ee5e9b1" }, "downloads": -1, "filename": "socialshares-0.1.0.tar.gz", "has_sig": false, "md5_digest": "7f3952ab7cd932ee3bc5f0314c238c25", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4457, "upload_time": "2014-09-08T15:24:21", "url": "https://files.pythonhosted.org/packages/f2/ee/3b12083ef2504c26639c1c89594a0ebde9ed80ad3d7b8c9b910b00bb77d4/socialshares-0.1.0.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "200c370b9e00b79da4f3dd1201ff55fa", "sha256": "1055681c39711aa003dd19532a2d0f7ed93c7af7c80ccfb455c63b0a4d81daa6" }, "downloads": -1, "filename": "socialshares-0.1.1.tar.gz", "has_sig": false, "md5_digest": "200c370b9e00b79da4f3dd1201ff55fa", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4498, "upload_time": "2014-11-25T10:29:36", "url": "https://files.pythonhosted.org/packages/b4/f1/2b9d41df57d38c188307de1387c41323444b3f085b67cfa24f2513e540fe/socialshares-0.1.1.tar.gz" } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "5681c3dcaf54752b17a90bdeafea794c", "sha256": "8b7b4fa50cbdcf89a0a614b5263e18643c0e798c85974befdda9ceb343b0ff3b" }, "downloads": -1, "filename": "socialshares-0.3.0.tar.gz", "has_sig": false, "md5_digest": "5681c3dcaf54752b17a90bdeafea794c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4737, "upload_time": "2014-11-29T19:08:56", "url": "https://files.pythonhosted.org/packages/56/6e/2c13f365e1f110a5a9dd31432f850a1d9ad4893f300ecb3b30bf46293107/socialshares-0.3.0.tar.gz" } ], "0.3.1": [ { "comment_text": "", "digests": { "md5": "a168dcf8cef9a79a8084ce2fff468227", "sha256": "571ca60f0879a97768b6fe5f33cb6da1263bf0d5665a8953ef460ef5eac99820" }, "downloads": -1, "filename": "socialshares-0.3.1.tar.gz", "has_sig": false, "md5_digest": "a168dcf8cef9a79a8084ce2fff468227", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4917, "upload_time": "2014-11-29T19:20:58", "url": "https://files.pythonhosted.org/packages/b1/49/bc51dd38a467b255cb933f5c9c26fda109307528dadc7ac9a836208b7218/socialshares-0.3.1.tar.gz" } ], "0.3.2": [ { "comment_text": "", "digests": { "md5": "586b5ece5b4a7db21c45ba6234406e76", "sha256": "b33fe78386f17cdfb2ed63f53e8fe8dd2566658b0532b1ad26a5f792df65b63a" }, "downloads": -1, "filename": "socialshares-0.3.2.tar.gz", "has_sig": false, "md5_digest": "586b5ece5b4a7db21c45ba6234406e76", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4923, "upload_time": "2014-11-29T19:22:49", "url": "https://files.pythonhosted.org/packages/75/4c/1fed829eb14bdcb2107dc7647a721eb4522bd991de96b65b5f1726d0aa74/socialshares-0.3.2.tar.gz" } ], "0.4.0": [ { "comment_text": "", "digests": { "md5": "0f65a7804325cc5aca2d7555d1841cb4", "sha256": "b9cbf6d58432de081f9bfa43cb11658ca147b654db10be4af32a1891feb1e3c0" }, "downloads": -1, "filename": "socialshares-0.4.0.tar.gz", "has_sig": false, "md5_digest": "0f65a7804325cc5aca2d7555d1841cb4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6131, "upload_time": "2015-01-20T18:28:14", "url": "https://files.pythonhosted.org/packages/cc/21/9ef614abddc15606603e3cbaed9c60a04bb69393ce11c5865209133bb0ca/socialshares-0.4.0.tar.gz" } ], "1.0.0": [ { "comment_text": "", "digests": { "md5": "743ee6b90cb8c1b57d9f42e0e2f5480d", "sha256": "1f5049feb0ee9e406db764787b3e0e32057a391cb88c5c622c1653505af61c5b" }, "downloads": -1, "filename": "socialshares-1.0.0.tar.gz", "has_sig": false, "md5_digest": "743ee6b90cb8c1b57d9f42e0e2f5480d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7661, "upload_time": "2015-02-08T15:07:24", "url": "https://files.pythonhosted.org/packages/af/e3/4551594bc520fbc0c55161ed1418dc946843140898bd786ebaa9023cda76/socialshares-1.0.0.tar.gz" } ], "1.1.0": [ { "comment_text": "", "digests": { "md5": "ecd255c660015cb9cd59a232d3bad7b1", "sha256": "bcf9f6e3b1a663f6edae6d6eaaef7f0595680c7f9872b7631fb0927e23edda03" }, "downloads": -1, "filename": "socialshares-1.1.0.tar.gz", "has_sig": false, "md5_digest": "ecd255c660015cb9cd59a232d3bad7b1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7144, "upload_time": "2016-09-14T11:01:56", "url": "https://files.pythonhosted.org/packages/79/97/dde9d18c5530e45ed87dbd066ba3f137a4939180eace18a0373a43e6f8b7/socialshares-1.1.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "ecd255c660015cb9cd59a232d3bad7b1", "sha256": "bcf9f6e3b1a663f6edae6d6eaaef7f0595680c7f9872b7631fb0927e23edda03" }, "downloads": -1, "filename": "socialshares-1.1.0.tar.gz", "has_sig": false, "md5_digest": "ecd255c660015cb9cd59a232d3bad7b1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7144, "upload_time": "2016-09-14T11:01:56", "url": "https://files.pythonhosted.org/packages/79/97/dde9d18c5530e45ed87dbd066ba3f137a4939180eace18a0373a43e6f8b7/socialshares-1.1.0.tar.gz" } ] }