gettbl v4

The gettbl API retrieves GIMMS/GLAM MODIS 250-m, VIIRS 500-m and OLCI 300-m NDVI time-series database tables.

This is the latest version, released on 2023-01-27.

ENDPOINTS

 GET https://glam1.gsfc.nasa.gov/api/gettbl/v4
 POST https://glam1.gsfc.nasa.gov/api/gettbl/v4

PARAMETERS

Name Type Description
version string The database version in the format: v<number>.
Default is the latest version: v16.1. See DB releases.		 optional
sat string The satellite name. Can be MOD, MYD, VNP or OS3. required
layer string The layer name. Default is NDVI. optional
mask string The land or crop mask ID name. See list of mask names by DB version.
For example: USGS-NLCD_2021_crops.
Default is the land mask.		 optional
shape string The vector shape name. Can be either ADM or LIS. required
ids number or string The ADM or LIS shape ID. For example, ADM ID: 1234, LIS ID: 0122_494.
Can be specified more than once to form a list of ADM or LIS IDs. For example, ids=1234&ids=2345. See list of ADM shape IDs.		 required
years number The years in 4 digit format. For example, 2025.
Can be specified more than once to form a list of years. For example, years=2024&years2025.
Default is all years.		 optional
start_month number The start month. Valid values are 1-12. Default is: 1. optional
num_months number The number of months. Valid range is 1-12. Default is: 12. optional
mcv number Minimum cumulative value - the minimum NDVI value to accumulate. Valid range is 0.0-1.0. required if ts_type=
cumulative
ts_type string The time series type. Can be one of seasonal, cumulative, or historical. required
format string The output format. Can be either text or csv. Default is text. optional

RETURNS

Plain-text or CSV formatted file.

STATUS CODES

Code Reason
200 OK
400 Bad Request
500 Internal error

EXAMPLES

URL GET

https://glam1.gsfc.nasa.gov/api/gettbl/v4?sat=MOD&version=v16.1&layer=NDVI&mask=USGS-NLCD_2021_crops&shape=ADM&ids=110955&ids=110961&ts_type=seasonal&years=2023&years=2024&start_month=4&num_months=8&format=csv

curl GET

curl -o output.csv "https://glam1.gsfc.nasa.gov/api/gettbl/v4?version=v16.1&sat=MOD&mask=USGS-NLCD_2021_crops&shape=ADM&ids=110955&years=2023&years=2024&start_month=4&num_months=8&ts_type=seasonal&format=csv"

curl POST

curl https://glam1.gsfc.nasa.gov/api/gettbl/v4 \
 -d "version=v16.1" \
 -d "sat=MOD" \
 -d "layer=NDVI" \
 -d "mask=USGS-NLCD_2021_crops" \
 -d "shape=ADM" \
 -d "ids=110955" \
 -d "years=2023" \
 -d "years=2024" \
 -d "start_month=4" \
 -d "num_months=8" \
 -d "ts_type=seasonal" \
 -d "format=csv" \
 -o output.csv

Alternatively,

curl -o output.csv -d "version=v16.1&sat=MOD&mask=USGS-NLCD_2021_crops&shape=ADM&ids=110955&years=2023&years=2024&start_month=4&num_months=8&ts_type=seasonal&format=csv" https://glam1.gsfc.nasa.gov/api/gettbl/v4

wget GET

wget -O output.csv "https://glam1.gsfc.nasa.gov/api/gettbl/v4?version=v16.1&sat=MOD&mask=USGS-NLCD_2021_crops&shape=ADM&ids=110955&years=2023&years=2024&start_month=4&num_months=8&ts_type=seasonal&format=csv"

wget POST

wget -O output.csv --post-data 'version=v16.1&sat=MOD&mask=USGS-NLCD_2021_crops&shape=ADM&ids=110955&years=2023&years=2024&start_month=4&num_months=8&ts_type=seasonal&format=csv' https://glam1.gsfc.nasa.gov/api/gettbl/v4