{"openapi":"3.1.0","info":{"title":"Exoplanets API","version":"1.0.0","description":"Explore 6,200+ confirmed planets orbiting other stars, from the NASA Exoplanet Archive. For each exoplanet get its host star, discovery method, year and facility, orbital period, radius and mass (relative to Earth), distance in light-years and equilibrium temperature. Look one up by name, search and filter by discovery method or year, or list every planet in a host system (e.g. TRAPPIST-1). Great for astronomy, education and space apps.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/exoplanets-api","description":"oanor gateway"}],"tags":[{"name":"Exoplanets"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/exoplanet":{"get":{"operationId":"get_v1_exoplanet","tags":["Exoplanets"],"summary":"A single exoplanet by name or id","description":"","parameters":[{"name":"name","in":"query","required":false,"description":"Planet name, e.g. Proxima Cen b","schema":{"type":"string"},"example":"Proxima Cen b"},{"name":"id","in":"query","required":false,"description":"Dataset id (alternative to name)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":3400,"name":"Proxima Cen b","discovery":{"year":2016,"method":"Radial Velocity","facility":"European Southern Observatory"},"host_star":"Proxima Cen","mass_earth":1.055,"distance_ly":4.24,"radius_earth":1.02,"equilibrium_temp_k":218,"orbital_period_days":11.1846},"meta":{"timestamp":"2026-05-31T02:25:28.687Z","request_id":"3e2721f2-8051-4623-a281-9a2ca53d63cf"},"status":"ok","message":"Exoplanet retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/host":{"get":{"operationId":"get_v1_host","tags":["Exoplanets"],"summary":"All planets orbiting a host star","description":"","parameters":[{"name":"name","in":"query","required":true,"description":"Host star name, e.g. TRAPPIST-1","schema":{"type":"string"},"example":"TRAPPIST-1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"planets":7,"host_star":"TRAPPIST-1","exoplanets":[{"id":3401,"name":"TRAPPIST-1 b","discovery":{"year":2016,"method":"Transit","facility":"La Silla Observatory"},"host_star":"TRAPPIST-1","mass_earth":1.374,"distance_ly":40.54,"radius_earth":1.116,"equilibrium_temp_k":397.6,"orbital_period_days":1.5108},{"id":3402,"name":"TRAPPIST-1 c","discovery":{"year":2016,"method":"Transit","facility":"La Silla Observatory"},"host_star":"TRAPPIST-1","mass_earth":1.308,"distance_ly":40.54,"radius_earth":1.097,"equilibrium_temp_k":339.7,"orbital_period_days":2.4219},{"id":3403,"name":"TRAPPIST-1 d","discovery":{"year":2016,"method":"Transit","facility":"La Silla Observatory"},"host_star":"TRAPPIST-1","mass_earth":0.388,"distance_ly":40.54,"radius_earth":0.788,"equilibrium_temp_k":286.2,"orbital_period_days":4.0492},{"id":3568,"name":"TRAPPIST-1 e","discovery":{"year":2017,"method":"Transit","facility":"Multiple Observatories"},"host_star":"TRAPPIST-1","mass_earth":0.692,"distance_ly":40.54,"radius_earth":0.92,"equilibrium_temp_k":249.7,"orbital_period_days":6.101},{"id":3569,"name":"TRAPPIST-1 f","discovery":{"year":2017,"method":"Transit","facility":"Multiple Observatories"},"host_star":"TRAPPIST-1","mass_earth":1.039,"distance_ly":40.54,"radius_earth":1.045,"equilibrium_temp_k":217.7,"orbital_period_days":9.2075},{"id":3570,"name":"TRAPPIST-1 g","discovery":{"year":2017,"method":"Transit","facility":"Multiple Observatories"},"host_star":"TRAPPIST-1","mass_earth":1.321,"distance_ly":40.54,"radius_earth":1.129,"equilibrium_temp_k":197.3,"orbital_period_days":12.3524},{"id":3571,"name":"TRAPPIST-1 h","discovery":{"year":2017,"method":"Transit","facility":"Multiple Observatories"},"host_star":"TRAPPIST-1","mass_earth":0.326,"distance_ly":40.54,"radius_earth":0.755,"equilibrium_temp_k":171.7,"orbital_period_days":18.7729}]},"meta":{"timestamp":"2026-05-31T02:25:28.753Z","request_id":"dcbe08eb-4d7b-451d-bc9d-037ed8ecfb85"},"status":"ok","message":"Host system retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Exoplanets"],"summary":"Search & filter exoplanets","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Planet / host name (substring)","schema":{"type":"string"},"example":"kepler-22"},{"name":"method","in":"query","required":false,"description":"Discovery method, e.g. Transit, Radial Velocity","schema":{"type":"string"},"example":"Transit"},{"name":"year","in":"query","required":false,"description":"Discovery year","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results per page (1-100, default 20)","schema":{"type":"string"},"example":"20"},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":20,"limit":20,"total":33,"offset":0,"filters":{"q":"kepler-22","method":"transit"},"results":[{"id":591,"name":"Kepler-22 b","discovery":{"year":2011,"method":"Transit","facility":"Kepler"},"host_star":"Kepler-22","mass_earth":9.1,"distance_ly":634.84,"radius_earth":2.1,"equilibrium_temp_k":279,"orbital_period_days":289.8639},{"id":1236,"name":"Kepler-220 b","discovery":{"year":2014,"method":"Transit","facility":"Kepler"},"host_star":"Kepler-220","mass_earth":0.457,"distance_ly":558.08,"radius_earth":0.81,"equilibrium_temp_k":759,"orbital_period_days":4.1598},{"id":1237,"name":"Kepler-220 c","discovery":{"year":2014,"method":"Transit","facility":"Kepler"},"host_star":"Kepler-220","mass_earth":3.09,"distance_ly":558.08,"radius_earth":1.57,"equilibrium_temp_k":586,"orbital_period_days":9.0342},{"id":1238,"name":"Kepler-220 d","discovery":{"year":2014,"method":"Transit","facility":"Kepler"},"host_star":"Kepler-220","mass_earth":0.904,"distance_ly":558.08,"radius_earth":0.98,"equilibrium_temp_k":401,"orbital_period_days":28.1224},{"id":1239,"name":"Kepler-220 e","discovery":{"year":2014,"method":"Transit","facility":"Kepler"},"host_star":"Kepler-220","mass_earth":2.33,"distance_ly":558.08,"radius_earth":1.33,"equilibrium_temp_k":341,"orbital_period_days":45.9027},{"id":1240,"name":"Kepler-221 b","discovery":{"year":2014,"method":"Transit","facility":"Kepler"},"host_star":"Kepler-221","mass_earth":5.9558,"distance_ly":1256.45,"radius_earth":1.71,"equilibrium_temp_k":1090,"orbital_period_days":2.7959},{"id":1241,"name":"Kepler-221 c","discovery":{"year":2014,"method":"Transit","facility":"Kepler"},"host_star":"Kepler-221","mass_earth":9.3,"distance_ly":1256.45,"radius_earth":2.93,"equilibrium_temp_k":860,"orbital_period_days":5.6906},{"id":1242,"name":"Kepler-221 d","discovery":{"year":2014,"method":"Transit","facility":"Kepler"},"host_star":"Kepler-221","mass_earth":3.61,"distance_ly":1256.45,"radius_earth":2.73,"equilibrium_temp_k":712,"orbital_period_days":10.0416},{"id":1243,"name":"Kepler-221 e","discovery":{"year":2014,"method":"Transit","facility":"Kepler"},"host_star":"Kepler-221","mass_earth":7.8671,"distance_ly":1256.45,"radius_earth":2.63,"equilibrium_temp_k":582,"orbital_period_days":18.3699},{"id":1244,"name":"Kepler-222 b","discovery":{"year":2014,"method":"Transit","facility":"Kepler"},"host_star":"Kepler-222","mass_earth":10.1,"distance_ly":2475.05,"radius_earth":3.16,"equilibrium_temp_k":1004,"orbital_period_days":3.937},{"id":1245,"name":"Kepler-222 c","discovery":{"year":2014,"method":"Transit","facility":"Kepler"},"host_star":"Kepler-222","mass_earth":19.4,"distance_ly":2475.05,"radius_earth":4.64,"equilibrium_temp_k":734,"orbital_period_days":10.0888},{"id":1246,"name":"Kepler-222 d","discovery":{"year":2014,"method":"Transit","facility":"Kepler"},"host_star":"Kepler-222","mass_earth":13.2,"distance_ly":2475.05,"radius_earth":3.69,"equilibrium_temp_k":522,"orbital_period_days":28.0819},{"id":1247,"name":"Kepler-223 b","discovery":{"year":2014,"method":"Transit","facility":"Kepler"},"host_star":"Kepler-223","mass_earth":7.4,"distance_ly":6065.56,"radius_earth":2.99,"equilibrium_temp_k":1042,"orbital_period_days":7.3845},{"id":1248,"name":"Kepler-223 c","discovery":{"year":2014,"method":"Transit","facility":"Kepler"},"host_star":"Kepler-223","mass_earth":5.1,"distance_ly":6065.56,"radius_earth":3.44,"equilibrium_temp_k":947,"orbital_period_days":9.8456},{"id":1249,"name":"Kepler-223 d","discovery":{"year":2014,"method":"Transit","facility":"Kepler"},"host_star":"Kepler-223","mass_earth":8,"distance_ly":6065.56,"radius_earth":5.24,"equilibrium_temp_k":827,"orbital_period_days":14.7887},{"id":1250,"name":"Kepler-223 e","discovery":{"year":2014,"method":"Transit","facility":"Kepler"},"host_star":"Kepler-223","mass_earth":4.8,"distance_ly":6065.56,"radius_earth":4.6,"equilibrium_temp_k":751,"orbital_period_days":19.7257},{"id":1251,"name":"Kepler-224 b","discovery":{"year":2014,"method":"Transit","facility":"Kepler"},"host_star":"Kepler-224","mass_earth":2.51,"distance_ly":2550.83,"radius_earth":1.39,"equilibrium_temp_k":937,"orbital_period_days":3.1329},{"id":1252,"name":"Kepler-224 c","discovery":{"year":2014,"method":"Transit","facility":"Kepler"},"host_star":"Kepler-224","mass_earth":9.91,"distance_ly":2550.83,"radius_earth":3.12,"equilibrium_temp_k":758,"orbital_period_days":5.925},{"id":1253,"name":"Kepler-224 d","discovery":{"year":2014,"method":"Transit","facility":"Kepler"},"host_star":"Kepler-224","mass_earth":5.9,"distance_ly":2550.83,"radius_earth":2.3,"equilibrium_temp_k":610,"orbital_period_days":11.3494},{"id":1254,"name":"Kepler-224 e","discovery":{"year":2014,"method":"Transit","facility":"Kepler"},"host_star":"Kepler-224","mass_earth":4.54,"distance_ly":2550.83,"radius_earth":1.97,"equilibrium_temp_k":517,"orbital_period_days":18.6436}]},"meta":{"timestamp":"2026-05-31T02:25:28.819Z","request_id":"8379720a-0105-406c-9c6f-f34b6571ef0f"},"status":"ok","message":"Search completed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Totals, discovery methods & source","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"total":6291,"fields":["id","name","host_star","discovery","orbital_period_days","radius_earth","mass_earth","distance_ly","equilibrium_temp_k"],"source":"NASA Exoplanet Archive","host_stars":4709,"discovery_methods":[{"count":6,"method":"Astrometry"},{"count":1,"method":"Disk Kinematics"},{"count":17,"method":"Eclipse Timing Variations"},{"count":97,"method":"Imaging"},{"count":278,"method":"Microlensing"},{"count":9,"method":"Orbital Brightness Modulation"},{"count":8,"method":"Pulsar Timing"},{"count":2,"method":"Pulsation Timing Variations"},{"count":1181,"method":"Radial Velocity"},{"count":4651,"method":"Transit"},{"count":41,"method":"Transit Timing Variations"}]},"meta":{"timestamp":"2026-05-31T02:25:28.895Z","request_id":"ce98662f-23ce-4c5b-a9ab-d33e9d1dfd7f"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2500,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":500,"monthly_call_quota":55000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1500,"monthly_call_quota":320000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3800,"monthly_call_quota":1500000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/exoplanets-api"}