For developers

A free Gulf Coast conditions API

We collect live beach conditions, events, and local data for Perdido Key (FL) and Orange Beach (AL), and we hand it back as clean JSON. Free, CORS-enabled, no key required. Build a dashboard, a bot, a kiosk — whatever's useful.

All endpoints return JSON, send Access-Control-Allow-Origin: * (call them straight from the browser), and are edge-cached so you can hit them freely. Base URL: https://perdidokeyog.com.

GET /api/beach-today

Live conditions for both sides of the line — beach flag color, wind, water & air temp, tide state, and sunrise/sunset. Updated continuously by our data robot.

{
  "fl": {
    "side": "FL",
    "capturedAt": "2026-06-18T11:55:38.857Z",
    "flagColor": "red",
    "windMph": 20, "windDir": "S",
    "waterTempF": 82, "airTempF": 84,
    "tideState": "rising",
    "nextTideAt": "2026-06-18T19:23:00Z",
    "nextTideType": "high",
    "sunrise": "2026-06-18T10:47:33Z",
    "sunset":  "2026-06-19T00:53:25Z"
  },
  "al": { "side": "AL", "flagColor": "double-red", ... }
}

GET /api/events

Upcoming events (next ~60 days) — concerts, live music, festivals, tournaments — from The Wharf, Flora-Bama, and the Visit Perdido chamber.

Params: ?range=today | this-week · ?side=FL | AL

{
  "events": [
    {
      "title": "J Hawkins Duo",
      "startsAt": "2026-06-18T17:00:00Z",
      "endsAt":   "2026-06-18T20:00:00Z",
      "venueName": "Flora-Bama — Main Room",
      "side": "FL",
      "url": "https://...",
      "categories": ["Live Music"],
      "cost": null
    }
  ],
  "generatedAt": "2026-06-18T12:00:00Z"
}

GET /api/history

Daily aggregates for every recorded day — water/air temp, max wave, wind, and the flags seen that day. The data behind our Beach Report archive.

{
  "days": [
    {
      "day": "2026-06-17",
      "water": 82, "air": 84,
      "maxWave": 2.3, "wind": 11,
      "flags": "yellow,red",
      "n": 240
    }
  ]
}

GET /api/news

Recent local/regional news headlines we aggregate for the Gulf Coast, with source, link, and summary.

{
  "news": [
    {
      "source": "fox10",
      "sourceName": "FOX10 News",
      "title": "…",
      "link": "https://…",
      "summary": "…",
      "imageUrl": "https://…"
    }
  ]
}

Feeds

/drift/feed.xml — The Drift (RSS). Daily columns, the Salt Line, fishing reports.
/events/feed.ics — Events (iCalendar). Subscribe in any calendar app.
/llms.txt — AI map (llms.txt). Curated source map for AI answer engines.
/sitemap-index.xml — Sitemap. Every indexable page.

Fair use

It's free and we want you to use it. Two asks: credit "Perdido Key OG" with a link where the data appears, and cache responses rather than hammering the endpoints (the data only changes every few minutes). The data is provided as-is with no warranty — don't use it as the sole input for life-safety decisions; the live Beach Today page and official lifeguard flags are authoritative.

Building something cool, or want a field we don't expose yet? Tell us.