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.
GET /v1/spotsGET /v1/spots/nearbyGET /v1/spots/{id}GET /v1/spots/{id}/forecastGET /v1/spots/{id}/tides
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.
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.
contact@surf-map.com
Les données météo incluent Open-Meteo (CC BY 4.0).
