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