Exoplanet Atmosphere Observability Table

Catalog Overview

The Exoplanet Atmosphere Observability Table (EAOT) provides data about exoplanets from exoplanets.org, NExSci, and TOIs.

Catalog Tables and Additional Information

Catalog

Table/View

Additional Information

Observability

observabilityView

EAOT observabilityView Fields

Getting Started

Quick Start

For more detailed information on using the API, continue below to Usage.

Example 2: EAOT with specific planet name

Search EAOT catalog where planet name is like “HAT”

https://catalogs.mast.stsci.edu/api/v0.1/eaot/search.csv?planet_name.like=HAT*

Click to try Quick Start Example 2

Specify Output Columns
https://catalogs.mast.stsci.edu/api/v0.1/eaot/search.csv?columns=[planet_name,catalog_name,Rp,Mp]

Click to try New API Specify Columns Example

Usage

Access

The EAOT API can be accessed using GET or POST requests. POST is recommended due to the potentially large request size.

Note Currently, the /metadata endpoint only supports GET

Note If duplicate parameters are present in the query string and request body of a POST, the request body will override behavior

Base EAOT Path
https://catalogs.mast.stsci.edu/api/v0.1/eaot/

Selecting Catalogs

The EAOT API currently supports the querying of exoplanets.org, NEXSCI, and TOI. To access the different version of the HSC catalogs, indicate the version within the path:

Accessing the different catalogs
/eaot/search.json?catalog_name=exoplanets.org
/eaot/search.json?catalog_name=nexsci
/eaot/search.json?catalog_name=toi

Searching EAOT

Count

Counts may be returned based on a given query (search query creation details below)

To access counts, append the /count path

Example Count for EAOT

CSV Count Example
/eaot/search/count.csv

Meta Data

The /metadata path provides additional information of available columns for a given catalog. The additional information includes: column name, column data type, and column description.

Example Receive metadata for EAOT

Meta Data Request Example
/eaot/search/metadata.json

General Searching

Please read documentation for more detailed general search guidelines for our catalog services. Using MAST Catalogs

Formats

View Encoding Formats

EAOT JSON Format GET
/ Default
GET /eaot/search

/ With Decorator
GET /eaot/search.json

/ With Parameter
GET /eaot/search/format=json

/ With Accept Header
GET /eaot/search
ACCEPT: application/json
Selecting Columns

View Selecting Columns

EAOT planet mass (Mp), planet temperature (Tp) columns GET
/eaot/search?columns=Mp&columns=Tp
/ note case insensitivity
/eaot/search?columns=MP&columns=TP

/eaot/search?columns=["Mp","Tp"]
/eaot/search?columns=[Mp,Tp]
Column Filtering

View Column Filtering

EAOT planet radius (Rp) greater than or equal to 1 POST
/eaot/search
Rp.gte=1
Sorting

View Sorting

EAOT Sort By orbital_period descending (DESC) and transit_duration ascending (ASC) POST
/eaot/search
sort_by=orbital_period.desc
sort_by=transit_duration.asc
Paging

View Paging

EAOT POST Second Page of Page Size of 100
/eaot/search
pagesize=100
page=2

EAOT API Services

GET /api/v0.1/eaot/search/metadata{additional_args}

Return column metadata

Return column metadata

Status Codes:
GET /api/v0.1/eaot/search{additional_args}

Subset of Exoplanet observability view based on filter criteria

Query view based on filter criteria

Request Headers:

  • accept (string) –

Query Parameters:

  • columns (array) – A list of column names to include

  • sort_by (array) – A list of columns to sort by

  • pagesize (integer) – The number of planets to return per page

  • page (integer) – If using pagesize, the page number to return

  • flatten_response (boolean) – Request responses to return as a list of lists rather than a list of objects.

  • format – Format of the response (json/csv/xml/votable)

  • delimiter – Delimiter used in csv response

  • raw (boolean) – Request all responses to be in raw form. If false, the response will convert all items of long data type to a string. This is useful for languages with problems encoding long data types.

  • include_info (boolean) – Request responses to include column info. If true, the response will include the info key within the return object with available column information.

Status Codes:
POST /api/v0.1/eaot/search{additional_args}

Post method for search requests

POST request for subset of Exoplanet observability view based on filter criteria

Request Headers:

  • accept (string) –

Query Parameters:

  • flatten_response (boolean) – Request responses to return as a list of lists rather than a list of objects.

  • format – Format of the response (json/csv/xml/votable)

  • delimiter – Delimiter used in csv response

  • raw (boolean) – Request all responses to be in raw form. If false, the response will convert all items of long data type to a string. This is useful for languages with problems encoding long data types.

  • include_info (boolean) – Request responses to include column info. If true, the response will include the info key within the return object with available column information.

Status Codes: