Surfline Surf Forecast Scraper

Overview

Get surf forecasts for any spot worldwide. Search by location or paste Surfline URLs. Includes ratings, wave height, swell direction/period, wind, tides, and water temperature.

Features

• Search by keywords to find specific results
• Filter results by category or type
• Export data in JSON, CSV, or Excel formats
• Includes ratings and review data
• Includes location and address data
• Built-in proxy support for reliable data collection

Use Cases

• Track - Track entertainment listings and reviews
• Build - Build media databases for content analysis
• Monitor - Monitor entertainment industry trends and ratings
• Aggregate - Aggregate entertainment data for recommendation engines

Input Parameters

Parameter	Type	Description	Default
collectAll	boolean	Collect current conditions for ALL 9,000+ spots worldwide (for scheduled dail...	false
locationSearch	string	Search for surf spots by location name (e.g., 'San Diego', 'Huntington Beach'...
regionFilter	string	Filter search results by region (e.g., 'California', 'USA', 'Southern Califor...
spotUrls	array	Direct Surfline URLs (e.g., https://www.surfline.com/surf-report/blacks-beach...
days	integer	Number of days to forecast (1-7)	7
includeHistorical	boolean	Include past forecast data from our database starting from yesterday (if avai...	false
historicalDays	integer	How many days of historical data to include, starting from yesterday (if incl...	30
maxSpots	integer	Maximum number of spots to return from location search	5
proxyConfiguration	object	Proxy configuration - residential proxies required for Surfline API	{...}

Output Example

Each result contains structured data like this:

{
  "mode": "Sample mode",
  "timestamp": "Sample timestamp",
  "totalSpots": "Sample totalSpots",
  "savedToDatabase": "Sample savedToDatabase",
  "sampleSpots": "Sample sampleSpots",
  "id": "ABC-12345",
  "name": "Surfline Surf Forecast Sample Item",
  "region": "Sample region",
  "rating": 4.5,
  "waveHeight": "Sample waveHeight"
}

Pricing

This actor uses pay-per-result pricing:

• $0.001 per result
• $1.00 per 1,000 results

No monthly fees. You only pay for what you scrape. Apify Free plan includes $5/month in platform credits.

How to Run

Apify Console

1. Go to the Surfline Surf Forecast Scraper actor page
2. Configure your input parameters
3. Click Start and wait for the results
4. Download data in JSON, CSV, or Excel format

API

curl -X POST "https://api.apify.com/v2/acts/fortuitous_pirate~surfline-forecast/runs?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"maxItems": 10}'

Python SDK

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")
run = client.actor("fortuitous_pirate/surfline-forecast").call(
    run_input={"maxItems": 10}
)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

Integration

Connect Surfline Surf Forecast Scraper with your existing tools and workflows:

• API access - Programmatic access via Apify API
• Webhooks - Get notified when scraping completes
• Scheduling - Set up recurring runs on any schedule
• Zapier / Make - Connect with 5,000+ apps via Apify integrations
• Python / Node.js SDKs - Native client libraries for easy integration