Papertrack Public Search API¶
-
POST
/public_search/public-search
¶ Decodes JSON into parameters to search the papertrack database then returns JSON results
- Status Codes
200 OK – No error
400 Bad Request – Incorrect params
Example request
POST /api/v0.1/public_search/ HTTP/1.1 Host: mast.stsci.edu
{ "mission": "HST", "instruments": ["ACS"], "papertypes": ["SCIENCE"], "authors": "Bruch", "first_author": true, "titles": "Luminosity Galaxy Clusters", "publication_years": "2010", "bibstems": "ApJ", "bibcodes": "%608B", "hst_programs": "10152", "jwst_programs": "", "archival_flag": "GO", "pagesize": 10, "page": 0 }
Example response
[ { "bibcode": "2010ApJ...724..608B", "title": "XMM-NEWTON Observations of Three Low X-ray Luminosity Galaxy Clusters", "citation_count": 3, "doi": null, "publication_date": "2010-11-01T00:00:00", "journal": "The Astrophysical Journal (ApJ)", "hst_archival_flag": "GO", "jwst_archival_flag": null, "first_author": "Bruch, Seth", "coauthors": [ "Donahue, Megan", "Voit, G. Mark", "Sun, Ming", "Conselice, Christopher J." ], "missions": [ "HST", "XMM" ], "instruments": [ "ACS" ], "papertypes": [ "SCIENCE" ], "program_ids": [ "10152" ] } ]
Arguments:
- mission
string
- authors
string, semicolon separated
- first_author
boolean, True to limit author search to first authors only
note: ignored if nothing passed in to authors
- instruments
list of strings
note: performs an OR search
- papertypes
list of strings SCIENCE DATA_INFLUENCED SUPERMENTION
note: performs an OR search
- titles
String, comma separated
- publication_years
String publication years (e.g 2012) or ranges (e.g. 2012..2014) separated by commas.
- bibstems
ADS Journal Abbrev
- bibcodes
bibcodes 2006ApJS..167..161K use % as a wild card %ApJS%167%
- hst_programs
HST Program IDs
- jwst_programs
JWST Program IDs
- archival_flag
List of strings contains: “Any” “GO” “AR” “Part” “Unassigned”
- pagesize
Integer or null, default 100
- page
Integer, default 0
- format
String either: “csv” or “json”, default “json”
Returns:
- bibcode
string
- first_author
string
- coauthors
list of strings
- title
string
- citation_count
integer
- publication_date
string (“%Y-%m-%dT%H:%M:%S”)
- missions
list of strings
- instruments
list of strings
- papertypes
list of strings
- doi
string or none
- journal
string
- program_ids
list of strings
- hst_archival_flag
string or None
- jwst_archival_flag
string or None