Pirate Weather vs The Weather Company Data APIs

Pirate Weather

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

The Weather Company Data APIs

A wide weather data API with 168 API references built from OpenAPI documents, global 4 km current conditions, hourly history from June 2015 and a status page with component history. Keys come only through a sales-reviewed trial or contract, travel only in the URL, and the terms that govern the API are not published.

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

The Weather Company Data APIs

1. Send units, language and format=json with a location on every v3 call, plus Accept-Encoding: gzip, which the usage guide marks as required.
2. Keep the key out of logs and client-side code, because it travels in the query string as apiKey.
3. Treat a 401 as either a bad key, an endpoint outside the key's package or an exceeded limit, and treat a 204 as no data for the query.
4. Each forecast duration (3day to 15day) is a separate entitlement. Request only durations the contract covers.
5. Use /v3/aggcommon to combine up to 10 products in one request. Each product and each location still counts as one call.