SoccerPunter Football Fixtures, Results, Odds & H2H Scraper

Scrape football match fixtures, kickoff times, results, and (optionally) 1X2 odds, recent team form, and a head-to-head summary 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)
• Result — finalScore (once the match has kicked off; null before)
• Odds & form (optional, includeOddsForm: true, today/tomorrow only) — oddsHome, oddsDraw, oddsAway (1X2), homeForm, awayForm (last-5 W/D/L)
• Head-to-head (optional, includeH2h: true, max 5 items) — h2hSummary, a short head-to-head record between the two teams
• Match day context — matchDay (today, tomorrow, yesterday)
• 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
includeOddsForm	boolean	false	Fetch 1X2 odds and recent form per match (today/tomorrow only, slower)
includeH2h	boolean	false	Fetch a head-to-head summary per match (much slower, max 5 items)

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 the pages this actor scrapes.

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.
• h2hUrl links out to SoccerPunter's own head-to-head page for the match, for you to open directly.
• includeOddsForm only has data to fetch for today/tomorrow — SoccerPunter has no odds/form page for matches that already finished, so it's rejected for matchDay: yesterday. Some individual matches may still have no odds/form available even on today/tomorrow (not every fixture is covered) — those come back null.
• includeH2h is capped at maxItems: 5 and cannot be combined with includeOddsForm in the same run — head-to-head summaries take noticeably longer per match than the rest of the record, and the run is rejected up front above the cap (or on the unsupported combination) rather than left to run long or silently drop a field.

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",
  "finalScore": null,
  "h2hUrl": "https://www.soccerpunter.com/h2h/Sri-Lanka-vs-Bhutan/18808/18906/",
  "h2hSummary": null,
  "oddsHome": null,
  "oddsDraw": null,
  "oddsAway": null,
  "homeForm": null,
  "awayForm": null,
  "matchDay": "today",
  "url": "https://www.soccerpunter.com/soccer-statistics/matches_today",
  "scrapedAt": "2026-06-08T06:32:04.723Z"
}

With includeOddsForm: true on a today/tomorrow match that has odds coverage, oddsHome/oddsDraw/oddsAway are decimal odds (e.g. "1.363") and homeForm/awayForm are W/D/L strings (e.g. "WWDLW"). With includeH2h: true, h2hSummary is a short head-to-head record between the two teams (e.g. "Team A won two times in their past 8 meetings with Team B.").

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.