{"openapi":"3.1.0","info":{"title":"Planets API","version":"1.0.0","description":"Physical and orbital data for the solar system and beyond: every planet, dwarf planet, major moon and the Sun with NASA fact-sheet values (mass, radius, surface gravity, density, escape velocity, mean temperature, orbital and rotation period, semi-major axis, moon count and rings), plus a searchable catalogue of more than 6,000 confirmed exoplanets from the NASA Exoplanet Archive (radius, mass, orbital period, equilibrium temperature, distance in light-years, host star, discovery year and method). Filter exoplanets by host star, discovery method, year, size or distance, compare solar-system bodies side by side, and look up any single body or exoplanet by name. Every endpoint accepts input via the query string or the request body and returns lean JSON. Pure server-side data (no third-party upstream), so responses are instant and always available. Ideal for education, EdTech, astronomy apps, data visualisation and science tools.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/planets-api","description":"oanor gateway"}],"tags":[{"name":"Planets"}],"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/bodies":{"get":{"operationId":"get_v1_bodies","tags":["Planets"],"summary":"List solar-system bodies","description":"","parameters":[{"name":"type","in":"query","required":false,"description":"planet|dwarf_planet|moon|star","schema":{"type":"string"},"example":"planet"},{"name":"parent","in":"query","required":false,"description":"Parent body (for moons)","schema":{"type":"string"},"example":"Jupiter"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"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/body":{"get":{"operationId":"get_v1_body","tags":["Planets"],"summary":"Single solar-system body","description":"","parameters":[{"name":"name","in":"query","required":true,"description":"Body name","schema":{"type":"string"},"example":"Jupiter"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"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/compare":{"get":{"operationId":"get_v1_compare","tags":["Planets"],"summary":"Compare solar-system bodies","description":"","parameters":[{"name":"bodies","in":"query","required":true,"description":"Comma-separated names (max 8)","schema":{"type":"string"},"example":"Earth,Mars,Jupiter"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"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/exoplanet":{"get":{"operationId":"get_v1_exoplanet","tags":["Planets"],"summary":"Single exoplanet by name","description":"","parameters":[{"name":"name","in":"query","required":true,"description":"Exoplanet name","schema":{"type":"string"},"example":"Proxima Cen b"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"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/exoplanets":{"get":{"operationId":"get_v1_exoplanets","tags":["Planets"],"summary":"Search exoplanet catalogue","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Name contains","schema":{"type":"string"},"example":"Kepler"},{"name":"host","in":"query","required":false,"description":"Host star","schema":{"type":"string"},"example":"TRAPPIST-1"},{"name":"method","in":"query","required":false,"description":"Discovery method","schema":{"type":"string"},"example":"Transit"},{"name":"year","in":"query","required":false,"description":"Discovery year","schema":{"type":"string"},"example":"2017"},{"name":"min_radius","in":"query","required":false,"description":"Min radius (Earth radii)","schema":{"type":"string"},"example":"0.5"},{"name":"max_radius","in":"query","required":false,"description":"Max radius","schema":{"type":"string"},"example":"2"},{"name":"max_distance_ly","in":"query","required":false,"description":"Max distance (ly)","schema":{"type":"string"},"example":"50"},{"name":"sort","in":"query","required":false,"description":"name|distance|year|radius|mass","schema":{"type":"string"},"example":"distance"},{"name":"limit","in":"query","required":false,"description":"1..100 (default 20)","schema":{"type":"string"},"example":"20"},{"name":"offset","in":"query","required":false,"description":"Offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"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":["Planets"],"summary":"Catalogue facets","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"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":30000,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":650,"monthly_call_quota":450000,"rps_limit":12,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2100,"monthly_call_quota":3200000,"rps_limit":35,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5200,"monthly_call_quota":15000000,"rps_limit":90,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/planets-api"}