API de previsiones de surf: 5.000+ spots evaluados

Qué sirve la API

Una base de spots de verdad

Más de 5.000 spots con nombre en todo el mundo, con coordenadas y país, buscables por nombre o por ubicación. No son puntos de una malla: son los breaks que los surfistas conocen.

Previsiones evaluadas por nivel

Siete días de olas, viento y marea hora a hora para cada spot, más una escala sencilla para principiante, intermedio y avanzado. El mismo motor que mueve la app.

Mareas incluidas

Pleamar y bajamar para cada spot, calculadas a partir de constituyentes armónicos. Sin segunda suscripción a un servicio de mareas.

Busca spots, trae previsiones, lee mareas

GETs sencillos, una clave de API. Este es el flujo completo.

surfmap ~ zsh

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

Datos de ejemplo. Las formas de respuesta son reales.

Formato: JSON sobre HTTPS
Auth: Clave de API en el header
Versiones: /v1 desde el primer día
Unidades: Métricas, horas en UTC
Frescura: Previsiones actualizadas dos veces al día
Horizonte: 7 días, por horas

Una llamada, toda la foto

JSON estable y versionado desde el primer día. Esta es la forma de una respuesta de previsión.

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, servidor MCP, docs que tus herramientas pueden leer

Tanto si escribes cada línea tú mismo como si tu agente de código teclea por ti, integrar debería llevar minutos, no un sprint.

Un SDK de TypeScript

Un cliente tipado para Node y serverless: busca spots, trae previsiones, autocompletado en cada campo. Una instalación, nada de boilerplate.

Un servidor MCP

Conecta SurfMap a Claude Code, Cursor o cualquier cliente MCP: tu agente de código consulta spots y trae previsiones evaluadas mientras construye por ti.

Docs también para máquinas

Una spec OpenAPI y un llms.txt para la API desde el primer día. Apunta tu asistente a una URL y conocerá cada endpoint, cada campo, cada unidad.

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

Para quién es

Apps de surf y proyectos personales, escuelas y surf camps que quieren condiciones en vivo en su web, plataformas de viajes, esferas de reloj y paneles. Si el cierre de la API de Magicseaweed dejó tu proyecto tirado, este es el reemplazo que nos habría gustado encontrar.

Precios

Planes mensuales con límites claros. Empieza en la talla que te encaja y sube cuando tu tráfico crezca.

Starter

39 $al mes

Tu primera app en producción.

500 llamadas al día
60 llamadas por minuto
2 claves de API
Una app en producción
Atribución con enlace
Soporte por correo

Growth

99 $al mes

Una app con tráfico de verdad.

2.500 llamadas al día
120 llamadas por minuto
5 claves de API
Varias apps
Atribución con enlace
Soporte prioritario por correo

Pro

249 $al mes

Todo el volumen, solo tu marca.

10.000 llamadas al día
300 llamadas por minuto
10 claves de API
Apps y herramientas internas
Sin atribución obligatoria
Línea directa con nosotros

Scale

A medida

Planes más grandes, condiciones a medida.

25.000+ llamadas al día
Límites y condiciones a medida
Base de spots para uso offline
Datos integrados en tu producto
Línea directa con nosotros

El acceso es por invitación, aquí no hay pago online. Envíanos un correo con el plan que te encaja y una línea sobre lo que estás construyendo, y te preparamos la cuenta, el pago y tu primera clave.

contact@surf-map.com

Todos los planes incluyen los cinco endpoints /v1, el SDK de TypeScript, el servidor MCP, la spec OpenAPI y el llms.txt. La atribución es un enlace visible "Surf data by SurfMap" en tu producto.

Pide acceso anticipado

Crea una cuenta, ponle nombre a tu clave y haz tu primera llamada en minutos. ¿Preguntas o planes más grandes? Respondemos cada mensaje nosotros mismos.

Crea tu clave

O escríbenos y cuéntanos qué estás construyendo.

contact@surf-map.com

Los datos meteorológicos incluyen Open-Meteo (CC BY 4.0).

Pon 5.000+ spots de surf en tu producto.