The forum is locked.

The Ocean Color Forum has transitioned over to the Earthdata Forum (https://forum.earthdata.nasa.gov/). The information existing below will be retained for historical reference. Please sign into the Earthdata Forum for active user support.

Up Topic Frequently Asked Questions / Data Access FAQ / Can I search for data non-interactively? (locked)
- By seanbailey Date 2009-09-15 15:33 Edited 2018-11-30 19:58
Can I search for data non-interactively?

Yes.  The file search utility can be accessed non-interactively.

The script takes the following options:

    usage : returns this message (valid values: 0, 1; default = 0)
    sensor: mission name. 
             valid options include:
             aquarius, seawifs, aqua, terra, meris, octs, czcs, hico, viirs
    sdate : start date to limit the search (format YYYY-MM-DD)
    edate : end date to limit the search (format YYYY-MM-DD)
    psdate : file processing start date for a search (format YYYY-MM-DD)
    pedate : file processing end date for a search (format YYYY-MM-DD)
    dtype : data type (i.e. level).
            valid options:
            L0, L1, L2, L3b (for binned data), L3m (for mapped data),
            MET (for ancillary data), misc (for sundry products)
    addurl: include full url in search result (boolean, 1=yes, 0=no)
    results_as_file : return results as a test file listing
            boolean, 1=yes, 0=no (returns an HTML page)
    search: a search pattern string
    subID : generate a listing of files that match a non-extracted subscription ID
    std_only : restrict results to standard products
            (i.e. ignore extracts, regional processings, etc.; boolean)
     subType: subsciption type, valid options are:
         1 - non-extracted (default)
         2 - extracted
     chksum: return a checksum file for search results
             expects boolean
             return sha1sum except for Aquarius soil moisture products, which are md5sum
             forces results_as_file
             ignores addurl
     format: valid options are:
             txt - returns as plain text
            json - returns results as JSON objects
            html - returns results as an HTML page


To use the script non-interactively, you need to craft a URL using the options listed above.

For example, to search for Aqua L1 data matching the pattern "A2009201":

    https://oceandata.sci.gsfc.nasa.gov/api/file_search?search=A2009201*&dtype=L1&sensor=aqua&results_as_file=1&addurl=1&std_only=1

At a minimum,  a search pattern OR start date is required.
If an end date is defined, a start date must be defined.
Up Topic Frequently Asked Questions / Data Access FAQ / Can I search for data non-interactively? (locked)