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

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