Skip to main content

​
GET /api/ports

Container and cargo volume data for US ports. Includes TEU throughput, year-over-year trends, and vessel calls. Query parameters
NameTypeRequiredDefaultDescription
port_slugstring✓Port slug (e.g. la-lb, savannah, houston, newark, oakland).
monthsint12Months of historical data.
Example 
curl "https://axiomlocus.io/api/ports?port_slug=la-lb&months=6"
Response 
{
  "port_slug": "la-lb",
  "port_name": "Port of Los Angeles / Long Beach",
  "latest_teu": 892000,
  "yoy_change_pct": 8.4,
  "monthly": [
    { "month": "2026-03", "teu": 892000, "vessel_calls": 142 },
    { "month": "2026-02", "teu": 845000, "vessel_calls": 138 },
    { "month": "2026-01", "teu": 801000, "vessel_calls": 131 }
  ]
}
FieldTypeDescription
latest_teuintMost recent month’s TEU (twenty-foot equivalent unit) volume.
yoy_change_pctfloatYear-over-year percentage change.
monthlyarrayMonthly volume breakdown.
monthly[].vessel_callsintNumber of vessel arrivals that month.

​
GET /api/construction

Satellite-detected construction activity in a metro. Uses change detection on Sentinel-2 imagery to identify active sites. Query parameters
NameTypeRequiredDefaultDescription
metro_slugstring✓Metro slug.
daysint30Lookback window in days.
min_area_sqftint5000Minimum detected site area in sq ft.
Example 
curl "https://axiomlocus.io/api/construction?metro_slug=austin&days=60"
Response 
{
  "metro": "austin",
  "days": 60,
  "total_detections": 34,
  "detections": [
    {
      "h3_index": "882a107a0bfffff",
      "center_lat": 30.2672,
      "center_lng": -97.7431,
      "estimated_area_sqft": 45000,
      "confidence": 0.91,
      "first_detected": "2026-02-15",
      "last_detected": "2026-03-28",
      "nearest_permit_id": "P-2025-9876"
    }
  ]
}
FieldTypeDescription
total_detectionsintNumber of detected active construction sites.
detections[].estimated_area_sqftintEstimated site footprint in square feet.
detections[].confidencefloatDetection confidence score (0-1).
detections[].nearest_permit_idstringCross-referenced building permit if matched.