NOAA Tides and Water Levels — Official US Observations avatar

NOAA Tides and Water Levels — Official US Observations

Pricing

from $0.50 / 1,000 results

Go to Apify Store
NOAA Tides and Water Levels — Official US Observations

NOAA Tides and Water Levels — Official US Observations

Tide and water level readings from NOAA stations as flat rows — time, value, sigma and quality flags. Free public API, no key.

Pricing

from $0.50 / 1,000 results

Rating

0.0

(0)

Developer

alaudin burki

alaudin burki

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

25 days ago

Last modified

Features

Limited permissions

Share

Tide and water level readings from NOAA's tide stations, returned as one flat row per reading. Choose a station, a product and a date ("latest", "today", or a range) and the Actor writes each reading as a row with its timestamp, value, sigma, quality flags and quality code. No API key and no account are needed.

How to use

  1. Enter a station id (a seven-digit NOAA number, e.g. 8454000 for Providence or 9414290 for San Francisco) and pick a product — water_level for measured water, predictions for the astronomical tide, or a temperature or wind product.
  2. Choose the date: latest for one reading, today for the current day, or a range such as 20261001-20261007.
  3. Run the Actor. Each reading becomes a row in the dataset's Overview tab; the SUMMARY record reports the count and whether the row cap cut the run short.
{
"station": "8454000",
"product": "water_level",
"date": "today",
"units": "metric",
"maxItems": 500
}

Inputs

InputPurposeDefault
stationNOAA station id. The station's own metadata, not this Actor, decides which products it supports.8454000 when left blank
productWhat to measure: water_level, predictions, air_temperature, water_temperature or wind.water_level when left blank
datelatest, today, or a start–end range written YYYYMMDD-YYYYMMDD.latest when left blank
unitsmetric or english. The Actor does not convert; it passes your choice to the source.metric when left blank
maxItemsHard ceiling on rows. A six-minute reading series fills 500 rows in about two days.500
maxPagesKept for consistency with other Actors. One product-and-date request is one response, so the Actor makes a single request per run and this setting does not change the result.5

The request pins the datum to MLLW (Mean Lower Low Water) and the time zone to GMT; neither is an input, so every run is directly comparable with the next.

Output

FieldMeaning
timeThe reading's timestamp in GMT, in the source's format YYYY-MM-DD HH:MM. Not ISO 8601 — no T, no Z.
valueThe reading as a number, converted from the string the source sends. Units follow your units choice: metres or feet for water, °C or °F for temperature.
sigmaThe source's standard-deviation figure for the reading, as a number in the same units as value. It is copied, not computed here.
flagsThe source's quality/status flags for the reading, e.g. 0,0,0,0. Omitted when the product has none.
qualityv for verified or p for preliminary, when the source supplies it. Omitted for products that are not observations.

Each row also carries id, source, firstSeenAt and scrapedAt. sigma, flags and quality are left out of a row entirely when the chosen product does not return them, rather than written as nulls.

Why this is different

NOAA sends every measurement as a string, which breaks any declared numeric schema the moment it is pushed. This Actor converts value and sigma to real numbers, flattens each reading to one standalone row, and keeps the source's own flags and quality code alongside it so an observation can be audited rather than just trusted. Rows are de-duplicated and sorted deterministically, and the run records why it stopped.

Limitations

  • US waters only. NOAA's tide and currents service covers United States stations and territories.
  • latest is one row. It returns the most recent reading, not a series. Use today or a range for a series.
  • Range format matters. Write ranges as YYYYMMDD-YYYYMMDD; other date formats are rejected by the source.
  • Observations and predictions are different things. water_level is measured and can include a storm surge. predictions is astronomical and cannot.
  • Preliminary readings get revised. A p reading can change after quality control; v readings are the settled version.
  • Units are not converted. metric and english are different datasets, not two views of one.
  • Datum is fixed at MLLW. A reading quoted against another datum is not comparable without a conversion.
  • Sigma is the source's, not a confidence interval you should read as a forecast error band.

FAQ

Do I need an API key? No. The request carries no key or token.

Why does latest return only one row? Because that is what the source returns for latest — the most recent reading. Ask for today or a range to get a series.

How do I find a station id? NOAA numbers its stations; the ids are seven digits. 8454000 and 9414290 are two valid examples to test with.

Why is sigma missing? Not every product reports it, and this Actor omits a field the source did not send rather than filling it with zero.

Are value strings or numbers? Numbers. The source sends strings, the Actor converts them, and the dataset schema declares them as numbers.

Pricing and limits

The price is shown on the Actor's Apify pricing panel before you run it. maxItems is enforced in code, and the dataset states whether the cap truncated the run in SUMMARY. A day of six-minute readings is already more than 200 rows, so raise maxItems when you ask for a long range.