curl -X GET 'https://api.parse.bot/scraper/8b6c67cb-8ac9-4eee-959a-ff31ae1720ef/get_weather' \ -H 'X-API-Key: $PARSE_API_KEY'
Get current weather conditions and a 3-day forecast with hourly breakdowns for a given location. Returns temperature, wind, humidity, precipitation, UV index, astronomy data (sunrise/sunset/moon), and hourly forecasts for each day.
| Param | Type | Description |
|---|---|---|
| locationrequired | string | Location to get weather for. Accepts city names (e.g. 'New York', 'London'), coordinates (e.g. '48.8566,2.3522'), airport codes (e.g. 'JFK'), or landmarks. |
{
"type": "object",
"fields": {
"current": "object with temp_c, temp_f, feels_like_c, feels_like_f, humidity, weather_desc, wind_speed_kmph, wind_speed_mph, wind_direction, pressure_mb, visibility_km, uv_index, cloud_cover, precip_mm, observation_time",
"forecast": "array of 3 day objects each with date, max/min/avg temps, sunrise, sunset, moon_phase, and hourly array",
"location": "object with name, country, region, latitude, longitude"
},
"sample": {
"current": {
"temp_c": "18",
"temp_f": "64",
"humidity": "70",
"uv_index": "1",
"precip_mm": "0.0",
"cloud_cover": "0",
"pressure_mb": "1015",
"feels_like_c": "11",
"feels_like_f": "52",
"weather_desc": "Sunny",
"visibility_km": "10",
"wind_direction": "NNW",
"wind_speed_mph": "8",
"wind_speed_kmph": "12",
"observation_time": "12:28 PM"
},
"forecast": [
{
"date": "2026-06-01",
"hourly": [
{
"time": "0",
"temp_c": "18",
"temp_f": "65",
"humidity": "40",
"uv_index": "0",
"precip_mm": "0.0",
"cloud_cover": "0",
"feels_like_c": "18",
"weather_desc": "Clear ",
"chance_of_rain": "0",
"wind_direction": "ENE",
"wind_speed_kmph": "13"
}
],
"sunset": "08:21 PM",
"moonset": "05:53 AM",
"sunrise": "05:27 AM",
"moonrise": "10:05 PM",
"avg_temp_c": "19",
"avg_temp_f": "66",
"max_temp_c": "24",
"max_temp_f": "75",
"min_temp_c": "15",
"min_temp_f": "59",
"moon_phase": "Waning Gibbous"
}
],
"location": {
"name": "Greenwich Village",
"region": "New York",
"country": "United States of America",
"latitude": "40.728",
"longitude": "-74.003"
}
}
}About the wttr.in API
The wttr.in API exposes 2 endpoints that return current weather conditions and multi-day forecasts for any location worldwide. The get_weather endpoint delivers a full 3-day forecast with hourly breakdowns, astronomy data, and 15+ response fields per day. The get_current_weather endpoint returns a flat snapshot of present conditions including temperature, pressure, UV index, cloud cover, and precipitation without forecast data.
Endpoints and What They Return
The get_weather endpoint accepts a location string — city names like London or coordinates like 48.8566,2.3522 — and returns three top-level objects: current, forecast, and location. The current object includes temp_c, temp_f, feels_like_c, feels_like_f, humidity, weather_desc, wind_speed_kmph, wind_speed_mph, wind_direction, and related fields. The forecast array contains 3 day objects, each with date, max/min/avg temperatures, sunrise, sunset, moon_phase, and an hourly array for granular intraday data.
Current-Conditions Endpoint
The get_current_weather endpoint targets use cases where forecast data is unnecessary. It returns a flat object with temp_c, temp_f, feels_like_c, humidity, pressure_mb, uv_index, cloud_cover, precip_mm, wind_degree, and a location sub-object containing name, country, region, latitude, and longitude. This endpoint is lighter and suitable for dashboards or status displays that only need a real-time snapshot.
Location Input
Both endpoints accept the same location parameter. City names, region names, and decimal coordinate pairs are all valid inputs. The location object in each response echoes back the resolved name, country, region, and latitude/longitude, so you can confirm which location the response corresponds to — useful when passing ambiguous city names.
- Display current temperature and humidity on a travel planning dashboard using
get_current_weather - Build a 3-day trip weather summary using the
forecastarray fromget_weather - Show sunrise and sunset times for a given city by reading
sunriseandsunsetfields in the forecast day objects - Alert users when UV index exceeds a threshold using the
uv_indexfield fromget_current_weather - Render an hourly temperature chart for today using the
hourlyarray in the first forecast day object - Display moon phase information for astronomy or gardening apps using
moon_phasefrom the forecast
| 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 wttr.in have an official developer API?+
What does the `get_weather` endpoint return that `get_current_weather` does not?+
get_weather includes a forecast array with 3 day objects, each containing max/min/avg temperatures, sunrise, sunset, moon_phase, and an hourly breakdown. get_current_weather returns only a flat snapshot of present conditions with no forecast or astronomy data.Does the API return hourly forecasts beyond a 3-day window?+
forecast array covers 3 days with hourly data per day. You can fork this API on Parse and revise it to request extended forecast ranges if the underlying source supports them.Are historical weather records available through this API?+
How specific can the `location` input be — can I pass a zip code or airport code?+
location parameter accepts city names and decimal coordinate pairs. Zip codes and airport codes are not explicitly listed as supported inputs. If a city name is ambiguous, the resolved location is echoed back in the location response object — check name, country, and region to verify the match.