CINXE.COM

<!doctype html>     <html class="no-js" lang="en">  <head><script type="text/javascript" src="https://web-static.archive.org/_static/js/bundle-playback.js?v=7YQSqjSh" charset="utf-8"></script> <script type="text/javascript" src="https://web-static.archive.org/_static/js/wombat.js?v=txqj7nKC" charset="utf-8"></script> <script>window.RufflePlayer=window.RufflePlayer||{};window.RufflePlayer.config={"autoplay":"on","unmuteOverlay":"hidden"};</script> <script type="text/javascript" src="https://web-static.archive.org/_static/js/ruffle/ruffle.js"></script> <script type="text/javascript"> __wm.init("https://web.archive.org/web"); __wm.wombat("http://data.nasa.gov:80/api-info/","20120419053305","https://web.archive.org/","web","https://web-static.archive.org/_static/", "1334813585"); </script> <link rel="stylesheet" type="text/css" href="https://web-static.archive.org/_static/css/banner-styles.css?v=p7PEIJWi" /> <link rel="stylesheet" type="text/css" href="https://web-static.archive.org/_static/css/iconochive.css?v=3PDvdIFv" />  <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="chrome=1"> <title>API | data.nasa.gov</title> <meta name="description" content="The Open Data project is part of the NASA Open Government Initiative, and is intended to improve access to NASA data. This data catalog is a continually-growing listing of publicly available NASA datasets."> <meta name="author" content="Sean Herron"> <meta name="viewport" content="width=device-width, initial-scale=1.0">  <meta http-equiv="imagetoolbar" content="false"/>  <meta property="og:title" content="data.nasa.gov"/> <meta property="og:description" content="The Open Data project is part of the NASA Open Government Initiative, and is intended to improve access to NASA data. This data catalog is a continually-growing listing of publicly available NASA datasets."/> <link rel="stylesheet" href="/web/20120419053305cs_/http://data.nasa.gov/wp-content/themes/data.nasa.gov/css/style.css"> <link rel="alternate" type="application/rss+xml" title="data.nasa.gov Feed" href="https://web.archive.org/web/20120419053305/http://data.nasa.gov/feed/"> <script src="/web/20120419053305js_/http://data.nasa.gov/wp-content/themes/data.nasa.gov/js/libs/modernizr-2.0.min.js"></script> <script src="/web/20120419053305js_/http://data.nasa.gov/wp-content/themes/data.nasa.gov/js/libs/respond.min.js"></script> <script src="//web.archive.org/web/20120419053305js_/http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js"></script> <script>window.jQuery || document.write('<script src="/wp-content/themes/data.nasa.gov/js/libs/jquery-1.6.2.min.js"><\/script>')</script> <link rel="stylesheet" id="contact-form-7-css" href="https://web.archive.org/web/20120419053305cs_/http://data.nasa.gov/wp-content/plugins/contact-form-7/styles.css?ver=2.4.5" type="text/css" media="all"/> <script type="text/javascript" src="https://web.archive.org/web/20120419053305js_/http://open.nasa.gov/data/wp-content/plugins/infinite-scroll/js/jquery-1.6.2.min.js?ver=1.6.2"></script> <script type="text/javascript"> //<![CDATA[ var _wpcf7 = { cached: 1 }; //]]> </script>  <link rel="canonical" href="https://web.archive.org/web/20120419053305/http://data.nasa.gov/api-info/"> <script src="/web/20120419053305js_/http://data.nasa.gov/wp-content/themes/data.nasa.gov/js/scripts.js"></script> <link rel="stylesheet" id="Ubuntu-css" href="https://web.archive.org/web/20120419053305cs_/http://fonts.googleapis.com/css?family=Ubuntu&ver=3.2.1" type="text/css" media="all"/> <link rel="shortcut icon" href="/web/20120419053305im_/http://data.nasa.gov/wp-content/themes/data.nasa.gov/favicon.ico"/> </head> <body class="page page-id-638 page-template-default api-info"> <div id="wrap" class="container" role="document"> <header id="banner" class="" role="banner"> <div class="container"> <a id="logo" href="https://web.archive.org/web/20120419053305/http://data.nasa.gov/" alt="data.nasa.gov"> <img src="/web/20120419053305im_/http://data.nasa.gov/wp-content/themes/data.nasa.gov/img/logo.png" alt="data.nasa.gov"/> </a> <a id="tagline" href="https://web.archive.org/web/20120419053305/http://open.nasa.gov/">an open.NASA project</a> <nav id="nav-main" role="navigation"> <ul id="menu-primary-navigation" class="menu"><li id="menu-item-408" class="menu-item menu-item-type-post_type menu-item-object-page menu-item-408"><a href="/web/20120419053305/http://data.nasa.gov/about/">About data.nasa.gov</a></li> <li id="menu-item-504" class="categories menu-item menu-item-type-custom menu-item-object-custom menu-item-504"><a href="#">Categories</a></li> <li id="menu-item-647" class="menu-item menu-item-type-post_type menu-item-object-page current-menu-item page_item page-item-638 current_page_item menu-item-647"><a href="/web/20120419053305/http://data.nasa.gov/api-info/">API</a></li> <li id="menu-item-425" class="share menu-item menu-item-type-post_type menu-item-object-page menu-item-425"><a href="/web/20120419053305/http://data.nasa.gov/share-your-data/">Share your Data</a></li> </ul> </nav> <div id="searchbox"><form role="search" method="get" id="searchform" action="https://web.archive.org/web/20120419053305/http://data.nasa.gov/"> <label class="visuallyhidden" for="s">Search for:</label> <input type="text" value="" name="s" id="s" x-webkit-speech placeholder="What type of data are you looking for?"> <input type="submit" id="searchsubmit" value="Search" class="button"> </form></div> <div id="category-list"> <ul> <li><a href="https://web.archive.org/web/20120419053305/http://data.nasa.gov/category/aeronautics" style="background-color:#8AC0DE">Aeronautics</a></li><li><a href="https://web.archive.org/web/20120419053305/http://data.nasa.gov/category/catalog" style="background-color:#8485FF">Catalog</a></li><li><a href="https://web.archive.org/web/20120419053305/http://data.nasa.gov/category/climate" style="background-color:#4C1A23">Climate</a></li><li><a href="https://web.archive.org/web/20120419053305/http://data.nasa.gov/category/earth-science" style="background-color:#849972">Earth Science</a></li><li><a href="https://web.archive.org/web/20120419053305/http://data.nasa.gov/category/engineering" style="background-color:#302B2F">Engineering</a></li><li><a href="https://web.archive.org/web/20120419053305/http://data.nasa.gov/category/institutional" style="background-color:#DC282F">Institutional</a></li><li><a href="https://web.archive.org/web/20120419053305/http://data.nasa.gov/category/life-science" style="background-color:#6B1705">Life Science</a></li><li><a href="https://web.archive.org/web/20120419053305/http://data.nasa.gov/category/operations" style="background-color:#FF4F00">Operations</a></li><li><a href="https://web.archive.org/web/20120419053305/http://data.nasa.gov/category/space-science" style="background-color:#112959">Space Science</a></li></ul></div> </div> </header> <div id="content" class=""> <div id="main" class="" role="main"> <div class="container"> <div id="post-638" class="post-638 page type-page status-publish hentry clearfix article single page"> <header> <h2><a href="/web/20120419053305/http://data.nasa.gov/api-info/">API </a> </h2> </header> <div class="entry-content"> <p>All API access is over http and starts with:</p> <p><code>http://data.nasa.gov/api/</code></p> <p>The standard response format is JSON. Here’s an example of what a request for the <a href="https://web.archive.org/web/20120419053305/http://data.nasa.gov/great-images-in-nasa" title="Great Images in NASA">Great Images in NASA</a> dataset would look like:</p> <p><code>{<br/> "status": "ok",<br/> "post": {<br/> "id": 619,<br/> "slug": "great-images-in-nasa",<br/> "url": "http:\/\/data.nasa.gov\/great-images-in-nasa\/",<br/> "title": "Great Images in NASA",<br/> "title_plain": "Great Images in NASA",<br/> "content": " <p>GRIN is a collection of over a thousand images of significant historical interest scanned at high-resolution in several sizes. This collection is intended for the media, publishers, and the general public looking for high-quality photographs.<\/p>\n",<br/> "excerpt": "GRIN is a collection of over a thousand images of significant historical interest scanned at high-resolution in several sizes. This collection is intended for the media, publishers, and the general public looking for high-quality photographs.",<br/> "date": "2011-09-19 06:26:13",<br/> "modified": "2011-09-19 06:26:13",<br/> "categories": [<br/> {<br/> "id": 322,<br/> "slug": "catalog",<br/> "title": "Catalog",<br/> "description": "#8485FF",<br/> "parent": 0,<br/> "post_count": 9<br/> },<br/> {<br/> "id": 177,<br/> "slug": "institutional",<br/> "title": "Institutional",<br/> "description": "#DC282F",<br/> "parent": 0,<br/> "post_count": 6<br/> },<br/> {<br/> "id": 176,<br/> "slug": "operations",<br/> "title": "Operations",<br/> "description": "#FF4F00",<br/> "parent": 0,<br/> "post_count": 4<br/> }<br/> ],<br/> "tags": [<br/> {<br/> "id": 186,<br/> "slug": "apollo",<br/> "title": "Apollo",<br/> "description": "",<br/> "post_count": 10<br/> },<br/> {<br/> "id": 408,<br/> "slug": "gemini",<br/> "title": "gemini",<br/> "description": "",<br/> "post_count": 1<br/> },<br/> {<br/> "id": 404,<br/> "slug": "grin",<br/> "title": "grin",<br/> "description": "",<br/> "post_count": 1<br/> },<br/> {<br/> "id": 406,<br/> "slug": "history",<br/> "title": "history",<br/> "description": "",<br/> "post_count": 1<br/> },<br/> {<br/> "id": 377,<br/> "slug": "mercury",<br/> "title": "mercury",<br/> "description": "",<br/> "post_count": 5<br/> },<br/> {<br/> "id": 407,<br/> "slug": "nasa",<br/> "title": "nasa",<br/> "description": "",<br/> "post_count": 1<br/> },<br/> {<br/> "id": 405,<br/> "slug": "photography",<br/> "title": "photography",<br/> "description": "",<br/> "post_count": 1<br/> }<br/> ],<br/> "custom_fields": {<br/> "acronym": [<br/> "GRIN"<br/> ],<br/> "more_info_link": [<br/> "http:\/\/grin.hq.nasa.gov\/"<br/> ],<br/> "datagov_id": [<br/> ""<br/> ],<br/> "curator_person_name": [<br/> "Steve Garber"<br/> ],<br/> "curator_person_email": [<br/> ""<br/> ],<br/> "curator_url": [<br/> "http:\/\/history.nasa.gov\/"<br/> ],<br/> "curator_center": [<br/> "NASA Headquarters"<br/> ],<br/> "curator_org_name": [<br/> "NASA History Office"<br/> ]<br/> }<br/> },<br/> "previous_url": "http:\/\/data.nasa.gov\/precipitation-measurement-missions-data-access\/",<br/> "next_url": "http:\/\/data.nasa.gov\/nasa-earth-exchange\/"<br/> }</code></p> <h1>Functions</h1> <p>There are 10 different functions available through the API:</p> <p><strong><a href="#get_recent_datasets">get_recent_datasets</a></strong><br/> <strong><a href="#get_dataset">get_dataset</a></strong><br/> <strong><a href="#get_date_datasets">get_date_datasets </a></strong><br/> <strong><a href="#get_category_datasets">get_category_datasets</a></strong><br/> <strong><a href="#get_tag_datasets">get_tag_datasets</a></strong><br/> <strong><a href="#get_search_results">get_search_results</a></strong><br/> <strong><a href="#get_date_index">get_date_index</a></strong><br/> <strong><a href="#get_category_index">get_category_index</a></strong><br/> <strong><a href="#get_tag_index">get_tag_index</a></strong></p> <div id="get_recent_datasets"> <h2>get_recent_datasets</h2> <p> Provides a list of the ten (by default) most recent datasets posted to the site.</p> <p> <b>Required Arguments</b><br/> None</p> <p> <b>Option Arguments</b><br/> <code>count</code> – defines how many datasets to return (default is 10)</p> <p> <b>Example</b><br/> Return the 15 most recent datasets<br/> <code>http://data.nasa.gov/api/get_recent_datasets?count=15</code> </div> <div id="get_dataset"> <h2>get_dataset</h2> <p> Returns a single dataset</p> <p> <b>Required Arguments</b><br/> One of the following is required:<br/> <code>id</code> – set to the dataset’s ID<br/> <code>slug</code> – set to the dataset’s slug</p> <p> <b>Option Arguments</b><br/> none</p> <p> <b>Example</b><br/> Returns the dataset with the ID <a href="https://web.archive.org/web/20120419053305/http://data.nasa.gov/great-images-in-nasa/">619</a><br/> <code>http://data.nasa.gov/api/get_dataset?id=619</code></p> <p> Returns the dataset with the slug <a href="https://web.archive.org/web/20120419053305/http://data.nasa.gov/great-images-in-nasa/">great-images-in-nasa</a><br/> <code>http://data.nasa.gov/api/get_dataset?slug=great-images-in-nasa</code> </div> <div id="get_date_datasets"> <h2>get_date_datasets</h2> <p> Returns an array of datasets in a specific date archive (by day, month, or year).</p> <p> <b>Required Arguments</b><br/> <code>data</code> – set to a date in the format YYYY or YYYY-MM or YYYY-MM-DD (non-numeric characters are stripped from the var, so YYYYMMDD or YYYY/MM/DD are also valid)</p> <p> <b>Option Arguments</b><br/> <code>count</code> – defines how many datasets to return (default is 10)</p> <p> <b>Example</b><br/> Return all datasets added in October 2011<br/> <code>http://data.nasa.gov/api/get_date_datasets/?date=2011-10</code> </div> <div id="get_category_datasets"> <h2>get_category_datasets</h2> <p> Returns an array of datasets in a specific category.</p> <p> <b>Required Arguments</b><br/> One of the following is required:<br/> <code>id</code> – set to the category’s ID<br/> <code>slug</code> – set to the category’s slug</p> <p> <b>Option Arguments</b><br/> <code>count</code> – defines how many datasets to return (default is 10)</p> <p> <b>Example</b><br/> Return all datasets in the “Earth Science” category<br/> <code>http://data.nasa.gov/api/get_category_datasets/?slug=earth-science</code> </div> <div id="get_tag_datasets"> <h2>get_tag_datasets</h2> <p> Returns an array of datasets with a specific tag.</p> <p> <b>Required Arguments</b><br/> One of the following is required:<br/> <code>id</code> – set to the tag’s ID<br/> <code>slug</code> – set to the tag’s slug</p> <p> <b>Option Arguments</b><br/> <code>count</code> – defines how many datasets to return (default is 10)</p> <p> <b>Example</b><br/> Return all datasets tagged with “apollo” and “imagery”<br/> <code>http://data.nasa.gov/api/get_tag_datasets/?slug=apollo&slug=imagery</code> </div> <div id="get_search_results"> <h2>get_search_results</h2> <p> Returns an array of datasets in response to a search query.</p> <p> <b>Required Arguments</b><br/> <code>search</code> – set to the desired search query</p> <p> <b>Option Arguments</b><br/> <code>count</code> – defines how many datasets to return (default is 10)</p> <p> <b>Example</b><br/> Return results for “carbon cycle”<br/> <code>http://data.nasa.gov/api/get_search_results/?search=carbon+cycle</code> </div> <div id="get_date_index"> <h2>get_date_index</h2> <p> Returns both an array of date permalinks and a tree structure representation of the archive.</p> <p> <b>Required Arguments</b><br/> None</p> <p> <b>Option Arguments</b><br/> None</p> <p> <b>Example</b><br/> Return date permalinks and tree structure<br/> <code>http://data.nasa.gov/api/get_date_index/</code> </div> <div id="get_category_index"> <h2>get_category_index</h2> <p> Returns an array of active categories.</p> <p> <b>Required Arguments</b><br/> None</p> <p> <b>Option Arguments</b><br/> None</p> <p> <b>Example</b><br/> Return array of categories<br/> <code>http://data.nasa.gov/api/get_category_index/</code> </div> <div id="get_tag_index"> <h2>get_recent_datasets</h2> <p> Returns an array of active tags.</p> <p> <b>Required Arguments</b><br/> None</p> <p> <b>Option Arguments</b><br/> none</p> <p> <b>Example</b><br/> Return array of tags<br/> <code>http://data.nasa.gov/api/get_tag_index/</code> </div> <h1 id="usage">Additional Usage</h1> <p>By adding <code>dev=1</code> to a request, you can view it in a structured, easy-to-read mode.</p> <p>Special thanks to the creators of the <a href="https://web.archive.org/web/20120419053305/http://wordpress.org/extend/plugins/json-api/">JSON-API WordPress Plugin</a>, off which our data API was created.</p> </div> <footer> </footer> </div> </div> </div> </div> <aside id="sidebar" class="" role="complementary"> <div class="container"> </div> </aside> </div> <footer id="content-info" class="" role="contentinfo"> <div class="container"> <p class="copy"><small> <img src="/web/20120419053305im_/http://data.nasa.gov/wp-content/themes/data.nasa.gov/img/meatball.png" width="60px" height="51px" alt="data.nasa.gov"> Page Editor: <a href="https://web.archive.org/web/20120419053305/mailto:Sean Herron">Sean Herron</a><br/> NASA Official: <a href="https://web.archive.org/web/20120419053305/mailto:Sean Herron">Nick Skytland</a><br/> Last Updated: 22 December 2011<br/> <a href="https://web.archive.org/web/20120419053305/http://www.nasa.gov/about/highlights/HP_Privacy.html">Privacy Policy and Important Notices</a><br/> <a href="https://web.archive.org/web/20120419053305/http://open.nasa.gov/credits">Website Credits</a></small></p> <a href="https://web.archive.org/web/20120419053305/http://www.nasa.gov/open" class="nasaopenlink">A NASA Open Government Initiative Website</a> </div> </footer> </div> <script type="text/javascript" src="https://web.archive.org/web/20120419053305js_/http://open.nasa.gov/data/wp-content/plugins/contact-form-7/jquery.form.js?ver=2.52"></script> <script type="text/javascript" src="https://web.archive.org/web/20120419053305js_/http://open.nasa.gov/data/wp-content/plugins/contact-form-7/scripts.js?ver=2.4.5"></script>  <script type="text/javascript">var switchTo5x=false;</script><script type="text/javascript" src="https://web.archive.org/web/20120419053305js_/http://w.sharethis.com/button/buttons.js"></script><script type="text/javascript">stLight.options({publisher:'98f231d9-cc4f-4340-a25e-fb3d830c81ce'});</script>  <script type="text/javascript"> (function() { var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; po.src = 'https://web.archive.org/web/20120419053305/https://apis.google.com/js/plusone.js'; var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); })(); </script> </body> </html>