- Use at your own risk. I can't guarantee that the API will always be up, and sometimes the structure of requests and responses will change.
- Predicting the future is hard. Sometimes forecasts won't be accurate. I constantly make improvements to the core algorithm, largely based on issues in the existing one.
- If you make use of Spitcast's data in a public way, please provide attribution. It doesn't need to be a big mention. Just mention it somewhere.
- Whatever you build, please don't call it Spitcast. For example, if your name is Jimmy and you build an Android app, don't name it Spitcast in the Play Store. Name it something like "Jimmy's Surf App" and then mention that it's powered by Spitcast in the description or something.
- Share what you've built. I love seeing the different ways this data can be used.
This is a (growing) list of California surf spots where Spitcast provides forecasts.
https://api.spitcast.com/api/spot
This provides surf forecasts for a given surf spot. These are generated by Spitcast. The structure of the request is: /{spot_id}/{year}/{month}/{day}. In the response, the shape values equate to 0.0 = Poor, 0.5 = Poor-Fair, 1.0 = Fair, >1.0 = Good
https://api.spitcast.com/api/spot_forecast/1/2023/3/14
This provides regional swell information from NOAA's WAVEWATCH III. The structure of the request is: /{county_id}/{year}/{month}/{day}
https://api.spitcast.com/api/buoy_ww3/1/2023/3/14
This provides wind information from NOAA's National Digital Forecast Database. The structure of the request is: /{county_id}/{year}/{month}/{day}
https://api.spitcast.com/api/buoy_ndfd/1/2023/3/14
This provides tide information from NOAA's Tides & Currents. The structure of the request is: /{county_id}/{year}/{month}/{day}
https://api.spitcast.com/api/buoy_tide/1/2023/3/14
This provides wind information from NOAA's National Data Buoy Center. The structure of the request is: /{county_id}/{year}/{month}/{day}