BeachFinder Beaches and Water Activities API

Search 184,900 beaches, lakes and swimming spots with live planning conditions and BeachFinder links.

原始信息汇总

BeachFinder Beaches and Water Activities API 数据集总结

概述
该数据集覆盖全球 184,900 个游泳地点，包括海滩、湖泊、冲浪点、潜水点、河流激流以及 vanlife 露营地。提供实时规划条件、本地化指南和活动提供商信息。

数据内容

• 搜索类型：支持按目的地意图、城市、国家等查询海滩、湖泊、天然游泳点、冲浪、潜水、河流激流、vanlife 点、活动提供商和本地指南。
• 结果信息：每条结果包含 BeachFinder 规范 URL、应用下载链接，以及数据新鲜度、置信度和来源归属（如 OpenStreetMap 地理数据、天气/海洋数据提供商）。

功能用途

• 目的地和意图驱动的海滩发现
• 海滩、湖泊、天然游泳点搜索
• 冲浪、潜水、河流激流、vanlife 点发现
• 公共活动提供商发现
• 已知 BeachFinder 地点的实时规划条件
• 本地化 BeachFinder 指南搜索
• 匿名社区条件摘要

接口端点

• GET /health
• GET /beaches/search：需至少指定 query、city 或 country，支持 lang、limit、radius_km、intent、water_min_c、wind_max_kmh 等过滤参数。
• GET /spots/search
• GET /providers/search
• GET /guides/search
• GET /specialized/surf
• GET /specialized/dive
• GET /specialized/river
• GET /specialized/van
• GET /spots/{id}
• GET /spots/{id}/conditions
• GET /community/{id}
• POST /spots/compare：请求体 {"spot_ids":["id-1","id-2"]}

认证与安全

• 使用 RapidAPI 标准请求头认证，不得直接发送代理密钥。
• API 为只读，不暴露提供商邮箱、电话、用户身份或精确坐标。
• 请求经过大小限制和速率限制。

安全与归属

• 该 API 仅提供规划信息，不声明游泳安全；建议用户查看官方公告、关闭标志和救生员指导。
• 结果中标注数据新鲜度和来源归属。

相关链接

• 产品主页：https://getbeachfinder.com/ai-search
• 应用下载：https://getbeachfinder.com/app
• OpenAPI 规范：https://getbeachfinder.com/rapidapi-openapi.json
• 使用条款：https://getbeachfinder.com/terms.html
• 隐私政策：https://getbeachfinder.com/privacy.html