Please wait...

Subscription Plan

NASA

By: Qymera


Help everyone achieve their dreams to be a scientist! Our NASA API provides updated data about National Aeronautics and Space Administration (NASA)’s projects, interstellar images, discoveries and anything about the universe.


Overview

  • Access NASA data using NASA APIs Astronomy Picture of the Day, Near Earth Objects, and Space Weather (Database Of Notifications, Knowledge, Information).
  • Data is available in JSON, XML, or HTML format
Using the API

We built the API documentation to be as self-documenting as possible, but if you find yourself overwhelmed, we organized this site into these major areas:

  • Getting Started - introduces you to the operations offered by the API.
  • API Calls - gives you a hands-on experience of those operations with an interactive console.
  • Parameters List - can be found inside each API. It lists and describes the type of information needed by the API.
  • Comments - get in touch by leaving a comment. We appreciate any feedback, too.

Getting Started

The current version of the API lives at https://gateway.qymera.tech/qymera/sb/nasa/v1/.

  • https://gateway.qymera.tech/qymera/sb/nasa/v1/apod

  • https://gateway.qymera.tech/qymera/sb/nasa/v1/apod?date=019-10-01

  • https://gateway.qymera.tech/qymera/sb/nasa/v1/apod?date=019-10-01&hd=true

  • https://gateway.qymera.tech/qymera/sb/nasa/v1/neows

  • https://gateway.qymera.tech/qymera/sb/nasa/v1/neows?start_date=2019-10-01

  • https://gateway.qymera.tech/qymera/sb/nasa/v1/neows?start_date=2019-10-01&end_date=2019-10-09

  • https://gateway.qymera.tech/qymera/sb/nasa/v1/cme

  • https://gateway.qymera.tech/qymera/sb/nasa/v1/cme?startDate=2019-10-01

  • https://gateway.qymera.tech/qymera/sb/nasa/v1/cme?startDate=2019-10-01&endDate=2019-10-09

  • https://gateway.qymera.tech/qymera/sb/nasa/v1/gst

  • https://gateway.qymera.tech/qymera/sb/nasa/v1/gst?startDate=2019-10-01

  • https://gateway.qymera.tech/qymera/sb/nasa/v1/gst?startDate=2019-10-01&endDate=2019-10-09

  • https://gateway.qymera.tech/qymera/sb/nasa/v1/flr

  • https://gateway.qymera.tech/qymera/sb/nasa/v1/flr?startDate=2019-10-01

  • https://gateway.qymera.tech/qymera/sb/nasa/v1/flr?startDate=2019-10-01&endDate=2019-10-09

  • https://gateway.qymera.tech/qymera/sb/nasa/v1/sep

  • https://gateway.qymera.tech/qymera/sb/nasa/v1/sep?startDate=2019-10-01

  • https://gateway.qymera.tech/qymera/sb/nasa/v1/sep?startDate=2019-10-01&endDate=2019-10-09

  • https://gateway.qymera.tech/qymera/sb/nasa/v1/mpc

  • https://gateway.qymera.tech/qymera/sb/nasa/v1/mpc?startDate=2019-10-01

  • https://gateway.qymera.tech/qymera/sb/nasa/v1/mpc?startDate=2019-10-01&endDate=2019-10-09

  • https://gateway.qymera.tech/qymera/sb/nasa/v1/rbe

  • https://gateway.qymera.tech/qymera/sb/nasa/v1/rbe?startDate=2019-10-01

  • https://gateway.qymera.tech/qymera/sb/nasa/v1/rbe?startDate=2019-10-01&endDate=2019-10-09

  • https://gateway.qymera.tech/qymera/sb/nasa/v1/hss

  • https://gateway.qymera.tech/qymera/sb/nasa/v1/hss?startDate=2019-10-01

  • https://gateway.qymera.tech/qymera/sb/nasa/v1/hss?startDate=2019-10-01&endDate=2019-10-09

Endpoints
Endpoint What it does
/apod Gets the Astronomy Picture of the Day imagery and associated metadata.
/neows Gets the information for near-Earth asteroids.
/cme Gets the information for Coronal Mass Ejections.
/gst Gets the information for Geomagnetic Storms.
/flr Gets the information for Solar Flares.
/sep Gets the information for Solar Energetic Particles.
/mpc Gets the information for Magnetopause Crossings.
/rbe Gets the information for Radiation Belt Enhancements.
/hss Gets the information for High Speed Streams (Solar Winds).

API Calls

Headers
Key Value Description
accept application/json
x-ibm-client-id Use the given application credential id
x-ibm-client-secret Use the given application credential secret
/apod
Implementation Notes

Gets the Astronomy Picture of the Day imagery and associated metadata. An optional return parameter copyright is returned if the image is not public domain.

Parameters
Parameter Data Type Necessity Location Description
date YYYY-MM-DD not required query The date of the APOD image to retrieve. Default: Current EST date
hd bool not required query Option to retrieve the URL for the high resolution image Default: False
Sample Request
curl --request GET \apod
  --url 'https://gateway.qymera.tech/qymera/sb/nasa/v1/apod?date=YYYY-MM-DD&hd=bool'
  --header 'accept: application/json' \
  --header 'x-ibm-client-id: REPLACE_THIS_VALUE' \
  --header 'x-ibm-client-secret: REPLACE_THIS_VALUE'
Request

GET

https://gateway.qymera.tech/qymera/sb/nasa/v1/apod?date=YYYY-MM-DD&hd=BOOL

Response

200

{
   "date":"YYYY-MM-DD",
   "explanation":"Sample text.",
   "hdurl":"https://SAMPLE-HD-IMAGE-LINK.jpg",
   "media_type":"image",
   "service_version":"v1",
   "title":"Sample Title",
   "url":"https://SAMPLE-IMAGE-LINK.jpg"
}

500

{
   "code":500,
   "msg":"Internal Service Error",
   "service_version":"v1"
}
/neows
Implementation Notes

NeoWs (Near Earth Object Web Service) is a RESTful web service for near earth Asteroid information. Search for Asteroids based on their closest approach date to Earth. Retrieves only up to 7 days with no start and end dates specified.

Parameters
Parameter Data Type Necessity Location Description
start_date YYYY-MM-DD not required query Starting Date. Default: Current EST date
end_date YYYY-MM-DD not required query Ending date. Must be after start_date. Default: 7 days after start_date
Sample Request
curl --request GET \
  --url 'https://gateway.qymera.tech/qymera/sb/nasa/v1/neows?start_date=START-DATE&end_date=END-DATE' \
  --header 'accept: application/json' \
  --header 'x-ibm-client-id: REPLACE_THIS_VALUE' \
  --header 'x-ibm-client-secret: REPLACE_THIS_VALUE'
Request

GET

https://gateway.qymera.tech/qymera/sb/nasa/v1/neows?start_date=2018-08-04&end_date=2018-08-05

Response

200

{
   "message":"Success.",
   "data":{
      "element_count":3,
      "near_earth_objects":{
         "2018-08-04":[
            {
               "id":"3837951",
               "neo_reference_id":"3837951",
               "name":"(2019 AP14)",
               "nasa_jpl_url":"http://ssd.jpl.nasa.gov/sbdb.cgi?sstr=3837951",
               "absolute_magnitude_h":22.662,
               "estimated_diameter":{
                  "kilometers":{
                     "estimated_diameter_min":0.078010844,
                     "estimated_diameter_max":0.1744375502
                  },
                  "meters":{
                     "estimated_diameter_min":78.0108440079,
                     "estimated_diameter_max":174.4375501839
                  },
                  "miles":{
                     "estimated_diameter_min":0.0484736762,
                     "estimated_diameter_max":0.108390435
                  },
                  "feet":{
                     "estimated_diameter_min":255.941097455,
                     "estimated_diameter_max":572.3016921452
                  }
               },
               "is_potentially_hazardous_asteroid":false,
               "close_approach_data":[
                  {
                     "close_approach_date":"2018-08-04",
                     "close_approach_date_full":"2018-Aug-04 18:36",
                     "epoch_date_close_approach":1533407760000,
                     "relative_velocity":{
                        "kilometers_per_second":"11.4777826714",
                        "kilometers_per_hour":"41320.0176170958",
                        "miles_per_hour":"25674.6520576893"
                     },
                     "miss_distance":{
                        "astronomical":"0.2999723163",
                        "lunar":"116.6892310407",
                        "kilometers":"44875219.577446281",
                        "miles":"27884168.4393534378"
                     },
                     "orbiting_body":"Earth"
                  }
               ],
               "is_sentry_object":false
            },
            {
              //2nd NEO
            },
            {
              //3rd NEO
            }
         ]
      }
   }
}

404

{
  "code":-8,
  "message":"Endpoint not found."
}
/cme
Implementation Notes

Gets the information for Coronal Mass Ejections.

Parameters
Parameter Data Type Necessity Location Description
startDate YYYY-MM-DD not required query Starting Date. Must be before endDate. Default: 30 days prior to current UTC date
endDate YYYY-MM-DD not required query Ending Date. Default: Current UTC date
Sample Request
curl --request GET \cme
  --url 'https://gateway.qymera.tech/qymera/sb/nasa/v1/cme?startDate=YYYY-MM-dd&endDate=YYYY-MM-dd' \
  --header 'accept: application/json' \
  --header 'x-ibm-client-id: REPLACE_THIS_VALUE' \
  --header 'x-ibm-client-secret: REPLACE_THIS_VALUE'
Request

GET

https://gateway.qymera.tech/qymera/sb/nasa/v1/cme?startDate=2019-09-15&endDate=2019-09-25

Response

200

{
   "message":"Success.",
   "data":[
      {
         "activityID":"2019-09-19T23:54:00-CME-001",
         "startTime":"2019-09-19T23:54Z",
         "sourceLocation":"S30W05",
         "activeRegionNum":null,
         "instruments":[
            {
               "id":5,
               "displayName":"STEREO A: SECCHI/COR2"
            }
         ],
         "cmeAnalyses":[
            {
               "time21_5":"2019-09-19T23:54Z",
               "latitude":-4,
               "longitude":1,
               "halfAngle":6,
               "speed":366,
               "type":"S",
               "isMostAccurate":true,
               "note":"",
               "levelOfData":0,
               "enlilList":[
                  {
                     "modelCompletionTime":"2019-09-20T11:36Z",
                     "au":2,
                     "estimatedShockArrivalTime":null,
                     "estimatedDuration":null,
                     "rmin_re":null,
                     "kp_18":null,
                     "kp_90":null,
                     "kp_135":null,
                     "kp_180":null,
                     "isEarthGB":false,
                     "impactList":null,
                     "cmeIDs":[
                        "2019-09-19T23:54:00-CME-001"
                     ]
                  }
               ]
            }
         ],
         "linkedEvents":null,
         "note":"The source is a filament eruption above the CH in SDO AIA 304 (around S30W05) at around 2019-09-19T22:48Z.",
         "catalog":"SWRC_CATALOG"
      }
   ]
}

404

{
  "code":-8,
  "message":"Endpoint not found."
}
/gst
Implementation Notes

Gets the information for Geomagnetic Storms (Solar storm).

Parameters
Parameter Data Type Necessity Location Description
startDate YYYY-MM-DD not required query Starting Date. Must be before endDate. Default: 30 days prior to current UTC date
endDate YYYY-MM-DD not required query Ending Date. Default: Current UTC date
Sample Request
curl --request GET \gst
  --url 'https://gateway.qymera.tech/qymera/sb/nasa/v1/gst?startDate=YYYY-MM-dd&endDate=YYYY-MM-dd' \
  --header 'accept: application/json' \
  --header 'x-ibm-client-id: REPLACE_THIS_VALUE' \
  --header 'x-ibm-client-secret: REPLACE_THIS_VALUE'
Request

GET

https://gateway.qymera.tech/qymera/sb/nasa/v1/gst?startDate=2016-01-15&endDate=2016-01-25

Response

200

{
   "message":"Success.",
   "data":[
      {
         "gstID":"2016-01-21T03:00:00-GST-001",
         "startTime":"2016-01-21T03:00Z",
         "allKpIndex":[
            {
               "observedTime":"2016-01-21T06:00Z",
               "kpIndex":6,
               "source":"NOAA"
            }
         ],
         "linkedEvents":[
            {
               "activityID":"2016-01-15T00:00:00-CME-001"
            },
            {
               "activityID":"2016-01-21T10:00:00-HSS-001"
            }
         ]
      }
   ]
}

404

{
  "code":-8,
  "message":"Endpoint not found."
}
/flr
Implementation Notes

Gets the information for Solar Flares.

Parameters
Parameter Data Type Necessity Location Description
startDate YYYY-MM-DD required query Starting Date. Must be before endDate. Default: 30 days prior to current UTC date
endDate YYYY-MM-DD not required query Ending Date. Default: Current UTC date
Sample Request
curl --request GET \flr
  --url 'https://gateway.qymera.tech/qymera/sb/nasa/v1/flr?startDate=YYYY-MM-dd&endDate=YYYY-MM-dd' \
  --header 'accept: application/json' \
  --header 'x-ibm-client-id: REPLACE_THIS_VALUE' \
  --header 'x-ibm-client-secret: REPLACE_THIS_VALUE'
Request

GET

https://gateway.qymera.tech/qymera/sb/nasa/v1/flr?startDate=2016-01-01&endDate=2016-01-30

Response

200

{
   "message":"Success.",
   "data":[
      {
         "flrID":"2019-05-06T05:04:00-FLR-001",
         "instruments":[
            {
               "id":11,
               "displayName":"GOES15: SEM/XRS 1.0-8.0"
            }
         ],
         "beginTime":"2019-05-06T05:04Z",
         "peakTime":"2019-05-06T05:10Z",
         "endTime":null,
         "classType":"C9.9",
         "sourceLocation":"N08E50",
         "activeRegionNum":12740,
         "linkedEvents":null
      }
   ]
}

404

{
  "code":-8,
  "message":"Endpoint not found."
}
/sep
Implementation Notes

Gets the information for Solar Energetic Particles.

Parameters
Parameter Data Type Necessity Location Description
startDate YYYY-MM-DD not required query Starting Date. Must be before endDate. Default: 30 days prior to current UTC date
endDate YYYY-MM-DD not required query Ending Date. Default: Current UTC date
Sample Request
curl --request GET \sep
  --url 'https://gateway.qymera.tech/qymera/sb/nasa/v1/sep?startDate=YYYY-MM-dd&endDate=YYYY-MM-dd' \
  --header 'accept: application/json' \
  --header 'x-ibm-client-id: REPLACE_THIS_VALUE' \
  --header 'x-ibm-client-secret: REPLACE_THIS_VALUE'
Request

GET

https://gateway.qymera.tech/qymera/sb/nasa/v1/sep?startDate=2016-01-01&endDate=2016-01-30

Response

200

{
   "message":"Success.",
   "data":[
      {
         "sepID":"2016-01-02T02:48:00-SEP-001",
         "eventTime":"2016-01-02T02:48Z",
         "instruments":[
            {
               "id":3,
               "displayName":"SOHO: COSTEP 15.8-39.8 MeV"
            }
         ],
         "linkedEvents":[
            {
               "activityID":"2016-01-01T23:00:00-FLR-001"
            },
            {
               "activityID":"2016-01-01T23:12:00-CME-001"
            }
         ]
      },
      {
         "sepID":"2016-01-02T04:30:00-SEP-001",
         "eventTime":"2016-01-02T04:30Z",
         "instruments":[
            {
               "id":13,
               "displayName":"GOES13: SEM/EPS >10 MeV"
            }
         ],
         "linkedEvents":[
            {
               "activityID":"2016-01-01T23:00:00-FLR-001"
            },
            {
               "activityID":"2016-01-01T23:12:00-CME-001"
            }
         ]
      }
   ]
}

404

{
  "code":-8,
  "message":"Endpoint not found."
}
/mpc
Implementation Notes

Gets the information for Magnetopause Crossings.

Parameters
Parameter Data Type Necessity Location Description
startDate YYYY-MM-DD not required query Starting Date. Must be before endDate. Default: 30 days prior to current UTC date
endDate YYYY-MM-DD not required query Ending Date. Default: Current UTC date
Sample Request
curl --request GET \mpc
  --url 'https://gateway.qymera.tech/qymera/sb/nasa/v1/mpc?startDate=YYYY-MM-dd&endDate=YYYY-MM-dd' \
  --header 'accept: application/json' \
  --header 'x-ibm-client-id: REPLACE_THIS_VALUE' \
  --header 'x-ibm-client-secret: REPLACE_THIS_VALUE'
Request

GET

https://gateway.qymera.tech/qymera/sb/nasa/v1/mpc?startDate=2018-05-01&endDate=2018-06-03

Response

200

{
   "message":"Success.",
   "data":[
      {
         "mpcID":"2018-05-05T14:33:00-MPC-001",
         "eventTime":"2018-05-05T14:33Z",
         "instruments":[
            {
               "id":15,
               "displayName":"MODEL: SWMF"
            }
         ],
         "linkedEvents":[
            {
               "activityID":"2018-05-05T09:27:00-HSS-001"
            }
         ]
      }
   ]
}

404

{
  "code":-8,
  "message":"Endpoint not found."
}
/rbe
Implementation Notes

Gets the information for Radiation Belt Enhancements.

Parameters
Parameter Data Type Necessity Location Description
startDate YYYY-MM-DD not required query Starting Date. Must be before endDate. Default: 30 days prior to current UTC date
endDate YYYY-MM-DD not required query Ending Date. Default: Current UTC date
Sample Request
curl --request GET \rbe
  --url 'https://gateway.qymera.tech/qymera/sb/nasa/v1/rbe?startDate=YYYY-MM-dd&endDate=YYYY-MM-dd' \
  --header 'accept: application/json' \
  --header 'x-ibm-client-id: REPLACE_THIS_VALUE' \
  --header 'x-ibm-client-secret: REPLACE_THIS_VALUE'
Request

GET

https://gateway.qymera.tech/qymera/sb/nasa/v1/rbe?startDate=2018-05-01&endDate=2018-06-03

Response

200

{
   "message":"Success.",
   "data":[
      {
         "rbeID":"2019-09-28T14:25:00-RBE-001",
         "eventTime":"2019-09-28T14:25Z",
         "instruments":[
            {
               "id":14,
               "displayName":"GOES13: SEM/EPS >0.8 MeV"
            }
         ],
         "linkedEvents":[
            {
               "activityID":"2019-09-27T04:52:00-HSS-001"
            }
         ]
      }
   ]
}

404

{
  "code":-8,
  "message":"Endpoint not found."
}
/hss
Implementation Notes

Gets the information for High Speed Streams (Solar winds).

Parameters
Parameter Data Type Necessity Location Description
startDate YYYY-MM-DD not required query Starting Date. Must be before endDate. Default: 30 days prior to current UTC date
endDate YYYY-MM-DD not required query Ending Date. Default: current UTC date
Sample Request
curl --request GET \hss
  --url 'https://gateway.qymera.tech/qymera/sb/nasa/v1/hss?startDate=YYYY-MM-dd&endDate=YYYY-MM-dd' \
  --header 'accept: application/json' \
  --header 'x-ibm-client-id: REPLACE_THIS_VALUE' \
  --header 'x-ibm-client-secret: REPLACE_THIS_VALUE'
Request

GET

https://gateway.qymera.tech/qymera/sb/nasa/v1/hss?startDate=2019-10-01&endDate=2019-10-03

Response

200

{
   "message":"Success.",
   "data":[
      {
         "hssID":"2019-10-02T03:00:00-HSS-001",
         "eventTime":"2019-10-02T03:00Z",
         "instruments":[
            {
               "id":20,
               "displayName":"STEREO A: IMPACT"
            },
            {
               "id":21,
               "displayName":"STEREO A: PLASTIC"
            }
         ],
         "linkedEvents":null
      }
   ]
}

404

{
  "code":-8,
  "message":"Endpoint not found."
}