Developer API

Build with planetary risk intelligence.

Send the same natural-language risk questions users ask inside PAP.EARTH and receive the same live-source forecast payload the dashboard paints from.

POST/api/v1/risk·JSON in, Earth + forecast out

One request, one room.

curl -X POST https://www.pap.earth/api/v1/risk \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Assess flood and heat risk for a logistics warehouse in Lagos over the next month",
    "horizon": "30d",
    "decisionLens": "business-setup",
    "alert": {
      "enabled": true,
      "metric": "severity",
      "threshold": 50,
      "channels": [{ "type": "webhook", "target": "https://example.com/pap-alerts" }]
    }
  }'
promptRequired

A place-based risk question, exactly like the app's search box.

hazardOptional

earthquake, flood, wildfire, heat, storm, air-quality, drought, food-insecurity, conflict.

horizonOptional

7d, 30d, 1y, 10y, 30y. Short windows recommended for operational use.

decisionLensOptional

community-planning, family-relocation, business-setup, travel, investment.

alert.*Optional

Create a scheduled watch on the same forecast engine — thresholds, correlated hazards, webhook/Slack/Telegram/email channels.

The track record is public.

Every short-horizon, verifiable forecast is logged and scored against observed outcomes — USGS for earthquakes, NASA EONET for floods, fires, and storms. GET /api/v1/track-record is open, no key required. Audit us.

Reliability — predicted vs observed
Brier score (lower is better)0.000
Base-rate baseline0.211
Skill vs baseline0%better
Forecasts resolved0/ 128 logged
Per-hazard Brier
Earthquake
0.09
Flood
0.18
Wildfire
0.14

Keys & quotas.

Anonymous calls work out of the box. Add an X-PAP-API-Key header for higher tiers — usage headers return on every response, quotas reset daily at 00:00 UTC.

Anonymous

15 req/day

No key. Rate-limited per IP. Trials and demos.

Free

100 req/day

pap_live_ key. Prototypes and low-volume apps.

Pro

5,000 req/day

Production dashboards and products.

Enterprise

Custom

High-volume quota. Contact for provisioning.

A live badge, anywhere.

Drop an auto-updating risk badge onto any page with one <img> tag. SVG, edge-cached 15 minutes.

<img src="https://www.pap.earth/api/v1/embed?lat=6.45
  &lng=3.40&hazard=flood&horizon=30d&label=Lagos"
  width="320" height="120" />

Connect your AI assistant

pap.earth exposes live risk intelligence via MCP at https://www.pap.earth/mcp. Tools: get_risk, get_track_record, create_watch.

// Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "pap-earth": {
      "url": "https://www.pap.earth/mcp"
    }
  }
}

// Cursor — MCP settings
{
  "mcpServers": {
    "pap-earth": {
      "url": "https://www.pap.earth/mcp"
    }
  }
}