API de previsões de surf: 5.000+ spots avaliados

O que a API serve

Uma base de spots a sério

Mais de 5.000 spots com nome em todo o mundo, com coordenadas e país, pesquisáveis por nome ou por localização. Não são pontos de grelha: são os breaks que os surfistas conhecem.

Previsões avaliadas por nível

Sete dias de ondas, vento e maré hora a hora para cada spot, mais uma escala simples para principiante, intermédio e avançado. O mesmo motor que faz andar a app.

Marés incluídas

Preia-mar e baixa-mar para cada spot, calculadas a partir de constituintes harmónicas. Sem segunda subscrição de um serviço de marés.

Pesquisa spots, vai buscar previsões, lê marés

GETs simples, uma chave de API. Este é o fluxo completo.

surfmap ~ zsh

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

Dados de exemplo. As formas de resposta são reais.

Formato: JSON sobre HTTPS
Auth: Chave de API no header
Versões: /v1 desde o primeiro dia
Unidades: Métricas, horas em UTC
Atualização: Previsões atualizadas duas vezes por dia
Horizonte: 7 dias, de hora em hora

Uma chamada, o quadro todo

JSON estável, com versões desde o primeiro dia. Esta é a forma de uma resposta de previsão.

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 as tuas ferramentas leem

Quer escrevas cada linha tu mesmo, quer deixes o teu agente de código teclar, integrar devia demorar minutos, não um sprint.

Um SDK TypeScript

Um cliente tipado para Node e serverless: pesquisa spots, vai buscar previsões, autocomplete em todos os campos. Uma instalação, zero boilerplate.

Um servidor MCP

Liga o SurfMap ao Claude Code, ao Cursor ou a qualquer cliente MCP: o teu agente de código consulta spots e vai buscar previsões avaliadas enquanto constrói por ti.

Docs também para máquinas

Uma spec OpenAPI e um llms.txt para a API desde o primeiro dia. Aponta o teu assistente a uma URL e ele fica a conhecer cada endpoint, cada campo, cada unidade.

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 quem é

Apps de surf e projetos pessoais, escolas e surf camps que querem condições em direto no site, plataformas de viagens, mostradores de relógio e dashboards. Se o fim da API do Magicseaweed deixou o teu projeto encalhado, este é o substituto que gostávamos de ter encontrado.

Preços

Planos mensais com limites claros. Começa no tamanho certo e sobe quando o teu tráfego crescer.

Starter

39 $por mês

A tua primeira app em produção.

500 chamadas por dia
60 chamadas por minuto
2 chaves de API
Uma app em produção
Atribuição com link
Suporte por email

Growth

99 $por mês

Uma app com tráfego a sério.

2.500 chamadas por dia
120 chamadas por minuto
5 chaves de API
Várias apps
Atribuição com link
Suporte prioritário por email

Pro

249 $por mês

Todo o volume, só a tua marca.

10.000 chamadas por dia
300 chamadas por minuto
10 chaves de API
Apps e ferramentas internas
Sem atribuição obrigatória
Linha direta connosco

Scale

À medida

Planos maiores, condições à medida.

25.000+ chamadas por dia
Limites e condições à medida
Base de spots para uso offline
Dados integrados no teu produto
Linha direta connosco

O acesso é por convite, não há checkout aqui. Manda-nos um email com o plano certo para ti e uma linha sobre o que estás a construir, e preparamos a conta, o pagamento e a tua primeira chave.

contact@surf-map.com

Todos os planos incluem os cinco endpoints /v1, o SDK TypeScript, o servidor MCP, a spec OpenAPI e o llms.txt. A atribuição é um link visível "Surf data by SurfMap" no teu produto.

Pede acesso antecipado

Cria uma conta, dá um nome à tua chave e faz a primeira chamada em minutos. Dúvidas ou planos maiores? Respondemos nós mesmos a todas as mensagens.

Cria a tua chave

Ou escreve-nos e conta-nos o que estás a construir.

contact@surf-map.com

Os dados meteorológicos incluem Open-Meteo (CC BY 4.0).

Põe 5.000+ spots de surf no teu produto.