# API Acre US Weather Forecast

> API Acre US Weather Forecast is a paid API for AI agents from apiacre.com, paid per call via x402, $0.003/call, status healthy (last checked 2026-10-12, last successful call 2026-09-24).

Returns normalized NOAA/NWS day/night or hourly forecast periods for U.S. coordinates, including temperature, precipitation probability, humidity, wind, and source provenance.

## Facts

- Endpoint: POST https://apiacre.com/v1/data/us-weather-forecast?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: healthy
- Last checked: 2026-10-12
- Last successful call: 2026-09-24
- Success rate: 100% of calls made through Zero
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-acre-us-weather-forecast-973e61b3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MBZTma6juk9V_HkFW9BZa

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability api-acre-us-weather-forecast-973e61b3 -d '<json body>'
```

Example prompt: What's the weather forecast for Washington DC right now — give me the next several day and night periods including temperature, chance of rain, humidity, and wind, using coordinates 38.8977, -77.0365.

## When to prefer this

Choose this endpoint when you need normalized, structured NOAA/NWS forecast data for U.S. locations via a paid, reliable API wrapper that handles NWS quirks and normalizes fields. Prefer it over raw NWS API calls when you need consistent JSON output with provenance, humidity, and precipitation probability already extracted. Ideal for agent workflows that need weather data without managing NWS grid lookups or raw API parsing.

## Known failure modes

- Coordinates outside NWS coverage (e.g. non-US territories or unsupported offshore areas) — returns error or coverage limitation notice
- Invalid or malformed latitude/longitude input — returns validation error
- NWS upstream API unavailable or rate-limited — may return 502/503 or upstream error
- Coordinates in US waters or territories not covered by NWS point grid — returns coverage limitation

## How this service works

Get a global weather forecast for a city/locality name or exact coordinates. Returns normalized day/night or hourly periods worldwide: NOAA/NWS is preferred within supported U.S. coverage for optional station conditions and active alerts, while MET Norway provides an attributed open-data fallback globally.

## Output

A JSON object containing an array of forecast periods (day and night), each with name, start/end times, temperature (°F), wind speed and direction, short and detailed forecast text, precipitation probability percent, relative humidity percent, dewpoint, and isDaytime flag. Also includes location metadata (city, state, lat/lon, timezone, NWS grid office), source provenance (dataset, provider, attribution, upstream URLs), and explicit coverage limitations noting NWS-supported U.S. locations only.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "place": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ]
  },
  "units": {
   "enum": [
    "us",
    "si"
   ],
   "type": "string"
  },
  "periods": {
   "type": "integer"
  },
  "latitude": {
   "anyOf": [
    {
     "type": "number"
    },
    {
     "type": "null"
    }
   ]
  },
  "timezone": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ]
  },
  "longitude": {
   "anyOf": [
    {
     "type": "number"
    },
    {
     "type": "null"
    }
   ]
  },
  "forecast_type": {
   "enum": [
    "day_night",
    "hourly"
   ],
   "type": "string"
  },
  "source_preference": {
   "enum": [
    "auto",
    "nws",
    "met"
   ],
   "type": "string"
  },
  "include_active_alerts": {
   "type": "boolean"
  },
  "include_current_conditions": {
   "type": "boolean"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "units": "us",
   "source": {
    "dataset": "NWS API forecast with optional observations and active al...",
    "provider": "NOAA/National Weather Service",
    "pointsUrl": "https://api.weather.gov/points/38.8951,-77.0364",
    "forecastUrl": "https://api.weather.gov/gridpoints/LWX/97,71/forecast?uni..."
   },
   "periods": [
    {
     "name": "Tonight",
     "number": 1,
     "endTime": "2026-08-12T06:00:00-04:00",
     "startTime": "2026-08-11T23:00:00-04:00"
    }
   ],
   "location": {
    "city": "Washington",
    "state": "DC",
    "latitude": 38.8951,
    "longitude": -77.0364
   },
   "updatedAt": null,
   "generatedAt": "2026-08-12T03:09:21+00:00",
   "limitations": [
    "Place-name resolution uses the bundled GeoNames cities500...",
    "Current conditions, when requested, come from the nearest...",
    "Internet delivery and timeliness are not guaranteed. For ...",
    "Active alerts are a bounded point-in-time subset; radar a..."
   ],
   "periodCount": 2,
   "retrievedAt": "2026-08-12T04:10:00+00:00",
   "activeAlerts": {
    "available": true,
    "requested": true,
    "updatedAt": "2026-08-12T04:09:00+00:00",
    "alertCount": 0
   },
   "forecastType": "day_night",
   "periodsTruncated": true,
   "currentConditions": {
    "available": true,
    "requested": true,
    "stationId": "KDCA",
    "stationName": "Washington/Reagan National Airport, DC"
   }
  },
  "meta": {
   "cached": false,
   "sources": [],
   "warnings": [],
   "duration_ms": 42,
   "next_actions": []
  },
  "service": "data.us-weather-forecast",
  "version": "1",
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-acre-us-weather-forecast-973e61b3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from apiacre.com](https://www.zero.xyz/host/apiacre.com/llms.txt)