{ "info": { "author": "Champe Barton (@Mchampebartona)", "author_email": "champebarton@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.2", "Programming Language :: Python :: 3.3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Topic :: Internet :: WWW/HTTP :: Dynamic Content :: News/Diary", "Topic :: Office/Business :: News/Diary", "Topic :: Software Development :: Libraries :: Python Modules" ], "description": "NYTimesArticleAPI\n=================\n\n``NYTimesArticleAPI`` is a fully-functional Python wrapper for the `New\nYork Times Article Search\nAPI `__.\n\nInstallation\n------------\n\nWith pip:\n\n::\n\n $ pip install NYTimesArticleAPI\n\nDependencies\n------------\n\nNYTimesArticleAPI requires the\n```requests`` `__ and\n```setuptools`` `__ packages.\n\nUsage\n-----\n\nSimply import and initialize the API with your developer key:\n\n.. code:: python\n\n >>> from NYTimesArticleAPI import articleAPI\n >>> api = articleAPI(\"YourAPIKey\")\n\nThen call the ``search`` function with your desired search\nparameters/values:\n\n.. code:: python\n\n >>> articles = api.search(q=\"Obama\", \n fq={\"headline\": \"Obama\", \n \"source\": [\"Reuters\", \n \"AP\", \n \"The New York Times\"]}, \n begin_date=\"20161023\", # this can also be an int\n facet_field=[\"source\", \"day_of_week\"], \n facet_filter=True)\n\nThe search function returns a Python dictionary of the search results.\n\nYou can specify multiple filters by using a dictionary::\n\n.. code:: python\n\n >>> fq = {\"headline\": \"Obama\", \"source\": [\"Reuters\", \"AP\", \"The New York Times\"]}\n\nAnd multiple values by using a list::\n\n.. code:: python\n\n >>> facet_field = [\"source\", \"day_of_week\"]\n\nMore examples:\n\n.. code:: python\n\n >>> articles = api.search(q=\"Obama\")\n\n >>> articles = api.search(q=\"Obama\", begin_date=\"20111231\", page=2)\n\nFor a complete overview of the available search parameters, please refer\nto the `NYTimes Article Search API\nDocumentation `__.\n\nHistory\n-------\n\nThis package was originally written by `Evan\nSherlock `__ as\n```nytimesarticle`` `__.\nIt has since been forked and updated by `Matt\nMorrison `__, and subsequently released as\n```NyTimesArticleAPI`` `__,\nwith contributions from `Gerald Spencer `__\nand `Andrew Han `__.\n\nLicense\n-------\n\n\u00a9 2016 Matt Morrison mattdmo@pigimal.com.\n\nThis is free software. It is licensed under the `MIT\nLicense `__. Feel free to use this\nin your own work. However, if you modify and/or redistribute it, please\nattribute me in some way, and distribute your work under this or a\nsimilar license. A shout-out or a beer would be appreciated.", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/champebarton/NYTimesArticleAPI", "keywords": "nytimes new york times api article search nyt journalism news", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "NYTimesArticleAPInew", "package_url": "https://pypi.org/project/NYTimesArticleAPInew/", "platform": "", "project_url": "https://pypi.org/project/NYTimesArticleAPInew/", "project_urls": { "Homepage": "https://github.com/champebarton/NYTimesArticleAPI" }, "release_url": "https://pypi.org/project/NYTimesArticleAPInew/1.0.0/", "requires_dist": null, "requires_python": "", "summary": "Python wrapper for the New York Times Article Search API", "version": "1.0.0" }, "last_serial": 3304666, "releases": { "1.0.0": [ { "comment_text": "", "digests": { "md5": "43ea07f37d1208d50d0ad57990342af7", "sha256": "0fcf4f8151431bd3221bdebfdc7c70fb4caecf04b0fe9f04852927810f3a213c" }, "downloads": -1, "filename": "NYTimesArticleAPInew-1.0.0.tar.gz", "has_sig": false, "md5_digest": "43ea07f37d1208d50d0ad57990342af7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5649, "upload_time": "2017-11-04T02:02:17", "url": "https://files.pythonhosted.org/packages/df/f6/10db10a78a44f93107b780e4826a8c8f1532398ecd78955367c5fcfec629/NYTimesArticleAPInew-1.0.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "43ea07f37d1208d50d0ad57990342af7", "sha256": "0fcf4f8151431bd3221bdebfdc7c70fb4caecf04b0fe9f04852927810f3a213c" }, "downloads": -1, "filename": "NYTimesArticleAPInew-1.0.0.tar.gz", "has_sig": false, "md5_digest": "43ea07f37d1208d50d0ad57990342af7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5649, "upload_time": "2017-11-04T02:02:17", "url": "https://files.pythonhosted.org/packages/df/f6/10db10a78a44f93107b780e4826a8c8f1532398ecd78955367c5fcfec629/NYTimesArticleAPInew-1.0.0.tar.gz" } ] }