API di previsioni surf: 5.000+ spot valutati

Cosa serve l'API

Un vero database di spot

Oltre 5.000 spot con nome in tutto il mondo, con coordinate e paese, cercabili per nome o per posizione. Non punti di griglia: i break veri che i surfisti conoscono.

Previsioni valutate per livello

Sette giorni di onde, vento e marea ora per ora per ogni spot, più una scala semplice per principiante, intermedio e avanzato. Lo stesso motore che muove l'app.

Maree incluse

Alta e bassa marea per ogni spot, calcolate dai costituenti armonici. Nessun secondo abbonamento a un servizio di maree.

Cerca spot, scarica previsioni, leggi le maree

GET semplici, una chiave API. Questo è il flusso completo.

surfmap ~ zsh

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

Dati di esempio. Le forme delle risposte sono reali.

Formato: JSON su HTTPS
Auth: Chiave API nell'header
Versioni: /v1 dal primo giorno
Unità: Metriche, orari in UTC
Freschezza: Previsioni aggiornate due volte al giorno
Orizzonte: 7 giorni, ora per ora

Una chiamata, il quadro completo

JSON stabile, versionato dal primo giorno. Questa è la forma di una risposta di previsione.

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, server MCP, docs che i tuoi strumenti sanno leggere

Che tu scriva ogni riga da solo o lasci digitare il tuo agente di codice, integrare dovrebbe richiedere minuti, non uno sprint.

Un SDK TypeScript

Un client tipizzato per Node e serverless: cerca spot, scarica previsioni, autocompletamento su ogni campo. Una installazione, niente boilerplate.

Un server MCP

Collega SurfMap a Claude Code, Cursor o a qualsiasi client MCP: il tuo agente di codice consulta gli spot e recupera previsioni valutate mentre costruisce per te.

Docs anche per le macchine

Una spec OpenAPI e un llms.txt per l'API dal primo giorno. Punta il tuo assistente a una URL e conoscerà ogni endpoint, ogni campo, ogni unità.

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"
    }
  }
}

Per chi è

App di surf e progetti personali, scuole e surf camp che vogliono le condizioni live sul proprio sito, piattaforme di viaggio, quadranti e dashboard. Se la chiusura dell'API di Magicseaweed ha lasciato a terra il tuo progetto, questo è il ricambio che avremmo voluto trovare.

Prezzi

Piani mensili con limiti chiari. Parti dalla taglia giusta e sali quando il tuo traffico cresce.

Starter

39 $al mese

La tua prima app in produzione.

500 chiamate al giorno
60 chiamate al minuto
2 chiavi API
Un'app in produzione
Attribuzione con link
Supporto via email

Growth

99 $al mese

Un'app con traffico vero.

2.500 chiamate al giorno
120 chiamate al minuto
5 chiavi API
Più app
Attribuzione con link
Supporto prioritario via email

Pro

249 $al mese

Tutto il volume, solo il tuo brand.

10.000 chiamate al giorno
300 chiamate al minuto
10 chiavi API
App e strumenti interni
Nessuna attribuzione richiesta
Una linea diretta con noi

Scale

Su misura

Piani più grandi, condizioni su misura.

25.000+ chiamate al giorno
Limiti e condizioni su misura
Database degli spot offline
Dati integrati nel tuo prodotto
Una linea diretta con noi

L'accesso è su invito, qui non c'è un checkout. Mandaci una email con il piano giusto per te e una riga su cosa stai costruendo, e prepariamo account, pagamento e la tua prima chiave.

contact@surf-map.com

Ogni piano include i cinque endpoint /v1, l'SDK TypeScript, il server MCP, la spec OpenAPI e il llms.txt. L'attribuzione è un link visibile "Surf data by SurfMap" nel tuo prodotto.

Chiedi l'early access

Crea un account, dai un nome alla tua chiave e fai la prima chiamata in pochi minuti. Domande o piani più grandi? Rispondiamo noi stessi a ogni messaggio.

Crea la tua chiave

Oppure scrivici e raccontaci cosa stai costruendo.

contact@surf-map.com

I dati meteo includono Open-Meteo (CC BY 4.0).

Metti 5.000+ spot da surf nel tuo prodotto.