API SurfMap

Mettez 5 000+ spots de surf dans votre produit.

Le moteur derrière SurfMap, ouvert en API REST toute simple : des spots nommés, des prévisions horaires évaluées selon le niveau du surfeur, et les marées. Nous accueillons un premier groupe de développeurs.

curl https://api.surf-map.com/v1/spots/la-graviere/forecast

Ce que sert l'API

Une vraie base de spots

Plus de 5 000 spots nommés dans le monde, avec coordonnées et pays, cherchables par nom ou par position. Pas des points de grille : les vrais breaks que les surfeurs connaissent.

Des prévisions évaluées par niveau

Sept jours de houle, de vent et de marée heure par heure pour chaque spot, plus une échelle simple pour débutant, intermédiaire et avancé. Le même moteur que l'app.

Les marées incluses

Pleine mer et basse mer pour chaque spot, calculées à partir des constituants harmoniques. Pas besoin d'un deuxième abonnement à un service de marées.

Cherchez un spot, lisez prévisions et marées

Des GET tout simples, une clé API. Voici le flux complet.

Données d'exemple. Les formes de réponse sont réelles.

Format
JSON sur HTTPS
Auth
Clé API dans le header
Versions
/v1 dès le premier jour
Unités
Métriques, heures en UTC
Fraîcheur
Prévisions rafraîchies deux fois par jour
Horizon
7 jours, heure par heure

Une requête, tout y est

Du JSON stable, versionné dès le premier jour. Voici la forme d'une réponse de prévision.

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, serveur MCP, docs lisibles par vos outils

Que vous écriviez chaque ligne vous-même ou que votre agent de code tape à votre place, l'intégration doit prendre des minutes, pas un sprint.

Un SDK TypeScript

Un client typé pour Node et le serverless : recherche de spots, prévisions, autocomplétion sur chaque champ. Une installation, zéro boilerplate.

Un serveur MCP

Connectez SurfMap à Claude Code, Cursor ou n'importe quel client MCP : votre agent de code cherche les spots et récupère les prévisions évaluées pendant qu'il construit pour vous.

Une doc aussi pour les machines

Une spec OpenAPI et un llms.txt pour l'API dès le premier jour. Pointez votre assistant vers une URL et il connaît chaque endpoint, chaque champ, chaque 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"
    }
  }
}

À qui ça s'adresse

Apps de surf et projets perso, écoles et surf camps qui veulent les conditions en direct sur leur site, plateformes de voyage, cadrans de montre et tableaux de bord. Si la fermeture de l'API Magicseaweed a laissé votre projet en rade, c'est le remplacement qu'on aurait aimé trouver.

Tarifs

Des forfaits mensuels aux limites claires. Commencez à la taille qui vous va, montez quand votre trafic grandit.

Starter

39 $par mois

Votre première app en production.

  • 500 appels par jour
  • 60 appels par minute
  • 2 clés API
  • Une app en production
  • Attribution avec un lien
  • Support par e-mail

Growth

99 $par mois

Une app avec du vrai trafic.

  • 2 500 appels par jour
  • 120 appels par minute
  • 5 clés API
  • Plusieurs apps
  • Attribution avec un lien
  • Support prioritaire par e-mail

Pro

249 $par mois

Tout le volume, votre marque seulement.

  • 10 000 appels par jour
  • 300 appels par minute
  • 10 clés API
  • Apps et outils internes
  • Aucune attribution requise
  • Une ligne directe avec nous

Scale

Sur mesure

Des plans plus grands, des conditions sur mesure.

  • 25 000+ appels par jour
  • Limites et conditions sur mesure
  • Base de spots utilisable hors ligne
  • Données intégrées à votre produit
  • Une ligne directe avec nous

L'accès se fait sur invitation, pas de paiement en ligne ici. Envoyez-nous un e-mail avec le forfait qui vous va et un mot sur ce que vous construisez, et nous préparons votre compte, votre paiement et votre première clé.

contact@surf-map.com

Chaque forfait inclut les cinq endpoints /v1, le SDK TypeScript, le serveur MCP, la spec OpenAPI et le llms.txt. L'attribution, c'est un lien visible « Surf data by SurfMap » dans votre produit.

SurfMap

Demandez l'accès anticipé

Créez un compte, nommez votre clé et lancez votre premier appel en quelques minutes. Une question, un projet plus ambitieux ? Nous répondons nous-mêmes à chaque message.

Créez votre clé

Ou écrivez-nous pour nous dire ce que vous construisez.

Les données météo incluent Open-Meteo (CC BY 4.0).