SoccerPunter Football Match Prediction Scraper

Scrape football match fixtures, H2H statistics, team form, kickoff times, and odds from SoccerPunter.com. Supports today's matches, tomorrow's fixtures, and yesterday's results across 800+ global soccer leagues.

What you get

Each record includes:

• Match identification — matchId, league, homeTeam, awayTeam, h2hUrl
• Timing — kickoffDatetime (ISO 8601), kickoffTime (human-readable UTC)
• Match day context — matchDay (today, tomorrow, yesterday)
• Optional H2H detail — h2hSummary and predictionText (when includeH2h: true)
• Form — homeForm, awayForm (W/D/L strings, when marked up by the site)
• Prediction fields — tip, confidence, predictionText, predictedScore (reserved; populated when site exposes public data)
• Results — finalScore (for completed matches on the yesterday day mode)
• Provenance — url, scrapedAt

Input options

Field	Type	Default	Description
matchDay	string	today	Which day to scrape: today, tomorrow, or yesterday
maxItems	integer	50	Maximum number of matches to return
includeH2h	boolean	false	If true, fetch the H2H statistics page for each match (richer data, more requests)

How it works

The actor fetches a single SoccerPunter statistics listing page per run (e.g. /soccer-statistics/matches_today). Match rows use alternating .each_fromrow divs — league group headers (style_bar) and match rows (style_bar1). Team names come from bare <span> elements; kickoff times are extracted from embedded Unix epoch timestamps in <script> tags and converted to ISO 8601.

No authentication is required for basic match data. The site is server-rendered (PHP/SSR) with no Cloudflare or IP-based blocking.

Usage notes

• A single run typically returns 50–120 matches depending on the day and league density.
• Setting maxItems to a small value (5–10) is useful for quick tests.
• The includeH2h option queues an additional HTTP request per match — useful for H2H summary history but slower and not needed for basic fixture/odds data.
• Premium prediction fields (tip, confidence, predictionText) are null for public (non-VIP) page content. These fields are reserved for future enhancement when public prediction data becomes available.

Sample output

{
  "matchId": "Sri-Lanka-vs-Bhutan_18808",
  "league": "World - Friendly International",
  "homeTeam": "Sri Lanka",
  "awayTeam": "Bhutan",
  "kickoffDatetime": "2026-06-08T11:30:00.000Z",
  "kickoffTime": "2026-06-08 11:30:00 UTC",
  "predictionText": null,
  "predictedScore": null,
  "h2hSummary": null,
  "homeForm": null,
  "awayForm": null,
  "tip": null,
  "confidence": null,
  "finalScore": null,
  "h2hUrl": "https://www.soccerpunter.com/h2h/Sri-Lanka-vs-Bhutan/18808/18906/",
  "oddsHome": null,
  "oddsDraw": null,
  "oddsAway": null,
  "matchDay": "today",
  "url": "https://www.soccerpunter.com/soccer-statistics/matches_today",
  "scrapedAt": "2026-06-08T06:32:04.723Z"
}

Legal

This actor scrapes publicly accessible data from SoccerPunter.com. Users are responsible for complying with SoccerPunter's terms of service and applicable data protection regulations. Do not use this actor to bypass authentication or access premium content.