ShipFinder AIS Data API 5 Meteorology Dataset/5.1 Global Tropical Cyclone API

The 5 Meteorology Dataset/5.1 Global Tropical Cyclone API from ShipFinder AIS Data API — 2 operation(s) for 5 meteorology dataset/5.1 global tropical cyclone.

Operations 2

GET /v1/Meteorology/CycloneInfo 5.1.2 Tropical Cyclone Details by Point #
GET /v1/Meteorology/CyclonesList 5.1.1 Global Tropical Cyclones List #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/shipfinder-ais-data-api-5-meteorology-dataset-5-1-global-tropical-cyclone-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

shipfinder-ais-data-api-5-meteorology-dataset-5-1-global-tropical-cyclone-api-openapi.yml Raw ↑
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