nasa provides a simple Python wrapper to interact with the NASA Data APIs. Full documentation for the APIs is available on NASA's site, and named parameters here are the same as there.

Installation

Install using pip:

pip install nasa-api-wrapper

If you'd like to contribute, feel free to run git clone on the Github repository:

git clone https://github.com/brendanv/nasa-api.git

Usage

Acquire an API key and set your API key as the NASA_API_KEY environment variable before using the API!

Supported APIs

Astronomy Picture of the Day

Receive images and metadata about NASA's current and past Astronomy Pictures of the Day. Just choose a date, and indicate if you'd like to receive the set of tags for the image along with your other data.

>>> from nasa import apod
>>> picture = apod.apod('2015-05-01')
>>> picture.url
'http://apod.nasa.gov/apod/image/1505/messengerImpactSite_black600.jpg'
>>> picture.title
"MESSENGER's Last Day on Mercury"

Earth Assets and Imagery

Fetch Landsat 8 images of any location on Earth! This consists of two distinct APIs: Assets that detail when a picture was taken of a given location, and the actual Imagery for that location and time.

You can use the Assets API to fetch images:

>>> from nasa import earth
>>> assets = earth.assets(lat=1.5, lon=100.75, begin='2014-02-01', end='2014-06-01')
>>> [(a.date, a.id) for a in assets]
[('2014-02-04T03:30:01', 'LC8_L1T_TOA/LC81270592014035LGN00'),
 ('2014-02-20T03:29:47', 'LC8_L1T_TOA/LC81270592014051LGN00'),
 ...
 ('2014-05-27T03:28:32', 'LC8_L1T_TOA/LC81270592014147LGN00')]

>>> image = assets[0].get_asset_image()
>>> image.id
'LC8_L1T_TOA/LC81270592014035LGN00"'
>>> image.image.__str__()
'<PIL.PngImagePlugin.PngImageFile image mode=RGB size=512x512>'

Or simply fetch the images directly:

>>> from nasa import earth 
>>> image = earth.image(lat=1.5, lon=100.75, date='2014-02-01')
>>> image.id
'LC8_L1T_TOA/LC81270592014035LGN00'

Patents

See what cool patents are held in the NASA patent portfolio using the Patents API.

>>> from nasa import patents
>>> patents = patents.patents(query='temperature', limit=5)
>>> [(p.id, p.category) for p in patents]
[('patent_MSC-24506-1', 'aeronautics'),
 ('patent_LEW-18761-1', 'materials and coatings'),
 ('patent_LEW-18561-1', 'materials and coatings'),
 ('patent_LEW-18949-1', 'materials and coatings'),
 ('patent_LAR-17681-1', 'materials and coatings')]

Sounds

Browse sounds released by NASA using the Sounds API.

>>> from nasa import sounds
>>> sounds = sounds.sounds(query='apollo')
>>> [(s.id, s.duration) for s in sounds]
[(181835738, 18365),
 (173578614, 30095),
 ...
 (172463116, 2429)]

MAAS

Browse reports from the Mars Atmospheric Aggregation System

Easily get the latest report:

>>> from nasa import maas
>>> report = maas.latest()
>>> report.min_temp_fahrenheit
-110.2

Or multiple reports that match a given query:

>>> from nasa import maas
>>> reports = maas.archived(terrestrial_date_start='2012-10-01', terrestrial_date_end='2012-10-31')
>>> reports['count']
508
>>> [r.sol for r in reports['results']]
[84, 83, 82, 81, 80, 79, 78, 77, 76, 75]

# Get the next page of results
>>> paginator = reports['next']
>>> next_page = paginator()
>>> [r.sol for r in next_page['results']]
[74, 73, 72, 71, 70, 68, 67, 66, 65, 64]

archived takes keyword args that allow you to filter by most report fields available on the MAASReport.