What it returns
Official National Weather Service data for any US location, as clean JSON.
7-day forecast**: day and night periods with temperature, precipitation chance, wind and text forecast. Hourly forecast**: up to 156 hours. Current conditions**: latest reading from the nearest station (temperature, humidity, wind, pressure, visibility). Active alerts**: watches, warnings and advisories with severity, timing and instructions.
Request
POST https://api.pushbuild.com/us-weather/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
locations required | list of strings | US ZIP codes, "City, ST" or "lat,lon". |
forecast | boolean | Day and night periods for the next 7 days. Default: true. |
hourly | boolean | Hour-by-hour forecast. Default: false. |
hourlyHours | integer | How many hours to return (max 156). Default: 48. |
current | boolean | Latest observation from the nearest weather station. Default: true. |
alerts | boolean | Watches, warnings and advisories in effect at the location. Default: true. |
units | string: us, metric | Units for the forecasts. Current conditions are always metric. Default: "us". |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/us-weather/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"locations": ["10001", "Austin, TX", "47.6062,-122.3321"], "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: $1.60 per 1,000 locations. 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..
Tide Times API
Official NOAA tide predictions (high/low and hourly), observed water levels, water and air temperature, wind and pressure for 3,000+ US coastal stations.
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..
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