Surf-Forecast-API: 5.000+ bewertete Spots

Was die API liefert

Eine echte Spot-Datenbank

5.000+ benannte Surfspots weltweit, mit Koordinaten und Land, suchbar nach Name oder Position. Keine Gitterpunkte: die echten Breaks, die Surfer kennen.

Vorhersagen bewertet nach Level

Sieben Tage Wellen, Wind und Tide im Stundentakt für jeden Spot, plus eine einfache Skala für Anfänger, Fortgeschrittene und Könner. Dieselbe Engine wie in der App.

Tide inklusive

Hoch- und Niedrigwasser für jeden Spot, berechnet aus harmonischen Konstituenten. Kein zweites Abo für einen Tidendienst.

Spots suchen, Forecasts holen, Tide lesen

Einfache GETs, ein API-Key. Das ist der ganze Flow.

surfmap ~ zsh

GET /v1/spots
GET /v1/spots/nearby
GET /v1/spots/{id}
GET /v1/spots/{id}/forecast
GET /v1/spots/{id}/tides

Beispieldaten. Die Antwortformen sind echt.

Format: JSON über HTTPS
Auth: API-Key im Header
Versionen: /v1 vom ersten Tag an
Einheiten: Metrisch, Zeiten in UTC
Aktualität: Vorhersagen zweimal täglich aktualisiert
Horizont: 7 Tage, stündlich

Ein Call, das ganze Bild

Stabiles JSON, versioniert vom ersten Tag an. So sieht eine Forecast-Antwort aus.

GET https://api.surf-map.com/v1/spots/anchor-point/forecast

{
  "spot": { "id": "anchor-point", "name": "Anchor Point", "country": "Morocco" },
  "units": "metric",
  "hours": [
    {
      "time": "2026-08-09T08:00Z",
      "waveHeight": 1.8, "wavePeriod": 12, "waveDirection": 305,
      "windSpeed": 7, "windDirection": 71,
      "tide": { "height": 1.2, "state": "rising" },
      "rating": { "beginner": 2, "intermediate": 4, "advanced": 4 }
    }
  ]
}

SDK, MCP-Server, Doku für deine Tools

Ob du jede Zeile selbst schreibst oder dein Coding-Agent tippt: die Integration sollte Minuten dauern, keinen Sprint.

Ein TypeScript-SDK

Ein typisierter Client für Node und Serverless: Spots suchen, Forecasts holen, Autocomplete auf jedem Feld. Einmal installieren, kein Boilerplate.

Ein MCP-Server

Verbinde SurfMap mit Claude Code, Cursor oder jedem MCP-Client: dein Coding-Agent schlägt Spots nach und holt bewertete Vorhersagen, während er für dich baut.

Doku, auch für Maschinen

Eine OpenAPI-Spec und eine llms.txt für die API vom ersten Tag an. Zeig deinem Assistenten eine URL und er kennt jeden Endpoint, jedes Feld, jede Einheit.

quickstart.ts

import { SurfMap } from '@surfmap/sdk';

const surfmap = new SurfMap({
  apiKey: process.env.SURFMAP_API_KEY,
});

const [spot] = await surfmap.spots.search({
  q: 'hossegor',
});
const forecast = await surfmap.forecast.get(spot.id);

// rated 1 to 5 for each level
forecast.hours[0].rating.intermediate; // 4

.mcp.json

{
  "mcpServers": {
    "surfmap": {
      "type": "http",
      "url": "https://api.surf-map.com/mcp"
    }
  }
}

Für wen das ist

Surf-Apps und Side-Projects, Surfschulen und Camps, die Live-Bedingungen auf ihrer Website wollen, Reiseplattformen, Watchfaces und Dashboards. Wenn das Ende der Magicseaweed-API dein Projekt gestrandet hat, ist das hier der Ersatz, den wir uns damals gewünscht hätten.

Preise

Monatliche Pläne mit klaren Limits. Starte in der Größe, die passt, und steig um, wenn dein Traffic wächst.

Starter

39 $pro Monat

Deine erste App in Produktion.

500 Calls am Tag
60 Calls pro Minute
2 API-Keys
Eine App in Produktion
Attribution mit Link
Support per E-Mail

Growth

99 $pro Monat

Eine App mit echtem Traffic.

2.500 Calls am Tag
120 Calls pro Minute
5 API-Keys
Mehrere Apps
Attribution mit Link
Support mit Priorität

Pro

249 $pro Monat

Volles Volumen, nur dein Branding.

10.000 Calls am Tag
300 Calls pro Minute
10 API-Keys
Apps und interne Tools
Keine Attribution nötig
Ein direkter Draht zu uns

Scale

Individuell

Größere Pläne, eigene Konditionen.

25.000+ Calls am Tag
Individuelle Limits und Konditionen
Spot-Datenbank offline nutzbar
Daten eingebettet in dein Produkt
Ein direkter Draht zu uns

Der Zugang läuft über Einladungen, einen Checkout gibt es hier nicht. Schick uns eine E-Mail mit dem Plan, der passt, und einem Satz dazu, was du baust. Wir richten Konto, Zahlung und deinen ersten Key ein.

contact@surf-map.com

Jeder Plan enthält alle fünf /v1-Endpoints, das TypeScript-SDK, den MCP-Server, die OpenAPI-Spec und die llms.txt. Attribution heißt: ein sichtbarer Link „Surf data by SurfMap“ in deinem Produkt.

Early Access anfragen

Leg ein Konto an, gib deinem Key einen Namen und mach deinen ersten Call in Minuten. Fragen oder größere Pläne? Wir beantworten jede Nachricht selbst.

Erstell deinen Key

Oder schreib uns, was du baust.

contact@surf-map.com

Die Wetterdaten stammen unter anderem von Open-Meteo (CC BY 4.0).

Bring 5.000+ Surfspots in dein Produkt.