台风说开放 API 文档

台风说提供免费的公开只读 API，可用于查询实时台风与历史台风数据。所有接口返回 JSON，支持跨域(CORS)。请合理使用，数据仅供参考，请以官方发布为准。

实时数据

接口	说明
`GET /api/typhoons`	当前活跃台风列表(完整路径点/风圈/多机构预报)
`GET /api/typhoons/{code}`	单个台风详情，如 `/api/typhoons/202609`(活跃→归档→上游实时三级回退)

接口	说明
`GET /api/history/years`	已归档年份统计
`GET /api/history/{year}`	某年全部台风概要列表
`GET /api/history/search/{keyword}`	按名称/编号搜索台风(最多50条)
`GET /api/history/today`	历史上的今天知名台风
`GET /api/seo/news`	最新台风快讯(AI生成, 可加 ?code= 过滤)

GET /api/typhoons/202609 返回:

字段	说明
`typhoon.code`	台风编号, 如 202609
`typhoon.name / enname`	中文名 / 英文名
`typhoon.points[]`	路径点数组: time/lat/lng/strong/power/speed/pressure/moveDir/radius7/radius10/radius12
`typhoon.forecasts`	多机构预报路径: 中国/日本/美国/中国香港/中国台湾等
`typhoon.land[]`	登陆信息

数据来源：浙江省水利厅、中央气象台。如引用本站数据，请注明来源"台风说 taifengshuo.com"。