What it returns
Official NOAA CO-OPS data for 3,000+ US coastal stations. Public domain.
Common uses
Fishing, boating and surf apps, coastal travel content, marina and beach dashboards, flood monitoring. Pay per record.
Request
POST https://api.pushbuild.com/noaa-tides/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
product | string: tide-highs-lows, tide-hourly, water-level, water-temperature, air-temperature, wind, air-pressure | What to return. Default: "tide-highs-lows". |
stations | list of strings | NOAA station IDs, e.g. 8518750 (The Battery, NY). |
stationName | string | Find stations by name, e.g. Santa Monica. |
state | string | Two-letter state code, e.g. FL. |
near | string | Stations near these coordinates, nearest first. |
radiusKm | integer | Search radius for Near. Default: 50. |
maxStations | integer | How many found stations to fetch data for. Default: 5. |
listStations | boolean | Return matching stations instead of data. Default: false. |
startDate | string | First day (YYYY-MM-DD). Default today. |
endDate | string | Last day (YYYY-MM-DD). |
days | integer | Number of days from the start date, if no end date. Default: 1. |
units | string: english, metric | Feet/Fahrenheit or metres/Celsius. Default: "english". |
timeZone | string: lst_ldt, lst, gmt | Station local time, local standard time, or GMT. Default: "lst_ldt". |
datum | string: MLLW, MLW, MSL, MTL, MHW, MHHW, NAVD, STND | Vertical datum for tides and water levels. Default: "MLLW". |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/noaa-tides/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"stations": ["8518750"], "maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.16 per 1,000 records. No charge for errors or empty searches.
Related APIs
Public Holidays API
Public and bank holidays for 100+ countries by year or date range, with regional (state/province) holidays, holiday types, long weekends with bridge days, worldwide upcoming holidays, and an is-it-a-holiday check for any list of dates..
TSA Checkpoint Travel Numbers + BTS Transportation Stats API
Daily TSA airport checkpoint passenger counts since 2019 with year-over-year and 7-day averages, plus BTS monthly transportation statistics: airline passengers, on-time performance, air cargo, freight rail, trucking, transit and the Transportation Services Index..
US Weather API
National Weather Service data for any US ZIP code, city or coordinates: 7-day forecast, hourly forecast, latest observed conditions and active severe-weather alerts.
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com