Public API
Every chart on this site is built on a versioned REST API. The API is free to use with attribution — no signup, no API key, no paywall. Built for NGOs, cooperatives, educators, journalists and small procurement teams that can't afford a Bloomberg terminal.
Call any /api/v1/* endpoint directly. No signup wall, no usage tier.
Generous for real use, strict enough to keep the service up for everyone.
Free to redistribute + build on, as long as you credit "spatialsusty.com".
Anywhere the data is shown (site, paper, dashboard, report) include one of the following near the figure:
Source: Value Distribution — Commodity Intelligence (spatialsusty.com), CC BY 4.0
// …or the inline form:
powered by spatialsusty.comThe platform only aggregates data — every underlying dataset carries its own licence (e.g. FAOSTAT is CC BY-NC-SA 3.0 IGO; World Bank Pink Sheet is CC BY 4.0). When you redistribute raw numbers you inherit those licences.
Spot price series, country-level production/export metrics, global choropleth data.
/api/v1/pricesMonthly spot prices across cocoa, coffee, vanilla.
curl https://spatialsusty.com/api/v1/prices?commodity=cocoa&from_date=2024-01-01&to_date=2024-12-31/api/v1/countries/{iso2}/summaryTop-line country metrics — production, export value, global share.
curl https://spatialsusty.com/api/v1/countries/GH/summary?commodity=cocoa&year=2024/api/v1/countries/{iso2}/value-chainPer-stage value split (farmer / processor / exporter / retailer %).
curl https://spatialsusty.com/api/v1/countries/CI/value-chain?commodity=cocoa&year=2024/api/v1/global/mapGlobal choropleth data for any metric × commodity × year.
Supply-chain risk scoring, EUDR readiness, sourcing scorecards, price alerts, and the executive brief.
/api/v1/risk-intel/executive-briefOne-screen morning brief — prices, balance, top origin, EUDR countdown.
/api/v1/risk-intel/executive-brief.htmlSame brief, rendered as standalone HTML for email / print-to-PDF.
/api/v1/risk-intel/executive-brief.pdfSame brief, rendered as a binary PDF (board packs, regulatory filings).
/api/v1/risk-intel/price-alertSpot price vs 3-year rolling average, classified into a procurement alert.
/api/v1/risk-intel/sourcing-scorecardMulti-dimensional origin scorecard (EUDR / forest / wage / traceability / stability / weather).
/api/v1/risk-intel/income-simulatorSimulate farm-gate price increases against the living-income benchmark.
/api/v1/risk-intel/counterfactual-incomeIf Fairtrade minimums had tracked inflation, where would farmers be today?
/api/v1/risk-intel/labor-riskUSDOL child / forced labor flags per commodity × origin (2024 edition).
curl https://spatialsusty.com/api/v1/risk-intel/labor-risk?commodity=cocoa&country=CI/api/v1/risk-intel/fx-impactCumulative local-currency depreciation vs USD — the wedge USD coverage hides.
curl https://spatialsusty.com/api/v1/risk-intel/fx-impact?commodity=cocoa&country=GH&since_year=2020/api/v1/risk-intel/conflicts-publicPublic ledger of inter-source disagreements. Transparency moat.
/api/v1/risk-intel/alternative-originsDiversification candidates ranked by composite sourcing scorecard.
curl https://spatialsusty.com/api/v1/risk-intel/alternative-origins?commodity=cocoa¤t=CI&limit=5/api/v1/risk-intel/supply-eventsLive supply-risk news (GDELT) — drought, strike, port closure, embargo, disease, etc. 15-min refresh.
curl https://spatialsusty.com/api/v1/risk-intel/supply-events?commodity=cocoa&since_hours=168/api/v1/risk-intel/country-macroOrigin macro backdrop from the World Bank Indicators API — GDP/capita, inflation, poverty, rural share.
curl https://spatialsusty.com/api/v1/risk-intel/country-macro?country=GH/api/v1/risk-intel/deforestation-timelineAnnual tree-cover loss per origin, EUDR cutoff-referenced.
/api/v1/risk-intel/certification-premiumFairtrade / Organic / Rainforest Alliance premia vs conventional baseline.
/api/v1/risk-intel/due-diligence-reportEUDR-style aggregated report for a commodity × origin.
Product archetypes, retail-price lookup, regulatory radar, authoritative-source signals.
/api/v1/products/archetypesCatalog of product archetypes with per-stage cost breakdowns.
/api/v1/products/filter-optionsFilter dimensions available for product lookup (markets, segments, certifications, …).
/api/v1/procurement/weather-outlook16-day ECMWF weather forecast aggregated across origin centroids.
/api/v1/procurement/regulatory-eventsEUR-Lex + USTR regulatory radar, provenance-tagged.
Liveness + data freshness indicators.
/api/v1/healthLiveness probe (no DB).
/api/v1/health/readyReadiness probe — DB + pool + anti-scrape stats.
Drop a live widget onto any co-op, NGO or blog page.
<iframe
src="https://spatialsusty.com/embed/price-alert?commodity=cocoa"
width="480" height="140" frameborder="0"
title="Cocoa price alert"></iframe>
<iframe
src="https://spatialsusty.com/embed/income-gap?commodity=cocoa&country=CI"
width="480" height="220" frameborder="0"
title="Living income gap — Côte d'Ivoire cocoa"></iframe>Widgets inherit this site's data freshness guarantees and update automatically whenever the underlying datasets update.
A one-page summary of commodity risk across cocoa, coffee and vanilla, delivered Monday morning. Unsubscribe in one click.
No spam, no trackers, no resold lists. Subscribers are stored in our own database (see Privacy).