🏄 Surfmarket Scraper

Pull live product data from Surfmarket.org — Europe’s big surf / SUP / foil / skate shop — into clean CSV or JSON.

Pick a category, search by keyword, or paste a shop URL. Get titles, prices, stock flags, images, and direct product links.

💡 Perfect for...

• Price monitoring: Track shortboards, wetsuits, fins, and foil gear across the catalog.
• Assortment research: Compare brands like O’Neill, FCS, Futures, Tabou, Next, and more.
• 🤖 AI Agents: Structured category/search input → product rows with URLs.
• 🔗 Workflows: Feed Make, n8n, Zapier, or your own stack.

✨ Why you'll love this scraper

• 📂 Browse by category — surfboards, fins, wetsuits, SUP, foil, skate, windsurf, kite, and more.
• 🔎 Keyword search — find “oneill”, “fcs”, “tabou” across the shop.
• 🔗 Paste a URL — drop any Surfmarket category or product link.
• 💶 Price filters — min/max EUR.
• 📦 Optional PDP enrich — SKU, brand, description, and gallery images from the product page.
• 🌍 Multi-locale — English, Spanish, Portuguese, French, German, Italian, and more (/en/shop, /pt/loja, /es/tienda, …).

Note on language: Locale changes the site UI and category URLs. Product descriptions are written by Surfmarket/brands and often stay Spanish (or English) even on /pt/ or /en/ — the site does not auto-translate catalog text.

📦 What's inside the data?

For every product you can get:

• Product: name, brand, SKU, short description, full description, category
• Price: price, original price (when on offer), currency (EUR)
• Reviews: rating (0–5) and review count when available
• Availability: in-stock flag and labels (New, Sale, No Stock, …)
• Media & link: image URL(s) and Surfmarket product URL
• Variants: size / measure options shown on the listing (when present)

🚀 Quick start

1. Choose a locale (default English).
2. Pick a category (or set a custom category path / search / start URL).
3. Optionally enable Enrich from product page, set max items, and click Start.

📥 Inputs

Field	Description
start_urls	Optional Surfmarket category or product URLs
locale	Site language / URL space (en→/shop, pt→/loja, es→/tienda, …)
category	Preset shop category
category_path	Custom slug under /shop/ (e.g. surfing/fins/fcs2)
search	Keyword search
price_min / price_max	EUR price filters
include_out_of_stock	Keep sold-out products (default true)
enrich_details	Fetch each PDP for brand / description / rating / SKU / gallery (default true)
max_items	Cap results (1–2000, default 50)

Example (category):

{
  "locale": "en",
  "category": "surfing/surfboards/shortboards",
  "max_items": 50
}

Example (search + enrich):

{
  "locale": "en",
  "search": "oneill",
  "enrich_details": true,
  "max_items": 30
}

Example (URL):

{
  "start_urls": [
    "https://www.surfmarket.org/en/shop/surfing/surfboards/shortboards/results,1-48"
  ],
  "max_items": 40
}

📤 Output example

{
  "product_id": "next-easy-rider",
  "sku": "NEXT004",
  "name": "Next Surfboards Easy Rider",
  "brand": "Next Surfboards",
  "price": 439.95,
  "original_price": null,
  "currency": "EUR",
  "rating": null,
  "review_count": 0,
  "in_stock": true,
  "short_description": "Para olas medianas desde 5'10 hasta 6'8",
  "description": "Easy Rider Next. Diseñada para asegurarte un surf fácil y divertido.",
  "category": "Surfboards — Shortboards",
  "category_slug": "surfing/surfboards/shortboards",
  "image_url": "https://www.surfmarket.org/images/stories/virtuemart/product/next-easy-rider-68.jpg",
  "url": "https://www.surfmarket.org/en/shop/surfing/surfboards/shortboards/next-easy-rider-detail",
  "locale": "en"
}