Data API & Schema

Static JSON endpoints — no auth required. Updated on every build.

Static endpoint table

RouteFormatDescription
/data/stranded-sites.geojsonGeoJSON2,611 site FeatureCollection (ECCC + coords)
/data/live-stats.jsonJSONBuild aggregates, top sites, impact, value model, version
/data/sites.jsonJSONLegacy/summary site list (if present)
/status.jsonJSONHealth, version, site count, build metadata
/manifest.jsonJSONPWA manifest and shortcuts
/sitemap.xmlXMLCrawlable route index
/robots.txttextCrawler rules

Map URL query parameters

Deep-link filters and site focus on /map. Combine params as needed.

ParamTypeDescription
sitestringFocus map on a site by ghgrp_id / id (e.g. G10161)
provincestringFilter to one province (e.g. Alberta)
provincesstringComma-separated province list
minScorenumberMinimum Stranded Score (0–100)
minEmissionnumberMinimum emission kg CH₄/day
maxEmissionnumberMaximum emission kg CH₄/day
sourcesstringComma-separated source_type values
missionstringComma-separated site IDs to load into mission portfolio
radiusnumberRadius filter in km (requires lat + lng)
latnumberRadius center latitude (WGS84)
lngnumberRadius center longitude (WGS84)

Example: /map?province=Alberta&minScore=80

GET /data/stranded-sites.geojson

2,611 FeatureCollection. Key properties:

  • emission_rate_kg_day — daily methane vent rate
  • province, source_type, confidence
  • ch4_tonnes_year, distance_to_grid_km
  • ghgrp_id — unique site identifier

GET /data/live-stats.json

Auto-generated aggregates: provinces, gensets, impact, top sites, value model.

provinces[] fields

FieldTypeDescription
namestringFull province name (e.g. Alberta)
countnumberNumber of sites in province
pctnumberShare of total site count (%)

Also includes totals, impact, valueModel, topSites, emissionTiers, confidenceCounts, and generatedAt.

GET /status.json

Health check: version, build time, site count.

curl examples

# Download full GeoJSON dataset
curl -sS https://stranded.giveabit.io/data/stranded-sites.geojson \
  -o stranded-sites.geojson

# Fetch live build aggregates
curl -sS https://stranded.giveabit.io/data/live-stats.json | jq '.siteCount, .totals.avgStrandedScore'

# Province breakdown
curl -sS https://stranded.giveabit.io/data/live-stats.json | jq '.provinces[] | {name, count, pct}'

# Health / version
curl -sS https://stranded.giveabit.io/status.json | jq '.'

Source: ECCC Open Data

Try it on the map →