{"ok":true,"site":"ipac-caltech","host":"exoplanetarchive.ipac.caltech.edu","about":"NASA Exoplanet Archive (IPAC/Caltech). This CLI queries confirmed exoplanets, TESS TOI candidates, table schemas and archive statistics through the public TAP/ADQL API. It also checks whether an object name resolves and reads system overview pages.","commands":[{"command":"run-tap-query","summary":"Run an arbitrary ADQL query against the archive's TAP service (tables: ps, pscomppars, toi, cumulative, stellarhosts, k2pandc, ...) and return JSON rows","params":[{"name":"query","type":"string","required":true,"description":"ADQL query, e.g. \"select top 10 pl_name,hostname from pscomppars where disc_year=2024 order by pl_rade desc\". Use plain WHERE clauses; avoid contains(point,circle) cone searches, which may be blocked."},{"name":"maxrec","type":"number","description":"Maximum number of rows to return (an alternative to 'select top N')"}],"exampleUrl":"https://clify-dev.netlify.app/ipac-caltech/run-tap-query?query=select+top+10+pl_name%2Chostname%2Cpl_orbper%2Cpl_rade%2Cdisc_year+from+pscomppars+where+disc_year%3D2024+order+by+pl_rade+desc&maxrec=20"},{"command":"export-tap-csv","summary":"Run an ADQL query against the TAP service and return the result as CSV text (for bulk export)","params":[{"name":"query","type":"string","required":true,"description":"ADQL query, e.g. \"select toi,tid,tfopwg_disp,pl_orbper,pl_rade from toi where tfopwg_disp='PC' order by toi\""},{"name":"maxrec","type":"number","description":"Maximum number of rows to return"}],"exampleUrl":"https://clify-dev.netlify.app/ipac-caltech/export-tap-csv?query=select+toi%2Ctid%2Ctfopwg_disp%2Cpl_orbper%2Cpl_rade+from+toi+where+tfopwg_disp%3D%27PC%27+order+by+toi&maxrec=20"},{"command":"list-planets-by-year","summary":"List confirmed planets discovered in a given year (Planetary Systems Composite table), sorted by a chosen column, top N","params":[{"name":"year","type":"number","required":true,"description":"Discovery year, e.g. 2024"},{"name":"api_limit","type":"number","description":"Number of planets to return (sent to the site as \"limit\"; clify's own --limit only shapes the output)","default":10},{"name":"sort","type":"string","description":"Column to sort by (pl_rade = radius in Earth radii, pl_orbper = orbital period in days, pl_bmasse = mass in Earth masses)","oneOf":["pl_rade","pl_orbper","pl_bmasse","pl_name"],"default":"pl_rade"},{"name":"order","type":"string","description":"Sort direction","oneOf":["desc","asc"],"default":"desc"}],"exampleUrl":"https://clify-dev.netlify.app/ipac-caltech/list-planets-by-year"},{"command":"list-host-planets","summary":"List all confirmed planets orbiting a given host star, with period, radius, mass and discovery method","params":[{"name":"hostname","type":"string","required":true,"description":"Exact host star name as used by the archive, e.g. Kepler-186, TRAPPIST-1"}],"exampleUrl":"https://clify-dev.netlify.app/ipac-caltech/list-host-planets"},{"command":"list-toi-candidates","summary":"List TESS Objects of Interest (TOI) filtered by TFOPWG disposition, ordered by TOI number","params":[{"name":"disposition","type":"string","required":true,"description":"TFOPWG disposition: PC = planet candidate, APC = ambiguous PC, CP = confirmed planet, KP = known planet, FP = false positive, FA = false alarm","oneOf":["PC","APC","CP","KP","FP","FA"]},{"name":"maxrec","type":"number","description":"Maximum number of rows to return","default":20}],"exampleUrl":"https://clify-dev.netlify.app/ipac-caltech/list-toi-candidates?maxrec=20"},{"command":"list-tap-tables","summary":"List all tables available through the TAP service, with descriptions","params":[],"exampleUrl":"https://clify-dev.netlify.app/ipac-caltech/list-tap-tables"},{"command":"get-table-columns","summary":"Get the column schema (name, datatype, description) of a TAP table such as pscomppars, ps or toi","params":[{"name":"table","type":"string","required":true,"description":"TAP table name, e.g. pscomppars, ps, toi, cumulative, stellarhosts"}],"exampleUrl":"https://clify-dev.netlify.app/ipac-caltech/get-table-columns"},{"command":"check-object-name","summary":"Check whether an object/system name resolves in the archive inventory; stat OK means /overview/<name> exists","params":[{"name":"locstr","type":"string","required":true,"description":"Object/system name, e.g. Kepler-186 or TRAPPIST-1"}],"exampleUrl":"https://clify-dev.netlify.app/ipac-caltech/check-object-name?locstr=Kepler-186"},{"command":"get-system-overview","summary":"Get the planets shown on a system's overview page (planet name, radius in Jupiter radii, confirmed/candidate status)","params":[{"name":"name","type":"string","required":true,"description":"System/host name, e.g. Kepler-186 or TRAPPIST-1"}],"exampleUrl":"https://clify-dev.netlify.app/ipac-caltech/get-system-overview"},{"command":"get-archive-statistics","summary":"Get the archive's statistics page rows (confirmed planet counts by discovery method, mass/radius coverage, radius bins, Kepler/TESS candidate counts)","params":[],"exampleUrl":"https://clify-dev.netlify.app/ipac-caltech/get-archive-statistics"},{"command":"get-toi-counts","summary":"Get current TESS TOI totals from ExoFOP: total count, latest new/updated dates and counts, and counts per TFOPWG disposition","params":[],"exampleUrl":"https://clify-dev.netlify.app/ipac-caltech/get-toi-counts"}]}