Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.2.0
info:
title: ShipFinder Global Maritime Data 5 Meteorology Dataset/5.1…
description: Verbatim assembly of the per-endpoint OpenAPI 3.0.1 fragments ShipFinder publishes on docs.shipfinder.com (one fragment per endpoint page, indexed by the provider llms.txt). Path items are reproduced exactly as published; only the enclosing document (info/servers/tags) is API Evangelist assembly. No operation content was altered.
version: 1.0.0
servers: []
tags:
- name: 5 Meteorology Dataset/5.1 Global Tropical Cyclone
paths:
/v1/Meteorology/CycloneInfo:
get:
summary: 5.1.2 Tropical Cyclone Details by Point
deprecated: false
description: ''
tags:
- 5 Meteorology Dataset/5.1 Global Tropical Cyclone
parameters:
- name: key
in: query
description: Your personal Shipfinderer API key to verify service permissions
required: true
example: 1F6D701272402D1E7D8D316CCE519123
schema:
type: string
- name: typhoon_id
in: query
description: 'Obtained via the Global Tropical Cyclones List. '
required: true
example: '2477927'
schema:
type: string
responses:
'0':
description: ''
content:
application/json:
schema:
type: object
properties:
status:
type: integer
msg:
type: string
total:
type: integer
data:
type: array
items:
type: object
properties:
typhoon_id:
type: string
description: Typhoon Serial Number
typhoon_time:
type: string
description: Formation time of the tropical cyclone, defaulted to UTC+0 time. Add 8 hours when converting to China Standard Time (CST/UTC+8).
forecast:
type: string
description: 'Marker for forecast/observed data points: Empty=Actual observation point; Non-empty=Forecast prediction point'
fhour:
type: string
description: 'Time offset for forecast data, representing the hours ahead of the issuance time for which the cyclone parameters are predicted.Example: fhour=12 indicates the data is a 12‑hour ahead forecast issued at the reference timestamp.
Note: For historical tropical cyclones, measured observational data overwrites the original forecast data, and the fhour field is returned empty.'
lat:
type: number
description: Coordinate latitude, WGS84 coordinate system
lng:
type: number
description: Coordinate longitude, WGS84 coordinate system
grade:
type: integer
description: 'Tropical cyclone wind scale (range: 5–18)'
mspeed:
type: number
description: 'Maximum sustained wind speed, Unit: meters per second (m/s)'
pressure:
type: number
description: 'Tropical cyclone central pressure, Unit: hectopascals (hPa)'
kspeed:
type: number
description: 'Cyclone translation speed, Unit: kilometers per hour (km/h)'
direction:
type: string
description: 'Cyclone movement direction: East (E), West (W), South (S), North (N)'
radius7:
type: number
description: 'Radius of 7-grade gale-force wind circle, Unit: kilometers (km)'
radius10:
type: number
description: 'Radius of 10-grade storm-force wind circle, Unit: kilometers (km)'
radius7_s:
type: string
description: '7-grade gale-force wind circle radius by quadrant, Unit: kilometers (km).
Format: NE,SE,SW,NW (Northeast, Southeast, Southwest, Northwest)'
radius10_s:
type: string
description: '10-grade storm-force wind circle radius by quadrant, Unit: kilometers (km)'
radius12_s:
type: string
description: '12-grade hurricane-force wind circle radius by quadrant, Unit: kilometers (km)'
required:
- typhoon_id
- typhoon_time
- forecast
- fhour
- lat
- lng
- grade
- mspeed
- pressure
- direction
- radius7
- radius10
- radius7_s
- radius10_s
- radius12_s
- kspeed
x-apifox-orders:
- typhoon_id
- typhoon_time
- forecast
- fhour
- lat
- lng
- grade
- mspeed
- pressure
- kspeed
- direction
- radius7
- radius10
- radius7_s
- radius10_s
- radius12_s
required:
- status
- msg
- total
- data
x-apifox-orders:
- status
- msg
- total
- data
example: "{\n \"status\": 0,\n \"msg\": \"\",\n \"total\": 15,\n \"data\": [\n {\n \"typhoon_id\": \"3063123\",\n \"typhoon_time\": \"202507231400\",\n \"forecast\": \"BABJ\",\n \"fhour\": \"24\",\n \"lat\": 16.8667,\n \"lng\": 119.9667,\n \"grade\": 10,\n \"mspeed\": 28,\n \"pressure\": 985,\n \"kspeed\": 0,\n \"direction\": \"\",\n \"radius7\": 0,\n \"radius10\": 0,\n \"radius7_s\": \"180,120,150,200\",\n \"radius10_s\": \"0\",\n \"radius12_s\": \"0\"\n },\n {\n \"typhoon_id\": \"3063123\",\n \"typhoon_time\": \"202507231400\",\n \"forecast\": \"\",\n \"fhour\": \"\",\n \"lat\": 17.6,\n \"lng\": 118.7,\n \"grade\": 8,\n \"mspeed\": 18,\n \"pressure\": 992,\n \"kspeed\": 13,\n \"direction\": \"S\",\n \"radius7\": 180,\n \"radius10\": 0,\n \"radius7_s\": \"180,120,150,200\",\n \"radius10_s\": \"0\",\n \"radius12_s\": \"0\"\n },\n .....\n ]\n}"
headers: {}
x-apifox-name: success
security: []
x-apifox-folder: 5 Meteorology Dataset/5.1 Global Tropical Cyclone
x-apifox-status: released
x-run-in-apifox: https://app.apifox.com/web/project/7948067/apis/api-431698143-run
operationId: getV1MeteorologyCycloneInfo
x-operation-id-source: derived
/v1/Meteorology/CyclonesList:
get:
summary: 5.1.1 Global Tropical Cyclones List
deprecated: false
description: ''
tags:
- 5 Meteorology Dataset/5.1 Global Tropical Cyclone
parameters:
- name: key
in: query
description: Your personal Shipfinderer API key to verify service permissions
required: true
example: 1F6D701272402D1E7D8D316CCE519123
schema:
type: string
responses:
'0':
description: ''
content:
application/json:
schema:
type: object
properties:
status:
type: integer
msg:
type: string
total:
type: integer
data:
type: array
items:
type: object
properties:
typhoon_id:
type: string
description: "Obtained via the Global Tropical Cyclones List. \nNote: Tropical cyclone names are often reused, but each cyclone carries a unique typhoon_id. To query the latest cyclone data, first pull the up-to-date typhoon_id from the list, then use it to retrieve full cyclone details."
typhoon_code:
type: integer
description: International serial number of the tropical cyclone
typhoon_cncode:
type: string
description: Chinese serial number of the tropical cyclone; the first two digits represent the year, and the last two digits indicate sequential order by occurrence time
typhoon_cnname:
type: string
description: Chinese name of the tropical cyclone
typhoon_name:
type: string
description: Name of the tropical cyclone
current_year:
type: integer
description: Year the tropical cyclone formed
dataMark:
type: string
description: 'Indicator of whether the cyclone is active: ing=In progress; blank=Concluded'
required:
- typhoon_id
- typhoon_code
- typhoon_cncode
- typhoon_cnname
- typhoon_name
- current_year
- dataMark
x-apifox-orders:
- typhoon_id
- typhoon_code
- typhoon_cncode
- typhoon_cnname
- typhoon_name
- current_year
- dataMark
required:
- status
- msg
- total
- data
x-apifox-orders:
- status
- msg
- total
- data
example: "{\n \"status\": 0,\n \"msg\": \"\",\n \"total\": 425,\n \"data\": [\n {\n \"typhoon_id\": \"3064324\",\n \"typhoon_code\": 0,\n \"typhoon_cncode\": \"2509\",\n \"typhoon_cnname\": \"罗莎\",\n \"typhoon_name\": \"KROSA\",\n \"current_year\": 2025,\n \"dataMark\": \"\"\n },\n {\n \"typhoon_id\": \"3063123\",\n \"typhoon_code\": 0,\n \"typhoon_cncode\": \"2508\",\n \"typhoon_cnname\": \"竹节草\",\n \"typhoon_name\": \"CO-MAY\",\n \"current_year\": 2025,\n \"dataMark\": \"\"\n },\n {\n \"typhoon_id\": \"3062724\",\n \"typhoon_code\": 0,\n \"typhoon_cncode\": \"2507\",\n \"typhoon_cnname\": \"范斯高\",\n \"typhoon_name\": \"FRANCISCO\",\n \"current_year\": 2025,\n \"dataMark\": \"\"\n },\n ......\n ]\n}"
headers: {}
x-apifox-name: success
security: []
x-apifox-folder: 5 Meteorology Dataset/5.1 Global Tropical Cyclone
x-apifox-status: released
x-run-in-apifox: https://app.apifox.com/web/project/7948067/apis/api-431698053-run
operationId: getV1MeteorologyCyclonesList
x-operation-id-source: derived
x-evidence:
harvested: '2026-08-09'
index: https://docs.shipfinder.com/llms.txt
index_http_status: 200
fragments: 40
note: Each path item was extracted verbatim from the "## OpenAPI Specification" yaml block on the corresponding docs page. The provider publishes no consolidated OpenAPI document.
sources:
- path: /v1/AIS/FleetPosition
method: GET
title: 1.1.3 Fleet Position
source: https://docs.shipfinder.com/430293359e0.md
- path: /v1/AIS/VesselFlagInfo
method: GET
title: 1.5 Vessel Flag Information
source: https://docs.shipfinder.com/429919472e0.md
- path: /v1/AIS/VesselPositionMulti
method: GET
title: 1.1.2 Multi-vessel Position
source: https://docs.shipfinder.com/430292321e0.md
- path: /v1/AIS/VesselPositionSingle
method: GET
title: 1.1.1 Single Vessel Position
source: https://docs.shipfinder.com/428990613e0.md
- path: /v1/AIS/VesselSearch
method: GET
title: 1.2 Vessel Search
source: https://docs.shipfinder.com/428749512e0.md
- path: /v1/AIS/VesselsInZone
method: GET
title: 1.4 Vessels in Zone
source: https://docs.shipfinder.com/429583708e0.md
- path: /v1/AIS/VesselsNearby
method: GET
title: 1.3 Vessels Nearby
source: https://docs.shipfinder.com/429003024e0.md
- path: /v1/Event/AddFleet
method: POST
title: 7.1.1 Create Fleet
source: https://docs.shipfinder.com/432035260e0.md
- path: /v1/Event/AddGeofence
method: POST
title: 7.2.1 Geofence Creation
source: https://docs.shipfinder.com/433382008e0.md
- path: /v1/Event/AddVesselSpeedAlert
method: POST
title: 7.3.1 Add Vessel Speed Alert Subscription
source: https://docs.shipfinder.com/433460139e0.md
- path: /v1/Event/AddVesselToFleet
method: POST
title: 7.1.5 Add Vessels to Fleet
source: https://docs.shipfinder.com/432100231e0.md
- path: /v1/Event/DeleteFleet
method: POST
title: 7.1.4 Delete Fleet
source: https://docs.shipfinder.com/432076110e0.md
- path: /v1/Event/DeleteFleetVessel
method: POST
title: 7.1.7 Remove Vessels from Fleet
source: https://docs.shipfinder.com/432106004e0.md
- path: /v1/Event/DeleteGeofence
method: DELETE
title: 7.2.4 Geofence Deletion
source: https://docs.shipfinder.com/433422419e0.md
- path: /v1/Event/DeleteVesselSpeedAlert
method: POST
title: 7.3.2 Delete Vessel Speed Alert Subscription
source: https://docs.shipfinder.com/433471968e0.md
- path: /v1/Event/GetFleet
method: GET
title: 7.1.3 Query Fleet
source: https://docs.shipfinder.com/432057101e0.md
- path: /v1/Event/GetGeofence
method: GET
title: 7.2.3 Geofence Query
source: https://docs.shipfinder.com/433414777e0.md
- path: /v1/Event/UpdateFleetInfo
method: POST
title: 7.1.2 Update Fleet Information
source: https://docs.shipfinder.com/432048484e0.md
- path: /v1/Event/UpdateFleetVessel
method: POST
title: 7.1.6 Batch Update Vessels in Fleet
source: https://docs.shipfinder.com/432080706e0.md
- path: /v1/Event/UpdateGeofence
method: POST
title: 7.2.2 Geofence Update
source: https://docs.shipfinder.com/433396710e0.md
- path: /v1/Event/VesselSpeedAlertList
method: GET
title: 7.3.3 Query Vessel Speed Alert Subscription List
source: https://docs.shipfinder.com/433473614e0.md
- path: /v1/History/PortCallRecordsByPort
method: GET
title: 3.6 Port Calls Records for Port
source: https://docs.shipfinder.com/430531632e0.md
- path: /v1/History/PortCallRecordsByVessel
method: GET
title: 3.3 Vessel Port Call History
source: https://docs.shipfinder.com/430426234e0.md
- path: /v1/History/PortCallRecordsByVesselAtPort
method: GET
title: 3.4 Vessel Port Call Records at Specific Port
source: https://docs.shipfinder.com/430484162e0.md
- path: /v1/History/VesselCurrentPortCall
method: GET
title: 3.5 Vessel Current Port Call
source: https://docs.shipfinder.com/430498718e0.md
- path: /v1/History/VesselHistoryTrack
method: GET
title: 3.1 Vessel History Track
source: https://docs.shipfinder.com/430346103e0.md
- path: /v1/History/VesselStsEvents
method: GET
title: 3.2 Ship-to-Ship (STS) Events
source: https://docs.shipfinder.com/430352093e0.md
- path: /v1/Meteorology/CycloneInfo
method: GET
title: 5.1.2 Tropical Cyclone Details by Point
source: https://docs.shipfinder.com/431698143e0.md
- path: /v1/Meteorology/CyclonesList
method: GET
title: 5.1.1 Global Tropical Cyclones List
source: https://docs.shipfinder.com/431698053e0.md
- path: /v1/Meteorology/MarineWeather
method: GET
title: 5.3 Global Marine Weather
source: https://docs.shipfinder.com/431272522e0.md
- path: /v1/Meteorology/TideStationInfo
method: GET
title: 5.2.2 Query Single Tide Gauge Station Details
source: https://docs.shipfinder.com/431865286e0.md
- path: /v1/Meteorology/TideStationList
method: GET
title: 5.2.1 Request parameters for Global Tide Gauge Stations List
source: https://docs.shipfinder.com/431857907e0.md
- path: /v1/Prediction/ETA
method: GET
title: 4.3 ETA Query
source: https://docs.shipfinder.com/431244206e0.md
- path: /v1/Prediction/RoutePlanPointToPoint
method: GET
title: 4.1 Point-to-Point Route Planning
source: https://docs.shipfinder.com/431124483e0.md
- path: /v1/Prediction/RoutePlanPortToPort
method: GET
title: 4.2 Port-to-Port Route Planning
source: https://docs.shipfinder.com/431244012e0.md
- path: /v1/Voyage/PortAnchoredVessels
method: GET
title: 2.3 Currently Anchored Vessels
source: https://docs.shipfinder.com/430236145e0.md
- path: /v1/Voyage/PortBerthedVessels
method: GET
title: 2.2 Currently Berthed Vessels
source: https://docs.shipfinder.com/430197412e0.md
- path: /v1/Voyage/PortExpectedArrivals
method: GET
title: 2.4 Inbound / Expected Arrivals
source: https://docs.shipfinder.com/430249182e0.md
- path: /v1/Voyage/PortInfo
method: GET
title: 2.1 Port Information
source: https://docs.shipfinder.com/429932201e0.md
- path: /v1/Warning/NavigationalWarnings
method: GET
title: 6.1 China Region Navigational Warnings
source: https://docs.shipfinder.com/431872073e0.md