wttr.in
Weather in your terminal, supports JSON output
- Authentication
- No auth
- HTTPS
- Yes
- CORS
- Yes
- Category
- Weather
- Documentation / URL
- https://wttr.in/:help
Overview
wttr.in is a command-line-friendly weather service: point curl at a city name and get a beautiful ANSI-formatted forecast right in your terminal. It also supports JSON, plain text, and PNG output, and requires no API key.
It’s the classic “weather in your terminal” tool — great for shell scripts, status bars, MOTD, and quick checks.
Quick Start
Weather for your IP location:
curl wttr.in
Weather for a specific city:
curl wttr.in/London
curl wttr.in/Shanghai
JSON output (great for scripts):
curl "wttr.in/London?format=j1"
Compact one-line format:
curl "wttr.in/London?format=3"
Custom format with placeholders:
curl "wttr.in/London?format=%c+%t+%w"
What you can do
- City names,
lat,loncoordinates, or ICAO airport codes (wttr.in/EGLL) ?format=j1full JSON for programmatic use?format=3/4/5compact text variants- PNG output for embedding in web pages:
wttr.in/London.png - Forecast for multiple days (default 3 days)
Authentication
None — wttr.in works without registration or keys.
Rate Limits & Notes
- Free and keyless; be polite with heavy automation (it’s a free community service).
- Data coverage is global; some stations update more frequently than others.
?format=j1returns a fairly large JSON — cache it if you poll often.
FAQ
Does wttr.in need an API key? No — it’s completely keyless.
Can I get JSON instead of terminal art?
Yes — append ?format=j1 for full JSON, or ?format=3 for a compact text line.
Can I embed it in a web page?
Yes — PNG output (wttr.in/London.png) renders the forecast as an image.