NOAA National Weather Service API (api.weather.gov) vs Pirate Weather

NOAA National Weather Service API (api.weather.gov)

Free, no key and no account, with public domain data. US and territories only.

Pirate Weather

Named model sources and a documented priority order for every field. No SLA, and the terms call it best effort.

NOAA National Weather Service API (api.weather.gov)

1. Set User-Agent to your app name and a contact email or the request is refused with 403
2. Cache the /points response per coordinate. The office and grid rarely change
3. Round coordinates to four decimal places. More precision returns an error
4. Don't add cache-busting query parameters. Unknown parameters return 400
5. Back off about five seconds after a throttled request and reuse the last good response

Pirate Weather

1. Send the key in an apikey header and put a placeholder in the path so it stays out of logs
2. Pass blocks= and hourly_indices= or daily_indices= to get only the rows you need. The default payload is large
3. Ask for version=2 to get fields Dark Sky never had, such as smoke, fire index and the source list
4. Point historical requests at timemachine.pirateweather.net with a UNIX timestamp after the coordinate
5. Watch Ratelimit-Remaining. The cap is monthly, so a runaway loop can spend it in a day