from astroquery import nasa_ads as na
# if you don't store your token as an environment variable
# or in a file, give it here
na.ADS.TOKEN = '0zry67QTNPCJwq19xD8wXHsBh3TYsnukaKWuZsgc'
# change the number of rows returned
na.ADS.NROWS = 40
# change the sort order
# na.ADS.SORT = 'bibcode desc'
# change the fields that are returned (enter as strings in a list)
na.ADS.ADS_FIELDS = ['author','bibcode','title','abstract','pubdate']
# the "^" makes ADS to return only papers where Persson
# is first author
results = na.ADS.query_simple('LAMOST')
for r in results:
print(r['title'], r['author'], r['bibcode'])
['Collision possibility analysis and collision avoidance for multi-object fibre-fed spectrographs with theta-phi positioners'] ['Zhang, Feifan', 'Wang, Jianping', 'Liu, Zhigang', 'Zhai, Chao', 'Chu, Jiaru'] 2021MNRAS.500..101Z ['Diagnosing Open Cluster Stock 2: Member Candidates and Mass Distribution with Gaia DR2 and LAMOST'] ['Ye, Xianhao', 'Zhao, Jingkun', 'Liu, Jiaming', 'Bird, Sarah A.', 'Liu, Chao', 'Liang, Xilong', 'Zhang, Jiajun', 'Zhao, Gang'] 2021AJ....161....8Y ['VizieR Online Data Catalog: DB white dwarfs from the LAMOST DR5 (Kong+, 2019)'] ['Kong, X.', 'Luo, A. -L.', 'Li, X. -R.'] 2020yCatp040001908K ['VizieR Online Data Catalog: Gaia Alerts with LAMOST and SDSS (Huo+, 2020)'] ['Huo, Z.', 'Dennefeld, M.', 'Liu, X.', 'Pursimo, T.', 'Zhang, T.'] 2020yCatp017036501H ['VizieR Online Data Catalog: Radial velocities of 1453 FGK (Rebassa-Mansergas+, 2017)'] ['Rebassa-Mansergas, A.', 'Ren, J. J.', 'Irawati, P.', 'Garcia-Berro, E.', 'Parsons, S. G.', 'Schreiber, M. R.', 'Gansicke, B. T.', 'Rodriguez-Gil, P.', 'Liu, X.', 'Manser, C.', 'Nevado, S. P.', 'Jimenez-Ibarra, F.', 'Costero, R.', 'Echevarria, J.', 'Michel, R.', 'Zorotovic, M.', 'Hollands, M.', 'Han, Z.', 'Luo, A.', 'Villaver, E.', 'Kong, X.'] 2020yCat..74724193R ['VizieR Online Data Catalog: Stellar parameters of ~30000 LAMOST DR1 M dwarfs (Galgano+, 2020)'] ['Galgano, B.', 'Stassun, K.', 'Rojas-Ayala, B.'] 2020yCat..51590193G ['VizieR Online Data Catalog: Two new stellar associations in vicinity of the Sun (Liu+, 2020)'] ['Liu, J.', 'Fang, M.', 'Liu, C.'] 2020yCat..51590105L ['VizieR Online Data Catalog: Spectroscopically identified CVs from LAMOST survey. I. (Hou+, 2020)'] ['Hou, W.', 'Luo, A. -L.', 'Li, Y. -B.', 'Qin, Li'] 2020yCat..51590043H ['VizieR Online Data Catalog: Multi-wavelength census of blazars (Paggi+, 2020)'] ['Paggi, A.', 'Bonato, M.', 'Raiteri, C. M.', 'Villata, M.', 'de Zotti, G.', 'Carnerero, M. I.'] 2020yCat..36410062P ['VizieR Online Data Catalog: Open cluster properties with Gaia and LAMOST (Zhong+, 2020)'] ['Zhong, J.', 'Chen, L.', 'Wu, D.', 'Li, L.', 'Bai, L.', 'Hou, J.'] 2020yCat..36400127Z ['VizieR Online Data Catalog: 1002 mCP stars from LAMOST DR4 (Hummerich+, 2020)'] ['Hummerich, S.', 'Paunzen, E.', 'Bernhard, K.'] 2020yCat..36400040H ['VizieR Online Data Catalog: StarHorse data for 5 surveys (Queiroz+, 2020)'] ['Queiroz, A. B. A.', 'Anders, F.', 'Chiappini, C.', 'Khalatyan, A.', 'Santiago, B. X.', 'Steinmetz, M.', 'Valentini, M.', 'Miglio, A.', 'Barbuy, B.', 'Minchev, I.', 'Minniti, D.', 'Garcia Hernandez, D. A.', 'Schultheis, M.', 'Beaton, R. L.', 'Beers, T. C.', 'Bizyaev, D.', 'Brownstein, J. R.', 'Cunha, K.', 'Fernandez-Trincado, J. G.', 'Frinchaboy, P. M.', 'Lane, R. R.', 'Majewski, S. R.', 'Nataf, D.', 'Nitschelm, C.', 'Pan, K.', 'Roman-Lopes, A.', 'Sobeck, J. S.', 'Stringfellow, G.', 'Zamora, O.'] 2020yCat..36380076Q ['VizieR Online Data Catalog: Short period spec. & EBs (LPSEB) from LAMOST & PTF (Yang+, 2020)'] ['Yang, F.', 'Long, R. J.', 'Shan, S. -S.', 'Zhang, Bo', 'Guo, R.', 'Bai, Yu', 'Bai, Z.', 'Cui, K. -M.', 'Wang, S.', 'Liu, J. -F.'] 2020yCat..22490031Y ['VizieR Online Data Catalog: Radial velocity variable stars from LAMOST DR4 (Tian+, 2020)'] ['Tian, Z.', 'Liu, X.', 'Yuan, H.', 'Fang, X.', 'Chen, B.', 'Xiang, M.', 'Huang, Y.', 'Bi, S.', 'Yang, W.', 'Wu, Y.', 'Wang, C.', 'Zhang, H.', 'Huo, Z.', 'Yang, Y.', 'Liu, G.', 'Guo, J.', 'Zhang, M.'] 2020yCat..22490022T ['VizieR Online Data Catalog: K2 star parameters from Gaia & LAMOST (Hardegree-Ullman+, 2020)'] ['Hardegree-Ullman, K. K.', 'Zink, J. K.', 'Christiansen, J. L.', 'Dressing, C. D.', 'Ciardi, D. R.', 'Schlieder, J. E.'] 2020yCat..22470028H ['VizieR Online Data Catalog: FGK stars magnetic activity in LAMOST-Kepler field (Zhang+, 2020)'] ['Zhang, J.', 'Bi, S.', 'Li, Y.', 'Jiang, J.', 'Li, T.', 'He, H.', 'Yu, J.', 'Khanna, S.', 'Ge, Z.', 'Liu, K.', 'Tian, Z.', 'Wu, Y.', 'Zhang, X.'] 2020yCat..22470009Z ['VizieR Online Data Catalog: Compact groups of galaxies in SDSS & LAMOST. I. (Zheng+, 2020)'] ['Zheng, Y. -L.', 'Shen, S. -Y.'] 2020yCat..22460012Z ['VizieR Online Data Catalog: Binary stars parameters from LAMOST & Kepler obs. (Zhang+, 2019)'] ['Zhang, J.', 'Qian, S. -B.', 'Wu, Y.', 'Zhou, X.'] 2020yCat..22440043Z ['VizieR Online Data Catalog: Radial velocity measurements in LAMOST-II (Wang+, 2019)'] ['Wang, R.', 'Luo, A. -L.', 'Chen, J. -J.', 'Bai, Z. -R.', 'Chen, L.', 'Chen, X. -F.', 'Dong, S. -B.', 'Du, B.', 'Fu, J. -N.', 'Han, Z. -W.', 'Hou, J. -L.', 'Hou, Y. -H.', 'Hou, W.', 'Jiang, D. -K.', 'Kong, X.', 'Li, L. -F.', 'Liu, C.', 'Liu, J. -M.', 'Qin, L.', 'Shi, J. -R.', 'Tian, H.', 'Wu, H.', 'Wu, C. -J.', 'Xie, J. -W.', 'Zhang, H. -T.', 'Zhang, S.', 'Zhao, G.', 'Zhao, Y. -H.', 'Zhong, J.', 'Zong, W. -K.', 'Zuo, F.'] 2020yCat..22440027W ['VizieR Online Data Catalog: M-type stars in LAMOST DR5 (Zhong+, 2019)'] ['Zhong, J.', 'Li, J.', 'Carlin, J. L.', 'Chen, L.', 'Mendez, R. A.', 'Hou, J.'] 2020yCat..22440008Z ['VizieR Online Data Catalog: Metal-poor stars with APF. I. LAMOST CEMP stars (Mardini+, 2019)'] ['Mardini, M. K.', 'Li, H.', 'Placco, V. M.', 'Alexeeva, S.', 'Carollo, D.', 'Taani, A.', 'Ablimit, I.', 'Wang, L.', 'Zhao, G.'] 2020yCat..18750089M ['VizieR Online Data Catalog: Gaia and LAMOST DR4 M giant members of Sgr stream (Li+, 2019)'] ['Li, J.', 'Liu, C.', 'Xue, X.', 'Zhong, J.', 'Weiss, J.', 'Carlin, J. L.', 'Tian, H.'] 2020yCat..18740138L ['VizieR Online Data Catalog: GALEX and Gaia data for APOGEE red clump stars (Mohammed+, 2019)'] ['Mohammed, S.', 'Schiminovich, D.', 'Hawkins, K.', 'Johnson, B.', 'Wang, D.', 'Hogg, D. W.'] 2020yCat..18720095M ['VizieR Online Data Catalog: A combined Chandra & LAMOST study of stellar activity (He+, 2019)'] ['He, L.', 'Wang, S.', 'Liu, J.', 'Soria, R.', 'Bai, Z.', 'Yang, H.', 'Bai, Yu', 'Guo, J.'] 2020yCat..18710193H ['The impact of fiber fusion splicing on the focal ratio degradation and transmission of LAMOST fiber system'] ['Li, Jian', 'Lyu, Guanru', 'Wang, Shuqing', 'Hou, Yonghui'] 2020SPIE11203E..1GL ['Identification of Orbital Eclipses in LAMOST J024048.51+195226.9, a Candidate AE Aqr-type Cataclysmic Variable Star'] ['Littlefield, Colin', 'Garnavich, Peter'] 2020RNAAS...4..171L ['Focal surface attitude detection for LAMOST'] ['Hu, Tian-Zhu', 'Zhang, Yong', 'Cui, Xiang-Qun', 'Li, Ye-Ping', 'Pan, Xiu-Shan', 'Fu, Ying'] 2020RAA....20..181H ['Overview of the LAMOST-Kepler project'] ['Fu, Jian-Ning', 'Cat, Peter De', 'Zong, Weikai', 'Frasca, Antonio', 'Gray, Richard O.', 'Ren, An-Bin', 'Molenda-Żakowicz, Joanna', 'Corbally, Christopher J.', 'Catanzaro, Giovanni', 'Shi, Jian-Rong', 'Luo, A. -Li', 'Zhang, Hao-Tong'] 2020RAA....20..167F ['Contact binaries at different evolutionary stages'] ['Qian, Sheng-Bang', 'Zhu, Li-Ying', 'Liu, Liang', 'Zhang, Xu-Dong', 'Shi, Xiang-Dong', 'He, Jia-Jia', 'Zhang, Jia'] 2020RAA....20..163Q ['Eclipsing binary XZ CMi in a hierarchical quadruple system'] ['Wang, Zhi-Hua', 'Zhu, Li-Ying'] 2020RAA....20..133W ['A catalogue of Hα emission-line point sources in the vicinity fields of M 31 and M 33 from the LAMOST survey'] ['Zhang, Meng', 'Chen, Bing-Qiu', 'Huo, Zhi-Ying', 'Zhang, Hua-Wei', 'Xiang, Mao-Sheng', 'Yuan, Hai-Bo', 'Huang, Yang', 'Wang, Chun', 'Liu, Xiao-Wei'] 2020RAA....20...97Z ['ASAS J174406+2446.8 is identified as a marginal-contact binary with a possible cool third body'] ['Shi, Xiang-Dong', 'Qian, Sheng-Bang', 'Li, Lin-Jia', 'Na, Wei-Wei', 'Zhou, Xiao'] 2020RAA....20...96S ['Identification of temperature anomaly RR Lyrae stars in LAMOST survey, misclassification and binarities'] ['Li, Lin-Jia', 'Qian, Sheng-Bang', 'Zhang, Jia', 'He, Jia-Jia', 'Zhu, Li-Ying'] 2020RAA....20...94L ['Exploring the spectral information content in the LAMOST medium-resolution survey (MRS)'] ['Zhang, Bo', 'Liu, Chao', 'Li, Chun-Qian', 'Deng, Li-Cai', 'Yan, Tai-Sheng', 'Shi, Jian-Rong'] 2020RAA....20...51Z ['Defocus spot detection of astronomical optical system'] ['Hu, Tian-Zhu', 'Zhang, Yong', 'Cui, Xiang-Qun', 'Li, Ye-Ping', 'Bai, Hua', 'Pan, Xiu-Shan'] 2020RAA....20...41H ['Irregular changes in Hα emission line of V423 Aur observed by LAMOST Medium-Resolution Spectrographs'] ['Wu, Chao-Jian', 'Wu, Hong', 'Hsia, Chih-Hao', 'Zhang, Wei', 'Ren, Juan-Juan', 'Li, Guang-Wei', 'Chen, Jian-Jun', 'Yang, Fan', 'Shi, Jian-Rong', 'Hou, Yong-Hui', 'Liu, Ji-Feng'] 2020RAA....20...33W ['An Active Flexure Compensation Method for LAMOST spectrograph based on BP-Neural Network'] ['Huang, Shuo', 'Zou, Hua', 'Liu, Tian-Jiao', 'Zhao, Shi-Yu', 'Zhang, Hang'] 2020RAA....20...29H ['The Tsinghua University-Ma Huateng Telescopes for Survey: Overview and Performance of the System'] ['Zhang, Ji-Cheng', 'Wang, Xiao-Feng', 'Mo, Jun', 'Xi, Gao-Bo', 'Lin, Jie', 'Jiang, Xiao-Jun', 'Zhang, Xiao-Ming', 'Li, Wen-Xiong', 'Yan, Sheng-Yu', 'Chen, Zhi-Hao', 'Hu, Lei', 'Li, Xue', 'Lin, Wei-Li', 'Lin, Han', 'Miao, Cheng', 'Rui, Li-Ming', 'Sai, Han-Na', 'Xiang, Dan-Feng', 'Zhang, Xing-Han'] 2020PASP..132l5001Z ['Research and Application of Data Processing Technology on LAMOST Survey Spectra'] ['Chen, Shuxin'] 2020PASP..132i7001C ['Research on the Double-peaked Emission-line Galaxies from LAMOST Survey'] ['Wang, Mengxin'] 2020PASP..132f7001W
All query parameters passed in the search URL must be UTF-8, URL-encoded strings. Due to the requirements of the authentication library used for validating requests, most non-ASCII characters that appear in the URL need to be encoded; for example, the double quote character (\") should be encoded as %22. In most programming languages, such as Python, the libraries used to retrieve content from web services will do this encoding for you; however, if you're using curl
requests in the shell, such as shown in the examples in this notebook, you'll need to perform this encoding yourself.
Required The search query. This should be a UTF-8, URL-encoded string of <=1000 characters. q
accepts both fields (title:exoplanets
) and unfielded (exoplanets
) searches.
The number of results to return. The default is 10 and the maximum is 2000.
The starting point for returned results, used for pagination. The default is 0. To return the next page of results, set start
equal to the value of start
from the previous request, plus the number of results returned in the previous request. For the default values, set start=10
to return the second page of results.
The list of fields to return. The value should be a comma separated list of field names, e.g. fl=bibcode,author,title
. The default is the document id (fl=id
). A non-exhaustive list of available fields is shown below.
Filters the list of search results. The syntax is the same as that for the q
parameter. Adding search parameters via the fq
parameter can speed up search results, as it searches only the results returned by the search entered via the q
parameter, not the entire index. This parameter may be used more than once in a single search URL.
The sorting field and direction to be used when returning results. The format requires both the field to sort on (see the list below and the direction, either asc
or desc
(ascending or descending). For example, an appropriately formatted sort parameter is sort=citation_count+desc
. The default sort method is the relevancy score as calculated by the search engine. Other useful fields to sort on may be date
, read_count
, first_author
, or bibcode
."
This is a non-exhaustive list of fields available for searching via the API. A more comprehensive list is available in our help pages. These fields can be used with the fl
and sort
parameters.
Note: some fields, such as body, can be searched but not returned via fl
or sorted on. Also, multivalued fields, such as author, cannot be used for sorting.
abstract
- the abstract of the recordack
- the acknowledgements section of an articleaff
- an array of the authors' affiliationsalternate_bibcode
- list of alternate bibcodes for a single record; if a published record also has an arXiv version, the bibcode associated with the arXiv version is herealternate_title
- list of alternate titles for a single record (usually if they are in multiple languages)arxiv_class
- the arXiv class the pre-print was submitted toauthor
- an array of the author names associated with the recordbibcode
- the canonical ADS bibcode identifier for this recordbibgroup
- the bibliographic groups that the bibcode has been associated withbibstem
- the abbreviated name of the journal or publication, e.g., ApJ.body
* - the full text content of the articlecitation_count
- number of citations the item has receivedcopyright
- the copyright applied to the articledata
- the list of sources that have data related to this bibcodedate
- the machine-readable version of pubdate
, useful for sortingdatabase
- database the record is associated with (astronomy, physics, or general). By default, all three databases are searched; to limit to astronomy articles, add fq=database:astronomy
to the URLdoi
- the digital object identifier of the articledoctype
- the type of document it is (see here for a list of doctypes)first_author
- the first author of the articlegrant
- the list of grant IDs and agencies noted within an articleid
- a non-persistent unique integer for this record, used for fast look-up of a documentidentifier
- an array of alternative identifiers for the record. May contain alternate bibcodes, DOIs and/or arxiv ids.indexstamp
- time at which the document was (last) indexedissue
- issue the record appeared inkeyword
- an array of normalized and un-normalized keyword values associated with the recordlang
* - the language of the article's titleorcid_pub
- ORCiD iDs supplied by publishersorcid_user
- ORCiD iDs supplied by knonwn users in the ADSorcid_other
- ORCiD iDs supplied by anonymous users in the ADSpage
- starting pageproperty
- an array of miscellaneous flags associated with the record (see here for a list of propertiespub
- the canonical name of the publication the record appeared inpubdate
- publication date in the form YYYY-MM-DD (DD value will always be \00). This field is stored as a human-readable string, so is useful for being returned via fl
, but not for sorting (see date
)read_count
- number of times the record has been viewed within in a 90-day windows (ads and arxiv)title
- the title of the recordvizier
- the subject tags given to the article by VizieRvolume
- volume the record appeared inyear
- the year the article was published
* These fields are only indexed and so are only searchable - they are not stored or returned by the search end point, if requested
%%bash
token="0zry67QTNPCJwq19xD8wXHsBh3TYsnukaKWuZsgc"
# download the publisher PDF
curl -H "Authorization: Bearer $token" \
'https://ui.adsabs.harvard.edu/link_gateway/1998AJ....116.1009R/PUB_PDF' \
-L -o '1998AJ....116.1009R.pdf'
from urllib import request
header = {"Authorization": "0zry67QTNPCJwq19xD8wXHsBh3TYsnukaKWuZsgc"}
url = "https://ui.adsabs.harvard.edu/link_gateway/2015RAA....15.1095L/EPRINT_PDF"
req = request.Request(url, headers=header)
response = request.urlopen(req)
data = response.read()
with open('2015RAA....15.1095L.pdf', 'wb') as f:
f.write(data)
header = {"Authorization": "0zry67QTNPCJwq19xD8wXHsBh3TYsnukaKWuZsgc"}
url = "https://ui.adsabs.harvard.edu/link_gateway/2015RAA....15.1095L/PUB_PDF"
req = request.Request(url, headers=header)
response = request.urlopen(req)
data = response.read()
with open('2015RAA....15.1095L.pdf', 'wb') as f:
f.write(data)