Requesting LiDB data through the API
https://www.exomol.com/lidb/api/Requests are made using the GET protocol and require certain keywords to retrieve the correct LiDB data.
Firstly, requests must be made using the
molecule keyword to select a specific dataset. Datasets are available for all the molecules listed on the LiDB data homepage.The
category keyword must also be provided. category=states will request total lifetimes (in seconds) for the lumped vibrational states. category=transitions will request partial lifetimes (in seconds) between the lumped vibrational states.Data can be returned in either JSON (default) or CSV format using the
format keyword. The first line returned from JSON requests contains meta-data with information on the molecule formula, isotopologue, ExoMol dataset and version, the number of states in the LiDB query, and the number of transitions in the LiDB query. The first line returned from CSV requests contains column headers of the associated dataset.Examples of making requests through the API:
To make a request for total state lifetimes of the CaO molecule in CSV format:
https://www.exomol.com/lidb/api/?molecule=CaO&category=states&format=csvTo make a request for partial lifetimes of "transitions" between states of water (H2O) in JSON format:
https://www.exomol.com/lidb/api/?molecule=H2O&category=transitions&format=json