Kepler Project API

Overview

Asterank offers a basic queryable database for NASA's Kepler Project. It is a simple way to quickly apply constraints to a set of over 2,000 exoplanets and unconfirmed "objects of interest." The database supports comparators and specific criteria for all attributes provided by the Kepler Data Explorer.

The database currently runs on mongodb and queries must adhere to mongo's json format for a 'find' operation. Information is refreshed nightly from the Kepler Data Explorer.

Format

Requests are of the form:

http://asterank.com/api/kepler?query={query}&limit={limit}

Response data formats:

KOIObject of Interest number
ASemi-major axis (AU)
RPLANETPlanetary radius (Earth radii)
RSTARStellar radius (Sol radii)
TSTAREffective temperature of host star as reported in KIC (k)
KMAGKepler magnitude (kmag)
TPLANETEquilibrium temperature of planet, per Borucki et al. (k)
T0Time of transit center (BJD-2454900)
UT0Uncertainty in time of transit center (+-jd)
UT0Uncertainty in time of transit center (+-jd)
PERPeriod (days)
UPERUncertainty in period (+-days)
DECDeclination (@J200)
RARight ascension (@J200)
MSTARDerived stellar mass (msol)

Sample Request

This request returns 10 Kepler Objects of Interest with estimated equilibrium temperatures between 290 and 320 Kelvin.

/api/kepler?query={"TPLANET":{"$lt":320,"$gt":290}}&limit=10

Results:

[
   {
      "KOI":371.01,
      "A":1.361,
      "DEC":40.8565,
      "RSTAR":2.58,
      "TSTAR":5215,
      "KMAG":12.193,
      "TPLANET":316,
      "T0":177.08027,
      "UT0":0.00297,
      "PER":498.3928192,
      "RA":19.97841,
      "UPER":0.0041914,
      "RPLANET":84.19,
      "MSTAR":1.33,
      "ROW":335
   },
   {
      "KOI":375.01,
      "A":0.729,
      "DEC":51.1443,
      "RSTAR":1.52,
      "TSTAR":5757,
      "KMAG":13.293,
      "TPLANET":300,
      "T0":172.22382,
      "UT0":0.00095,
      "PER":-600.0,
      "RA":19.41341,
      "UPER":null,
      "RPLANET":10.44,
      "MSTAR":1.07,
      "ROW":339
   },
   {
      "KOI":416.02,
      "A":0.36,
      "DEC":41.9891,
      "RSTAR":0.7,
      "TSTAR":5083,
      "KMAG":14.29,
      "TPLANET":313,
      "T0":86.78022,
      "UT0":0.00253,
      "PER":88.2547155,
      "RA":19.12437,
      "UPER":0.0006081,
      "RPLANET":2.71,
      "MSTAR":0.91,
      "ROW":370
   },
   {
      "KOI":438.02,
      "A":0.23,
      "DEC":51.0819,
      "RSTAR":0.56,
      "TSTAR":4351,
      "KMAG":14.258,
      "TPLANET":298,
      "T0":116.51701,
      "UT0":0.00359,
      "PER":52.661868,
      "RA":19.23306,
      "UPER":0.0005769,
      "RPLANET":2.1,
      "MSTAR":0.58,
      "ROW":393
   },
   {
      "KOI":448.02,
      "A":0.193,
      "DEC":40.8688,
      "RSTAR":0.48,
      "TSTAR":4264,
      "KMAG":14.902,
      "TPLANET":296,
      "T0":127.47967,
      "UT0":0.00157,
      "PER":43.6089113,
      "RA":19.80468,
      "UPER":0.0002403,
      "RPLANET":2.31,
      "MSTAR":0.65,
      "ROW":404
   },
   {
      "KOI":536.01,
      "A":0.58,
      "DEC":48.4318,
      "RSTAR":0.89,
      "TSTAR":5614,
      "KMAG":14.499,
      "TPLANET":306,
      "T0":111.59086,
      "UT0":0.0042,
      "PER":162.3394033,
      "RA":19.06827,
      "UPER":0.0022306,
      "RPLANET":3.0,
      "MSTAR":1.03,
      "ROW":504
   },
   {
      "KOI":622.01,
      "A":0.534,
      "DEC":51.2638,
      "RSTAR":0.91,
      "TSTAR":5171,
      "KMAG":14.932,
      "TPLANET":298,
      "T0":146.49936,
      "UT0":0.00257,
      "PER":155.0429186,
      "RA":19.72535,
      "UPER":0.0013764,
      "RPLANET":6.96,
      "MSTAR":1.01,
      "ROW":591
   },
   {
      "KOI":683.01,
      "A":0.863,
      "DEC":43.2584,
      "RSTAR":1.11,
      "TSTAR":5887,
      "KMAG":13.714,
      "TPLANET":295,
      "T0":110.51941,
      "UT0":0.00181,
      "PER":278.122206,
      "RA":19.85495,
      "UPER":0.0025523,
      "RPLANET":5.99,
      "MSTAR":1.02,
      "ROW":655
   },
   {
      "KOI":775.03,
      "A":0.176,
      "DEC":49.9757,
      "RSTAR":0.52,
      "TSTAR":4075,
      "KMAG":15.095,
      "TPLANET":310,
      "T0":84.59631,
      "UT0":0.00443,
      "PER":36.4459073,
      "RA":19.11587,
      "UPER":0.0004933,
      "RPLANET":1.86,
      "MSTAR":0.55,
      "ROW":765
   },
   {
      "KOI":812.03,
      "A":0.212,
      "DEC":39.2783,
      "RSTAR":0.56,
      "TSTAR":4097,
      "KMAG":15.954,
      "TPLANET":293,
      "T0":98.24474,
      "UT0":0.00743,
      "PER":46.1828814,
      "RA":19.07194,
      "UPER":0.0009125,
      "RPLANET":2.02,
      "MSTAR":0.59,
      "ROW":801
   }
]