Papertrack Public Search API

POST /public_search/public-search

Decodes JSON into parameters to search the papertrack database then returns JSON results

Status Codes:

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
String either: “Any” “GO” “AR” “Part” “Unassigned”
pagesize
Integer, default 100, max 1000
page
Integer, default 0

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