bom.gov.au APIwww.bom.gov.au ↗
Access Bureau of Meteorology weather forecasts for Australian cities. Get multi-day temperature, precipitation, UV index, and location search via 2 endpoints.
curl -X GET 'https://api.parse.bot/scraper/fd5101ce-6a40-4855-966d-758610b61fb0/get_forecast?city=Brisbane&days=2' \ -H 'X-API-Key: $PARSE_API_KEY'
Get multi-day weather forecast for an Australian city. Returns daily forecasts with temperature, precipitation probabilities, UV index, and weather description.
| Param | Type | Description |
|---|---|---|
| city | string | Australian city name to get forecast for. |
| days | integer | Number of forecast days to return (1 to 8). |
{
"type": "object",
"fields": {
"location": "object containing name, state, postcode, latitude, longitude, and timezone",
"forecasts": "array of daily forecast objects with date, temp_max_celsius, temp_min_celsius, weather_description, precipitation, and uv_index_max",
"days_requested": "integer number of days requested",
"issue_time_utc": "string ISO timestamp of when the forecast was issued"
},
"sample": {
"data": {
"location": {
"name": "Sydney",
"state": "NSW",
"latitude": -33.8593,
"postcode": "2000",
"timezone": "Australia/Sydney",
"longitude": 151.2048
},
"forecasts": [
{
"date": "2026-05-14T14:00:00Z",
"uv_index_max": 3.511648,
"precipitation": {
"probability_percent": 82,
"amount_10pct_chance_mm": 16,
"amount_25pct_chance_mm": 9.1,
"amount_50pct_chance_mm": 3.9,
"amount_75pct_chance_mm": 0.9,
"probability_10mm_percent": 22,
"probability_25mm_percent": 3
},
"temp_max_celsius": 22.1,
"temp_min_celsius": 14.4,
"weather_icon_code": 11,
"weather_description": "Showers"
}
],
"days_requested": 3,
"issue_time_utc": "2026-05-14T18:00:11Z"
},
"status": "success"
}
}About the bom.gov.au API
The BOM API provides weather forecast data sourced from Australia's Bureau of Meteorology across 2 endpoints. The get_forecast endpoint returns up to 8 days of daily forecasts — including max/min temperatures in Celsius, precipitation probability, UV index, and weather descriptions — for any searchable Australian city. The search_locations endpoint resolves city and suburb names to geocoded location records with state, postcode, and timezone.
Endpoints and Data Returned
The get_forecast endpoint accepts a city string and an optional days integer (1–8). It returns a location object with name, state, postcode, latitude, longitude, and timezone, alongside a forecasts array. Each forecast entry covers a single date and includes temp_max_celsius, temp_min_celsius, weather_description, precipitation, and uv_index_max. The response also carries an issue_time_utc timestamp indicating when the Bureau published the forecast.
Location Search
The search_locations endpoint accepts a query string and returns a locations array of matching cities, suburbs, and weather stations. Each record includes an id, name, state, postcode, latitude, longitude, and timezone. The total field tells you how many results matched. Use this endpoint to resolve ambiguous city names before calling get_forecast — for example, to distinguish between multiple suburbs sharing the same name across different states.
Coverage and Freshness
Coverage is limited to Australian locations served by the Bureau of Meteorology. The forecast horizon is capped at 8 days, matching what BOM publishes. The issue_time_utc field in the forecast response tells you exactly how fresh the data is, so you can handle caching and staleness in your own application logic.
- Display a 7-day outlook widget on an Australian travel or event planning site using
temp_max_celsius,temp_min_celsius, andweather_description. - Alert users when precipitation probability crosses a threshold for a chosen city.
- Show UV index warnings for outdoor activity apps targeting Australian users.
- Resolve user-entered suburb names to canonical BOM location IDs before fetching forecasts.
- Feed daily min/max temperature data into a historical logging pipeline for trend analysis.
- Filter sporting event schedules by forecast conditions for venues in specific Australian states.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does the Bureau of Meteorology have an official developer API?+
What does the `forecasts` array in `get_forecast` actually contain per day?+
temp_max_celsius, temp_min_celsius, weather_description, precipitation, and uv_index_max. The array length matches the days_requested value, up to a maximum of 8.Does the API return hourly forecast data?+
get_forecast returns daily-resolution forecasts only. Each day has a single max temperature, min temperature, precipitation value, and UV index. You can fork the API on Parse and revise it to add an hourly forecast endpoint if finer time resolution is needed.Is there any location coverage outside Australia?+
How do I handle cases where a city name matches multiple locations?+
search_locations first. It returns a total count and a locations array that includes state and postcode for each match, letting you present a disambiguation UI or select the correct record before calling get_forecast.