gettbl v4

The gettbl API retrieves GIMMS/GLAM 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
format string The output format. Can be either text or csv. Default is text. optional
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
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
mcv number Minimum cumulative value - the minimum NDVI value to accumulate. Valid range is 0.0-1.0. required if ts_type=
cumulative
num_months number The number of months. Valid range is 1-12. Default is: 12. optional
sat string The satellite name. Can be VJ1, OS3 or VO3. required
shape string The vector shape name. Can be either ADM or LIS. required
start_month number The start month. Valid values are 1-12. Default is: 1. optional
ts_type string The time series type. Can be one of seasonal, cumulative, or historical. required
version string The database version in the format: v<number>.
Default is the latest version: v17.1. See DB releases.		 optional
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=2025&years2026.
Default is all years.		 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=VJ1&version=v17.1&layer=NDVI&mask=USGS-NLCD_2021_crops&shape=ADM&ids=110955&ids=110961&ts_type=seasonal&years=2025&years=2026&start_month=4&num_months=8&format=csv

curl GET

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

curl POST

curl https://glam1.gsfc.nasa.gov/api/gettbl/v4 \
 -d "version=v17.1" \
 -d "sat=VJ1" \
 -d "layer=NDVI" \
 -d "mask=USGS-NLCD_2021_crops" \
 -d "shape=ADM" \
 -d "ids=110955" \
 -d "years=2025" \
 -d "years=2026" \
 -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=v17.1&sat=VJ1&mask=USGS-NLCD_2021_crops&shape=ADM&ids=110955&years=2025&years=2026&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=v17.1&sat=VJ1&mask=USGS-NLCD_2021_crops&shape=ADM&ids=110955&years=2025&years=2026&start_month=4&num_months=8&ts_type=seasonal&format=csv"

wget POST

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