Surfline
Surf forecasts, surf conditions and swell data
Surf conditions and forecasts for surf spots.
Your information
Surf spot name, such as Pipeline or Huntington Beach Pier.
More options
Location to distinguish spots with the same name, such as Hawaii or California.
Example results
Pipeline: 3–4 ft surf
United States, Hawaii, O‘ahu, Pupukea
Five-day forecast
About the Surfline tool
Surfline returns current conditions and five forecast days for a named surf spot; provide a spot name and optionally a region.
Forecasts include ratings, wind, swell, and morning and afternoon surf heights; current conditions include tide state and water temperature.
Built from surfline.com. Last checked Sep 29, 2026.
Actions
Get surf forecast
1 creditGet current surf conditions and the five free forecast days for a Surfline spot by name. If a name matches multiple spots, the top match is used unless a region narrows it down. Daily values represent morning (9 a.m.) and afternoon (3 p.m.) local time; other daily values are from 9 a.m.
What you provide
| Field | Type | Required | Description |
|---|---|---|---|
Regionregion | Text | Optional | Location to distinguish spots with the same name, such as Hawaii or California.Example: California |
Spot Namespot_name | Text | Required | Surf spot name, such as Pipeline or Huntington Beach Pier.Example: Pipeline |
What you get
| Field | Type | Description |
|---|---|---|
Regionregion | Text | Example: United States, Hawaii, O‘ahu, Pupukea |
Spot Namespot_name | Text | Example: Pipeline |
Forecast Daysforecast_days | List | |
Dateforecast_days[].date | Date | Example: 2026-09-28 |
Ratingforecast_days[].rating | Text | Example: Fair |
Wind Directionforecast_days[].wind_direction | Text | Example: E |
Wind Speed (mph)forecast_days[].wind_speed_mph | Number | Example: 18.9 |
Main Swell Directionforecast_days[].main_swell_direction | Text | Example: NNW |
Main Swell Height Ftforecast_days[].main_swell_height_ft | Number | Example: 3.1 |
Main Swell Period (seconds)forecast_days[].main_swell_period_seconds | Number | Example: 14 |
Morning Surf Height Max Ftforecast_days[].morning_surf_height_max_ft | Number | Example: 4 |
Morning Surf Height Min Ftforecast_days[].morning_surf_height_min_ft | Number | Example: 3 |
Afternoon Surf Height Max Ftforecast_days[].afternoon_surf_height_max_ft | Number | Example: 4 |
Afternoon Surf Height Min Ftforecast_days[].afternoon_surf_height_min_ft | Number | Example: 3 |
Surfline Linksurfline_link | Text | Example: https://www.surfline.com/surf-report/pipeline/5842041f4e65fad6a7708890 |
Surfline Spot IDsurfline_spot_id | Text | Example: 5842041f4e65fad6a7708890 |
Current Conditionscurrent_conditions | Details | |
Ratingcurrent_conditions.rating | Text | Example: Fair |
Tide Statecurrent_conditions.tide_state | Text | Example: Falling |
Wind Directioncurrent_conditions.wind_direction | Text | Example: E |
Wind Speed (mph)current_conditions.wind_speed_mph | Number | Example: 24.2 |
Surf Height Max Ftcurrent_conditions.surf_height_max_ft | Number | Example: 4 |
Surf Height Min Ftcurrent_conditions.surf_height_min_ft | Number | Example: 3 |
Water Temperature Fcurrent_conditions.water_temperature_f | Number | Example: 80 |
Example result
For Spot Name: Pipeline
{
"region": "United States, Hawaii, O‘ahu, Pupukea",
"spot_name": "Pipeline",
"forecast_days": [
{
"date": "2026-09-28",
"rating": "Fair",
"wind_direction": "E",
"wind_speed_mph": 18.9,
"main_swell_direction": "NNW",
"main_swell_height_ft": 3.1,
"main_swell_period_seconds": 14,
"morning_surf_height_max_ft": 4,
"morning_surf_height_min_ft": 3,
"afternoon_surf_height_max_ft": 4,
"afternoon_surf_height_min_ft": 3
},
{
"date": "2026-09-29",
"rating": "Poor to Fair",
"wind_direction": "ESE",
"wind_speed_mph": 9.3,
"main_swell_direction": "NNW",
"main_swell_height_ft": 2.6,
"main_swell_period_seconds": 12,
"morning_surf_height_max_ft": 3,
"morning_surf_height_min_ft": 2,
"afternoon_surf_height_max_ft": 3,
"afternoon_surf_height_min_ft": 2
},
{
"date": "2026-09-30",
"rating": "Fair",
"wind_direction": "SSE",
"wind_speed_mph": 17.9,
"main_swell_direction": "WSW",
"main_swell_height_ft": 3.5,
"main_swell_period_seconds": 10,
"morning_surf_height_max_ft": 4,
"morning_surf_height_min_ft": 3,
"afternoon_surf_height_max_ft": 3,
"afternoon_surf_height_min_ft": 2
}
],
"surfline_link": "https://www.surfline.com/surf-report/pipeline/5842041f4e65fad6a7708890",
"surfline_spot_id": "5842041f4e65fad6a7708890",
"current_conditions": {
"rating": "Fair",
"tide_state": "Falling",
"wind_direction": "E",
"wind_speed_mph": 24.2,
"surf_height_max_ft": 4,
"surf_height_min_ft": 3,
"water_temperature_f": 80
}
}For developers
Call it from your code with one request. Change the values in input to run it on new data. To get an API key, open Developers at the bottom of Studio, turn on Developer mode and go to API keys.
curl 'https://api.fous.com/v1/query' \
--fail-with-body --silent --show-error --max-time 180 \
-H "Authorization: Bearer YOUR_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"api": "@surfline",
"visibility": "public",
"operation": "get_surf_forecast",
"version": 1,
"input": {
"spot_name": "Pipeline"
},
"response": {
"format": "json"
}
}'What you can do with it
- Compare forecast surf heights across named spots
- Track swell direction and period for surf planning
- Review current wind, tide, and water temperature
- Plan sessions around morning and afternoon conditions
Questions about Surfline
Can I run it with my own inputs?
Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.
Can I call this Surfline tool as an API?
Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.
How much does it cost?
Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.
Do I need a Surfline account?
No. You only need a Fous account.
How current is the data?
Fous gets the data from surfline.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.
What are the surf conditions at a spot?
Get surf forecast returns current conditions, including rating, tide state, wind, surf height, and water temperature.
What is the surf forecast for the next five days?
Get surf forecast returns five forecast days with ratings, wind, swell, and morning and afternoon surf heights.