Eutrophication Watch API
Time-series chlorophyll-a trends, composited tiles, CEP classes, and PDF report export — powered by Google Earth Engine.
Base URL: https://api.eutrophicationwatch.orgAll endpoints under: /api/Authentication
JWT Bearer Token
Required for all /api/timeseries/ endpoints. Pass as:
Authorization: Bearer <access_token>
Access tokens valid for 24 hours. Refresh tokens valid for 7 days.
Client Credentials
For /api/regional_cep/client/. Pass your client ID and secret as headers:
X-Client-Id: <your-client-id> X-Client-Secret: <your-client-secret>
Endpoints
/api/timeseries/JWTPoint-based annual maximum chlorophyll-a time series with Mann-Kendall trend and CEP classification.
| Param | Type | Notes |
|---|---|---|
latitude | float | Required |
longitude | float | Required |
start_year | int | Required |
end_year | int | Required |
satellite_sensor | string | Required. See sensor list. |
threshold | int | Default: 5 |
data_asset | string | Custom GEE asset path |
/api/timeseries/file/JWTRegional analysis using uploaded boundary file or raw GeoJSON string.
Accepts shape_file (zip/KML/GeoJSON) or geojson_string. Returns time series, tile URLs, CEP pixel distribution, and GeoTIFF.
curl -X POST "https://api.eutrophicationwatch.org/api/timeseries/file/" \ -H "Authorization: Bearer <token>" \ -F "latitude=35.6" -F "longitude=140.1" \ -F "start_year=2018" -F "end_year=2024" \ -F "satellite_sensor=SGLI/GCOM-C" \ -F "geotiff_download=true" \ -F "shape_file=@region.zip"
/api/timeseries/file/export/pdf/JWTNEWRuns the same regional analysis as /api/timeseries/file/ and generates a Chesapeake Bay Report Card–style PDF (SDG 14.1.1a Assessment Report). Returns all standard JSON fields plus pdf_download_link.
| Field | Type | Notes |
|---|---|---|
| All fields from /api/timeseries/file/, plus: | ||
region_name | string | Region label in report header. Default: "Selected Region". |
ai_summary | string | User-edited AI insight embedded in the report. Auto-generated if omitted. |
curl -X POST "https://api.eutrophicationwatch.org/api/timeseries/file/export/pdf/" \ -H "Authorization: Bearer <token>" \ -F "latitude=38.9" -F "longitude=-76.4" \ -F "start_year=2018" -F "end_year=2024" \ -F "satellite_sensor=SGLI/GCOM-C" \ -F "region_name=Chesapeake Bay" \ -F "shape_file=@chesapeake.geojson"
/api/regional_cep/client/Client headersSame as /api/timeseries/file/ but authenticated via X-Client-Id / X-Client-Secret headers instead of JWT. Accepts both shape_file and geojson_string.
Reference
Satellite Sensors
| Value | Description | From |
|---|---|---|
MODIS/Aqua | MODIS Aqua chlorophyll-a | 2003 |
SGLI/GCOM-C | JAXA GCOM-C SGLI | 2018 |
SeaWiFS | SeaWiFS ocean colour | 1998 |
YOC (Blended CHL Dataset) | Blended multi-sensor dataset | — |
YOC+SGLI | YOC blended + SGLI | — |
esa_cci | ESA CCI Ocean Colour | 1998 |
userAsset | Custom GEE asset (requires data_asset) | — |
CEP Classes
| Class | Label | Meaning | Colour |
|---|---|---|---|
| 1 | LD | Low Decreasing | |
| 2 | LN | Low No-trend | |
| 3 | LI | Low Increasing | |
| 4 | HD | High Decreasing | |
| 5 | HN | High No-trend | |
| 6 | HI | High Increasing — highest concern |
Response status semantics
| Value | Meaning |
|---|---|
completed | All shape splits downloaded successfully (split_percentage = 100%). |
incomplete | Some splits failed; GeoTIFF may have gaps. |
failed | No tiles were downloaded. |
Large regions are automatically split into tiles for GEE processing. split_percentage reflects how many tiles were successfully retrieved (-1 if none were attempted).
Methodology: Maúre et al. (2021) Nature Communications — doi:10.1038/s41467-021-21921-3