Python wrapper for the New York Times Article Search API
Project description
nytimesarticlev2 is a fully-functional Python wrapper for the New York Times Article Search API.
Installation
With pip:
$ pip install nytimesarticlev2
Dependencies
nytimesarticlev2 requires the `requests <https://pypi.python.org/pypi/requests>`__ and `setuptools <https://pypi.python.org/pypi/setuptools>`__ packages.
Usage
Simply import and initialize the API with your developer key:
>>> from nytimesarticlev2 import articleAPI
>>> api = articleAPI("YourAPIKey")
Then call the search function with your desired search parameters/values:
>>> articles = api.search(q="Obama",
fq={"headline": "Obama",
"source": ["Reuters",
"AP",
"The New York Times"]},
begin_date="20161023", # this can also be an int
facet_field=["source", "day_of_week"],
facet_filter=True)
The search function returns a Python dictionary of the search results.
You can specify multiple filters by using a dictionary:
.. code:: python
>>> fq = {"headline": "Obama", "source": ["Reuters", "AP", "The New York Times"]}
And multiple values by using a list:
.. code:: python
>>> facet_field = ["source", "day_of_week"]
More examples:
>>> articles = api.search(q="Obama")
>>> articles = api.search(q="Obama", begin_date="20111231", page=2)
For a complete overview of the available search parameters, please refer to the NYTimes Article Search API Documentation.
History
This package was originally written by Evan Sherlock as `nytimesarticle <https://github.com/evansherlock/nytimesarticle>`__. It has since been forked and updated by Matt Morrison, and subsequently released as `NyTimesArticleAPI <https://pypi.python.org/pypi/nytimesarticlev2>`__, with contributions from Gerald Spencer and Andrew Han.
License
© 2016 Matt Morrison mattdmo@pigimal.com.
This is free software. It is licensed under the MIT License. Feel free to use this in your own work. However, if you modify and/or redistribute it, please attribute me in some way, and distribute your work under this or a similar license. A shout-out or a beer would be appreciated.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for nytimesarticlev2-1.1.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c9d42d4d5c871a8a27d837101683df2c279439730094929d4edfa5135b2618e2 |
|
MD5 | bc1a6211605918c3a94ddd4b6463d906 |
|
BLAKE2b-256 | 06618ad5d3f00c542ba09cb4ea3dea21a26e0a8a93de2ddff73b3c2227cbb739 |