NOAA Tides and Water Levels — Official US Observations
Pricing
from $0.50 / 1,000 results
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
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
25 days ago
Last modified
Categories
Features
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
- Enter a station id (a seven-digit NOAA number, e.g.
8454000for Providence or9414290for San Francisco) and pick a product —water_levelfor measured water,predictionsfor the astronomical tide, or a temperature or wind product. - Choose the date:
latestfor one reading,todayfor the current day, or a range such as20261001-20261007. - Run the Actor. Each reading becomes a row in the dataset's Overview tab; the
SUMMARYrecord reports the count and whether the row cap cut the run short.
{"station": "8454000","product": "water_level","date": "today","units": "metric","maxItems": 500}
Inputs
| Input | Purpose | Default |
|---|---|---|
station | NOAA station id. The station's own metadata, not this Actor, decides which products it supports. | 8454000 when left blank |
product | What to measure: water_level, predictions, air_temperature, water_temperature or wind. | water_level when left blank |
date | latest, today, or a start–end range written YYYYMMDD-YYYYMMDD. | latest when left blank |
units | metric or english. The Actor does not convert; it passes your choice to the source. | metric when left blank |
maxItems | Hard ceiling on rows. A six-minute reading series fills 500 rows in about two days. | 500 |
maxPages | Kept 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
| Field | Meaning |
|---|---|
time | The reading's timestamp in GMT, in the source's format YYYY-MM-DD HH:MM. Not ISO 8601 — no T, no Z. |
value | The 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. |
sigma | The source's standard-deviation figure for the reading, as a number in the same units as value. It is copied, not computed here. |
flags | The source's quality/status flags for the reading, e.g. 0,0,0,0. Omitted when the product has none. |
quality | v 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.
latestis one row. It returns the most recent reading, not a series. Usetodayor 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_levelis measured and can include a storm surge.predictionsis astronomical and cannot. - Preliminary readings get revised. A
preading can change after quality control;vreadings are the settled version. - Units are not converted.
metricandenglishare 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.