APIが返すもの
本物のスポットデータベース
世界中の名前つきサーフスポット5,000以上。座標と国つきで、名前でも位置でも検索できます。グリッドの点ではなく、サーファーが知っている実際のブレイクです。
レベル別に評価された予報
各スポットの波、風、潮汐を1時間ごとに7日分。さらに初級・中級・上級それぞれへのシンプルな評価つき。アプリを動かしているのと同じエンジンです。
潮汐も込み
各スポットの満潮と干潮を調和定数から計算。潮汐サービスを別途契約する必要はありません。
スポットを探し、予報と潮汐を取得
シンプルなGETとAPIキー1つ。これで流れのすべてです。
GET /v1/spotsGET /v1/spots/nearbyGET /v1/spots/{id}GET /v1/spots/{id}/forecastGET /v1/spots/{id}/tides
サンプルデータです。レスポンスの形は実物どおり。
- フォーマット
- HTTPS上のJSON
- 認証
- ヘッダーのAPIキー
- バージョン
- 初日から/v1
- 単位
- メートル法、時刻はUTC
- 更新
- 予報は1日2回更新
- 期間
- 7日間、1時間ごと
1回のコールで、全体像を
安定したJSONを初日からバージョン管理。予報レスポンスの形はこちらです。
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、MCPサーバー、ツールが読めるドキュメント
自分で全部書く人も、コーディングエージェントに任せる人も、統合にかかるのはスプリントではなく数分であるべきです。
TypeScript SDK
Nodeとサーバーレス向けの型つきクライアント。スポット検索、予報の取得、全フィールドで補完が効きます。インストール1回、ボイラープレートなし。
MCPサーバー
SurfMapをClaude CodeやCursorなどのMCPクライアントにつなげば、コーディングエージェントが構築しながらスポットを調べ、評価つき予報を取得します。
機械も読めるドキュメント
OpenAPI仕様とAPI用のllms.txtを初日から用意。アシスタントにURLをひとつ渡せば、すべてのエンドポイント、フィールド、単位を把握します。
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"
}
}
}こんな方に
サーフアプリや個人プロジェクト、サイトにライブコンディションを載せたいサーフスクールやキャンプ、旅行プラットフォーム、ウォッチフェイスやダッシュボード。Magicseaweed APIの終了で行き場を失ったプロジェクトにも。私たちが欲しかった代替をつくっています。
料金
月額のプランと、わかりやすい上限。合うサイズから始めて、トラフィックが増えたら上げてください。
Starter
$39月額
最初の本番アプリに。
- 1日500コール
- 1分60コール
- APIキー2本
- 本番アプリ1つ
- リンクつきのクレジット表記
- メールサポート
Growth
$99月額
伸びはじめたアプリに。
- 1日2,500コール
- 1分120コール
- APIキー5本
- 複数のアプリ
- リンクつきのクレジット表記
- 優先メールサポート
Pro
$249月額
フルボリューム、表記はあなたのブランドだけ。
- 1日10,000コール
- 1分300コール
- APIキー10本
- アプリと社内ツール
- クレジット表記は不要
- 開発者への直通連絡
Scale
応相談
もっと大きな計画に、個別の条件で。
- 1日25,000コール以上
- 上限も条件も個別に
- スポットデータベースのオフライン利用
- データをプロダクトに組み込み
- 開発者への直通連絡
アクセスは招待制で、このページに決済はありません。合うプランと、作っているものを一言添えて、メールを送ってください。アカウント、支払い、最初のキーをこちらで用意します。
contact@surf-map.com
すべてのプランに、5つの/v1エンドポイント、TypeScript SDK、MCPサーバー、OpenAPI仕様、llms.txtが含まれます。クレジット表記とは、プロダクト内に「Surf data by SurfMap」のリンクを見える形で置くことです。
アーリーアクセスに申し込む
アカウントを作成し、キーに名前をつければ、数分で最初のコールを送れます。質問や大きめの計画があれば、開発者本人が返信します。
キーを作成またはメールで、作っているものを教えてください。
contact@surf-map.com
気象データにはOpen-Meteo(CC BY 4.0)を含みます。
