telbib API documentation

API base URL

https://telbib.eso.org/api.php

API version 2 base URL

https://telbib.eso.org/api_v2.php

Changelog API version 2

Returns more information about ProgramIDs (archival usage, Partner) in a structured way, e.g.

<programids>
  <programid>
    <id>2017.1.01713.S </id>
    <almapartner>Europe</almapartner>
    <archive>N</archive>
  </programid>
  <programid>
    <id>2019.1.01600.S </id>
    <almapartner>Europe</almapartner>
    <archive>Y</archive>
  </programid>
</programids>

Search parameters

author[]	Search with truncation, e.g. https://telbib.eso.org/api_v2.php?author[]=blanch* Search for more than one author with OR, e.g. https://telbib.eso.org/api_v2.php?author[]=blanch&author[]=vettolani&boolaut=or Search for more than one author with AND, e.g. https://telbib.eso.org/api_v2.php?author[]=blanch&author[]=vettolani&boolaut=and
title	Search with truncation, e.g. https://telbib.eso.org/api_v2.php?title=galax* Phrase search (search terms in exact order), e.g. https://telbib.eso.org/api_v2.php?title="emission+structure" Search for more than one word with AND, e.g. https://telbib.eso.org/api_v2.php?title=emission+AND+structure Search for more than one word with OR, e.g. https://telbib.eso.org/api_v2.php?title=emission+OR+structure A combination of phrase search and truncation is not possible.
text	The text field combines the content of title, abstract and keywords. For search possiblities and examples see parameter title.
journal	e.g. https://telbib.eso.org/api_v2.php?journal=A%26A for A&A Please percent-encode special characters, e.g. & to %26. These are the most relevant journal abbreviations: A&A, A&ARv, A&AS, AJ, AN, ARA&A, ApJ, ApJS, Icar, MNRAS, Natur, NewA, NewAR, PASJ, PASP, Sci
volume	e.g. https://telbib.eso.org/api_v2.php?journal=MNRAS&volume=429
yearfrom	Search for publication years, define start year e.g. https://telbib.eso.org/api_v2.php?journal=MNRAS&yearfrom=2010
yearto	Search for publication years, define end year e.g. https://telbib.eso.org/api_v2.php?journal=MNRAS&yearfrom=2012&yearto=2013
telbibpublisheddate	Search for papers that were added to telbib during the given period e.g. https://telbib.eso.org/api_v2.php?journal=MNRAS&telbibpublisheddate=[2014-11-01T23:59:59.999Z+TO+*] https://telbib.eso.org/api_v2.php?journal=MNRAS&telbibpublisheddate=[2014-01-01T23:59:59.999Z+TO+2014-06-01T23:59:59.999Z]
modifieddate	Search for papers that were modified during the given period e.g. https://telbib.eso.org/api_v2.php?journal=A%26A&modifieddate=[2015-07-01T23:59:59.999Z+TO+*] https://telbib.eso.org/api_v2.php?journal=A%26A&modifieddate=[2015-01-01T23:59:59.999Z+TO+2015-06-01T23:59:59.999Z]
bibcode	Search is case sensitive, e.g. https://telbib.eso.org/api_v2.php?bibcode=2012MNRAS.419..304P for A&A Please percent-encode special characters, e.g. & to %26.
programid	Search is case sensitive, e.g. https://telbib.eso.org/api_v2.php?programid=075.D-0210
datadoi	Search with truncation, e.g. for retrieving all papers that use ESO DataDOIs https://telbib.eso.org/api_v2.php?datadoi=10.18727/archive/*
instrument[]	Search for one instrument, e.g. https://telbib.eso.org/api_v2.php?instrument[]=uves Search for more than one instrument with AND, e.g. https://telbib.eso.org/api_v2.php?instrument[]=FORS1&instrument[]=ISAAC&instrument[]=WFI&boolins=and Search for more than one instrument with OR, e.g. https://telbib.eso.org/api_v2.php?instrument[]=FORS1&instrument[]=ISAAC&boolins=or All possible instruments are listed in the instrumemts drop-down menu on the search interface https://telbib.eso.org
telescope[]	Search for one telescope, e.g. https://telbib.eso.org/api_v2.php?telescope[]=VLTI Phrase search, e.g. https://telbib.eso.org/api_v2.php?telescope[]="vlt+visitor" Search for more than one telescope with AND, e.g. https://telbib.eso.org/api_v2.php?telescope[]=vlt&telescope[]=vlti&booltel=and Search for more than one telescope with OR, e.g. https://telbib.eso.org/api_v2.php?telescope[]=vlt&telescope[]=vlti&booltel=or All possible telescopes are listed in the telescopes drop-down menu on the search interface https://telbib.eso.org
site	Search for one site, e.g. https://telbib.eso.org/api_v2.php?site=PARANAL Phrase search, e.g. https://telbib.eso.org/api_v2.php?site="la+silla" All possible sites are listed in the sites drop-down menu on the search interface https://telbib.eso.org

Output example API version 2

<xml encoding="UTF-8">
  <numFound>1</numFound>
  <item>
    <bibcode>2023MNRAS.525.3645C</bibcode>
    <doi>10.1093/mnras/stad2450</doi>
    <authors>
      <author>Chen, Guangwen</author>
      <author>Bendo, George J.</author>
      <author>Fuller, Gary A.</author>
      <author>Henkel, Christian</author>
      <author>Kong, Xu</author>
    </authors>
    <title>
    Star formation in the centre of NGC 1808 as observed by ALMA
    </title>
    <abstract>
    We present Atacama Large Millimeter/submillimeter Array (ALMA) observations of 85.69- and 99.02-GHz continuum emission and H42α and H40α lines emission from the central 1 kpc of NGC 1808. These forms of emission are tracers of photoionizing stars but unaffected by dust obscuration that we use to test the applicability of other commonly star formation metrics. An analysis of the spectral energy distributions shows that free-free emission contributes about 60-90 per cent of the continuum emission in the 85-100-GHz frequency range, dependent on the region. The star formation rate (SFR) derived from the ALMA free-free emission is 3.1 ± 0.3 M<SUB>⊙</SUB> yr<SUP>-1</SUP>. This is comparable to the SFRs measured from the infrared emission, mainly because most of the bolometric energy from the heavily obscured region is emitted as infrared emission. The radio 1.5-GHz emission yields an SFR 25 per cent lower than the ALMA value, probably because of the diffusion of the electrons producing the synchrotron emission beyond the star-forming regions. The SFRs measured from the extinction-corrected H α line emission are about 40-65 per cent of the SFR derived from the ALMA data, likely because this metric was not calibrated for high-extinction regions. Some SFRs based on extinction-corrected ultraviolet emission are similar to those from ALMA and infrared data, but given that the ultraviolet terms in the extinction correction equations are very small, these metrics seem inappropriate to apply to this dusty starburst.
    </abstract>
    <keywords>
      <keyword>galaxies: star formation</keyword>
      <keyword>radio lines: galaxies</keyword>
      <keyword>galaxies: starburst</keyword>
      <keyword>radio continuum: galaxies</keyword>
      <keyword>GALAXIES: INDIVIDUAL: NGC 1808</keyword>
      <keyword>Astrophysics - Astrophysics of Galaxies</keyword>
    </keywords>
    <journal>MNRAS</journal>
    <year>2023</year>
    <volume>525</volume>
    <pages>3645</pages>
    <telbibpublisheddate>2023-11-01T12:13:38Z</telbibpublisheddate>
    <modifieddate>2023-12-14T14:12:00Z</modifieddate>
    <instruments>
      <instrument>ALMA_Band_3</instrument>
      <instrument>ALMA_Band_6</instrument>
      <instrument>ALMA_Band_7</instrument>
      <instrument>MUSE</instrument>
    </instruments>
    <telescopes>
      <telescope>ALMA</telescope>
      <telescope>VLT</telescope>
    </telescopes>
    <sites>
      <site>Chajnantor_ALMA</site>
      <site>Paranal</site>
    </sites>
    <programids>
      <programid>
        <proid>0102.B-0617 </id>
        <archive>N</archive>
      </programid>
      <programid>
        <proid>2012.1.01004.S </id>
        <almapartner>East Asia</almapartner>
        <archive>Y</archive>
      </programid>
      <programid>
        <proid>2013.1.00911.S </id>
        <almapartner>East Asia</almapartner>
        <archive>Y</archive>
      </programid>
      <programid>
        <proid>2013.1.00911.S </id>
        <almapartner>East Asia</almapartner>
        <archive>Y</archive>
      </programid>
      <programid>
        <proid>2016.1.00562.S </id>
        <almapartner>Europe</almapartner>
        <archive>N</archive>
      </programid>
      <programid>
        <proid>2017.1.00984.S </id>
        <almapartner>East Asia</almapartner>
        <archive>Y</archive>
      </programid>
    </programids>
    <datadois>
      <datadoi>10.18727/archive/42</datadoi>
    </datadois>
  </item>
</xml>

Results

A query will return XML. The XML element "numFound" shows the total number of hits that were found. A maximum of 500 hits will be displayed. If you need more, you can add

&start=500

to the search link in order to get 501-1000,

&start=1000

for 1001-1500, etc.

Acknowledgement

If you use our data, please acknowledge the ESO Telescope Bibliography somewhere appropriate on the page where the data is being displayed (e.g., "Source: ESO Telescope Bibliography, https://telbib.eso.org").
As we are interested in what our data is used for, we would appreciate, if you let us know about your projects.

Contact

If you have questions or suggestions, please contact us: [email protected]