Global Tides API

This API provides the tidal heights and extremes predictions at any location of the World Ocean.

The access is provided by RapidAPI service.

Connect on RapidAPI

Description

This API provides the tidal heights and extremes predictions at any location of the World Ocean.

Tide prediction consists of the calculated tidal heights for a particular time and location and tidal heights and time of the extremes (low and high tides).

Tidal heights are returned as Mean Sea Level (MSL). Support for the other tidal datums like LAT, HAT etc is planned in the future.

Data

This API is generated using AVISO+ Products. The predictions are calculated using global tide model which assimilates harmonic constants derived from 20 years of altimeter and tide gauges data. You can read more about the model at AVISO website.

Disclaimer

Predictions are based on historical tidal gauge data and satellite altimetry. The model does not take into account, for example, current weather and seismic activity so is NOT suitable for navigational purposes or any other usage where one can be harmed or suffer damage.

Example

Request

curl --get --include 'https://tides.p.rapidapi.com/tides?latitude=45.38377609121186&longitude=-4.389999999999992' \
  -H 'X-RapidAPI-Key: YOUR_API_KEY'

Response

{
    "disclaimer": "NOT SUITABLE FOR NAVIGATIONAL PURPOSES. API Hood does not warrant that the provided data will be free from errors or omissions. Provided data are NOT suitable for usage where someone could be harmed or suffer any damage.",
    "status": 200,
    "latitude": 45.38377609121186,
    "longitude": -4.389999999999992,
    "origin": {
        "latitude": 45.375,
        "longitude": -4.375,
        "distance": 1.53,
        "unit": "km"
    },
    "datums": {
        "LAT": -2.270791320800781,
        "HAT": 2.2990721130371092
    },
    "timestamp": 1563821689,
    "datetime": "2019-07-22T18:54:49+00:00",
    "unit": "m",
    "timezone": "UTC",
    "datum": "MSL",
    "extremes": [
        {
            "timestamp": 1563821687,
            "datetime": "2019-07-22T18:54:47+00:00",
            "height": 1.2091202117741158,
            "state": "HIGH TIDE"
        },
        {
            "timestamp": 1563844505,
            "datetime": "2019-07-23T01:15:05+00:00",
            "height": -1.1278606509683402,
            "state": "LOW TIDE"
        },
        {
            "timestamp": 1563866330,
            "datetime": "2019-07-23T07:18:50+00:00",
            "height": 0.945724613843026,
            "state": "HIGH TIDE"
        },
        {
            "timestamp": 1563888355,
            "datetime": "2019-07-23T13:25:55+00:00",
            "height": -0.9942964868935829,
            "state": "LOW TIDE"
        }
    ],
    "heights": [
        {
            "timestamp": 1563821689,
            "datetime": "2019-07-22T18:54:49+00:00",
            "height": 1.2091238757659937,
            "state": "FALLING"
        },
        {
            "timestamp": 1563823489,
            "datetime": "2019-07-22T19:24:49+00:00",
            "height": 1.1750999966106004,
            "state": "FALLING"
        },
        {
            "timestamp": 1563825289,
            "datetime": "2019-07-22T19:54:49+00:00",
            "height": 1.0760474118686372,
            "state": "FALLING"
        },
        {
            "timestamp": 1563827089,
            "datetime": "2019-07-22T20:24:49+00:00",
            "height": 0.9174673570153624,
            "state": "FALLING"
        },
        {
            "timestamp": 1563828889,
            "datetime": "2019-07-22T20:54:49+00:00",
            "height": 0.7065009885291901,
            "state": "FALLING"
        },
        {
            "timestamp": 1563830689,
            "datetime": "2019-07-22T21:24:49+00:00",
            "height": 0.45287260442467936,
            "state": "FALLING"
        },
        {
            "timestamp": 1563832489,
            "datetime": "2019-07-22T21:54:49+00:00",
            "height": 0.17005245909132566,
            "state": "FALLING"
        },
        {
            "timestamp": 1563834289,
            "datetime": "2019-07-22T22:24:49+00:00",
            "height": -0.12446622942526164,
            "state": "FALLING"
        },
        {
            "timestamp": 1563836089,
            "datetime": "2019-07-22T22:54:49+00:00",
            "height": -0.4104446849193995,
            "state": "FALLING"
        },
        {
            "timestamp": 1563837889,
            "datetime": "2019-07-22T23:24:49+00:00",
            "height": -0.6674788338777643,
            "state": "FALLING"
        },
        {
            "timestamp": 1563839689,
            "datetime": "2019-07-22T23:54:49+00:00",
            "height": -0.8778511861736503,
            "state": "FALLING"
        },
        {
            "timestamp": 1563841489,
            "datetime": "2019-07-23T00:24:49+00:00",
            "height": -1.028512611282276,
            "state": "FALLING"
        },
        {
            "timestamp": 1563843289,
            "datetime": "2019-07-23T00:54:49+00:00",
            "height": -1.1116506261105905,
            "state": "FALLING"
        },
        {
            "timestamp": 1563845089,
            "datetime": "2019-07-23T01:24:49+00:00",
            "height": -1.1241479028383718,
            "state": "FALLING"
        },
        {
            "timestamp": 1563846889,
            "datetime": "2019-07-23T01:54:49+00:00",
            "height": -1.0667412747039269,
            "state": "RISING"
        },
        {
            "timestamp": 1563848689,
            "datetime": "2019-07-23T02:24:49+00:00",
            "height": -0.9435786261084895,
            "state": "RISING"
        },
        {
            "timestamp": 1563850489,
            "datetime": "2019-07-23T02:54:49+00:00",
            "height": -0.7623294497045636,
            "state": "RISING"
        },
        {
            "timestamp": 1563852289,
            "datetime": "2019-07-23T03:24:49+00:00",
            "height": -0.5344807146684677,
            "state": "RISING"
        },
        {
            "timestamp": 1563854089,
            "datetime": "2019-07-23T03:54:49+00:00",
            "height": -0.27527566775641676,
            "state": "RISING"
        },
        {
            "timestamp": 1563855889,
            "datetime": "2019-07-23T04:24:49+00:00",
            "height": -0.0029414092799904725,
            "state": "RISING"
        },
        {
            "timestamp": 1563857689,
            "datetime": "2019-07-23T04:54:49+00:00",
            "height": 0.26281835513014956,
            "state": "RISING"
        },
        {
            "timestamp": 1563859489,
            "datetime": "2019-07-23T05:24:49+00:00",
            "height": 0.5028248391361406,
            "state": "RISING"
        },
        {
            "timestamp": 1563861289,
            "datetime": "2019-07-23T05:54:49+00:00",
            "height": 0.7005318732850015,
            "state": "RISING"
        },
        {
            "timestamp": 1563863089,
            "datetime": "2019-07-23T06:24:49+00:00",
            "height": 0.8437734847104321,
            "state": "RISING"
        },
        {
            "timestamp": 1563864889,
            "datetime": "2019-07-23T06:54:49+00:00",
            "height": 0.9256838929415001,
            "state": "RISING"
        },
        {
            "timestamp": 1563866689,
            "datetime": "2019-07-23T07:24:49+00:00",
            "height": 0.9445003586202882,
            "state": "RISING"
        },
        {
            "timestamp": 1563868489,
            "datetime": "2019-07-23T07:54:49+00:00",
            "height": 0.9023744194729271,
            "state": "FALLING"
        },
        {
            "timestamp": 1563870289,
            "datetime": "2019-07-23T08:24:49+00:00",
            "height": 0.8038178626284862,
            "state": "FALLING"
        },
        {
            "timestamp": 1563872089,
            "datetime": "2019-07-23T08:54:49+00:00",
            "height": 0.6546566326999923,
            "state": "FALLING"
        },
        {
            "timestamp": 1563873889,
            "datetime": "2019-07-23T09:24:49+00:00",
            "height": 0.4620843181907568,
            "state": "FALLING"
        },
        {
            "timestamp": 1563875689,
            "datetime": "2019-07-23T09:54:49+00:00",
            "height": 0.2356708500310954,
            "state": "FALLING"
        },
        {
            "timestamp": 1563877489,
            "datetime": "2019-07-23T10:24:49+00:00",
            "height": -0.011552059493899279,
            "state": "FALLING"
        },
        {
            "timestamp": 1563879289,
            "datetime": "2019-07-23T10:54:49+00:00",
            "height": -0.26300290514668834,
            "state": "FALLING"
        },
        {
            "timestamp": 1563881089,
            "datetime": "2019-07-23T11:24:49+00:00",
            "height": -0.4999966867321017,
            "state": "FALLING"
        },
        {
            "timestamp": 1563882889,
            "datetime": "2019-07-23T11:54:49+00:00",
            "height": -0.7043281227298378,
            "state": "FALLING"
        },
        {
            "timestamp": 1563884689,
            "datetime": "2019-07-23T12:24:49+00:00",
            "height": -0.8609037836968269,
            "state": "FALLING"
        },
        {
            "timestamp": 1563886489,
            "datetime": "2019-07-23T12:54:49+00:00",
            "height": -0.9593561027835635,
            "state": "FALLING"
        },
        {
            "timestamp": 1563888289,
            "datetime": "2019-07-23T13:24:49+00:00",
            "height": -0.9942522672549204,
            "state": "FALLING"
        },
        {
            "timestamp": 1563890089,
            "datetime": "2019-07-23T13:54:49+00:00",
            "height": -0.964337632267706,
            "state": "RISING"
        },
        {
            "timestamp": 1563891889,
            "datetime": "2019-07-23T14:24:49+00:00",
            "height": -0.8716614718239951,
            "state": "RISING"
        },
        {
            "timestamp": 1563893689,
            "datetime": "2019-07-23T14:54:49+00:00",
            "height": -0.7212193848273836,
            "state": "RISING"
        },
        {
            "timestamp": 1563895489,
            "datetime": "2019-07-23T15:24:49+00:00",
            "height": -0.5211670842640376,
            "state": "RISING"
        },
        {
            "timestamp": 1563897289,
            "datetime": "2019-07-23T15:54:49+00:00",
            "height": -0.2831688305414994,
            "state": "RISING"
        },
        {
            "timestamp": 1563899089,
            "datetime": "2019-07-23T16:24:49+00:00",
            "height": -0.02233025743008191,
            "state": "RISING"
        },
        {
            "timestamp": 1563900889,
            "datetime": "2019-07-23T16:54:49+00:00",
            "height": 0.24360678789143733,
            "state": "RISING"
        },
        {
            "timestamp": 1563902689,
            "datetime": "2019-07-23T17:24:49+00:00",
            "height": 0.4957954147608776,
            "state": "RISING"
        },
        {
            "timestamp": 1563904489,
            "datetime": "2019-07-23T17:54:49+00:00",
            "height": 0.7162773693565154,
            "state": "RISING"
        },
        {
            "timestamp": 1563906289,
            "datetime": "2019-07-23T18:24:49+00:00",
            "height": 0.890034807136671,
            "state": "RISING"
        }
    ],
    "copyright": "©2019 API Hood. Generated using AVISO+ Products."
}

JSON response was pretty printed manually

Documentation

For full documentation and interactive console, please see RapidAPI Endpoints and API Details pages.

Changelog

Unlimited radius parameter (November 2019)

The radius parameter was limited to 1000 (km) and default was set to 100 (km). We changed the default behaviour that without specified radius parameter the search will return the nearest tide prediction regardless the prediction (origin) distance from the selected location. You can still limit the radius by setting radius parameter to any positive integer.

Nearest predictions (September 2019)

Before this change, for coordinates far from nearest prediction the 400 HTTP status was returned with "No data found for selected location.". Even if the calculation is just a few kilometres away.

Now the API returns prediction for the nearest point in 100 km radius. The radius can be set using the radius parameter (defaults to 100, allowed maximum is 1000). The origin coordinates are added to the response as origin attribute together with the distance between the origin and requested point (the distance is calculated using Vincenty's formulae).

{
  //...
    "origin": {
        "latitude": 45.375,
        "longitude": -4.375,
        "distance": 1.53,
        "unit": "km"
    }
  //...
}

Lowest and Highest Astronomical Tide (September 2019)

The API now returns values for Lowest Astronomical Tide (LAT) and Highest Astronomical Tide (HAT) for each prediction origin.

{
    //...
    "datums": {
        "LAT": -2.270791320800781,
        "HAT": 2.2990721130371092
    }
    //...
}

Please note, that this feature is experimental and can be removed in the future.

Planned features

Pricing

We are providing 3000 free requests per month. For more plans, please see RapidAPI pricing page.

Research purposes

We want to support researchers interested in the API use, so if you want to use the API for research purposes and need more requests, contact us for a custom plan and we will try to do our best to support your research.

Unlimited access

If you need a plan with unlimited requests, contact us for a custom plan.

Connect on RapidAPI