Skip to main content

Fully-functional Python wrapper for the New York Times Article Search API

Project description


nytimesarticle is a fully-functional Python wrapper for the New York Times Article Search API.


With pip::

$ pip install nytimesarticle

or easy_install::

$ easy_install nytimesarticle


nytimesarticle requires the `requests <>`_ package.


Simply import and initialize the API with your developer key::

$ from nytimesarticle import articleAPI
$ api = articleAPI('*Your Key*')

And call the 'search' function with your desired search parameters/values::

$ articles = q = 'Obama', fq = {'headline':'Obama', 'source':['Reuters','AP', 'The New York Times']}, begin_date = 20111231, facet_field = ['source','day_of_week'], facet_filter = True )

The search function returns a dictionary of the search results.

You can specify multiple filters by using a dictionary::
fq = {'headline':'Obama', 'source':['Reuters','AP', 'The New York Times']}

And multiple values by using a list::
facet_field = ['source','day_of_week']

More examples::

$ articles = q = 'Obama' )

$ articles = 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 <>`_.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for nytimesarticle, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size nytimesarticle-0.1.0.tar.gz (3.2 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page