This tutorial shows how to scrape Sportium football odds into CSV with the Sportium Scraper template for UScraper. You will import the workflow, confirm the source route, set the export path, run a visible validation pass, and troubleshoot common issues on dynamic sportsbook pages.
Before you run
Prerequisites for a Sportium odds scraper
You need UScraper installed as a local desktop app, the free Sportium Scraper template, a writable export folder, and access to the Sportium page you are allowed to inspect. The bundled workflow starts from the Sportium football route configured in the JSON export: https://www.sportium.es/apuestas-deportivas/futbol.
Before automation, open Sportium manually and review the relevant pages for your session, including the Sportium sports betting page, the Sportium in-play page, the Sportium betting FAQ, and the Sportium sports betting rules. Public visibility does not automatically grant permission to automate collection, republish odds, or use the data commercially.
Treat the first run as a QA run, not a production feed. Keep the browser visible, record the run time, and stop if the page shows an access challenge instead of normal event rows.
Workflow anatomy
How the Sportium scraper tutorial workflow works
The JSON export is the source of truth for this tutorial. In plain English, the graph follows this path:
Set Window Size -> Navigate -> Wait for Page Load -> Cookie Check
-> Optional Click -> Wait for Element -> Scroll -> Sleep
-> Structured Export -> End
The scraper does not rely on classic numbered pagination. The workflow waits for a page shell, checks for a consent button, scrolls for several seconds to trigger lazy-loaded events, returns to the top, pauses, and then exports each matching event card. That matters because sportsbook pages often hydrate content after the first page load and may show different market groups by sport, league, region, or session.
| Workflow block | What it controls | Validation cue |
|---|---|---|
| Navigate | Opens the Sportium football route | The page should show football events, not only a blocked shell |
| Cookie check | Detects and clicks a common accept or allow button | The page should continue whether the banner exists or not |
| Scroll step | Triggers lazy-loaded event cards | More matches should appear before export |
| Structured Export | Creates sportium-scraper.csv with configured columns | Headers and rows should land in your selected folder |
Runbook
How to scrape Sportium football odds to CSV
Import the template
Open Sportium Scraper from the template library, download the JSON, and import it into UScraper.
Confirm the source page
Open the Navigate block and confirm the Sportium football URL. If your session redirects, shows a language variant, or blocks the page, resolve that manually before running automation.
Set the export folder
In Structured Export, choose a project folder, keep headers enabled, and confirm the filename sportium-scraper.csv.
Run one visible pass
Watch page load, consent handling, the scroll step, and export. Stop if a CAPTCHA, login wall, age check, or geo-block appears.
Validate before repeating
Open the CSV and compare several rows against the page: teams, league, match time, 1X2 prices, totals, and duplicate fixtures.
The stock export mode creates a fresh sportium-scraper.csv. If you need repeated snapshots, use date-stamped folders or filenames so later exports do not overwrite a known-good baseline.
Output
CSV fields exported by the Sportium odds scraper
There is no separate CSV sample in the bundle, so use the workflow definition and export shape as the contract. The scraper writes one visible event card per row when the page exposes matching content.
sportium-scraper.csvColumn
pais
Country or region label inferred from nearby headings.
Column
liga
Competition or league label near the event group.
Column
fecha_hora
Visible match time such as Hoy, Manana, or a date and time string.
Column
local_1
Home or first listed participant.
Column
visitante_2
Away or second listed participant.
Column
resultado_1
First visible 1X2 price for the event.
Column
resultado_x
Draw price where a 1X2 market is present.
Column
resultado_2
Second team or away price in the 1X2 market.
Column
goles_mas
Visible goals total threshold.
Column
goles_menos
Goals-under or related market value when visible.
Column
ambos_marcan_yes
Both-teams-to-score yes price when shown.
Column
ambos_marcan_no
Both-teams-to-score no price when shown.
Column
handicap
Visible handicap value or half-goal line.
Column
ganador
Winner market value when present.
Column
totales
Additional totals market threshold when visible.
Column
carreras
Runs or carreras field for markets that expose it.
{
"navigate": "https://www.sportium.es/apuestas-deportivas/futbol",
"fileName": "sportium-scraper.csv",
"fileMode": "create",
"loading": "cookie check plus scroll-based lazy loading",
"columns": [
"pais",
"liga",
"fecha_hora",
"local_1",
"visitante_2",
"resultado_1",
"resultado_x",
"resultado_2",
"goles_mas",
"goles_menos",
"ambos_marcan_yes",
"ambos_marcan_no",
"handicap",
"ganador",
"totales",
"carreras"
]
}
Alternatives
Sportium scraper alternative: scraper, API, or managed tool?
The best sports odds scraper is the one that matches your governance requirements. A no-code Sportium scraper is useful when an analyst needs a transparent CSV snapshot and wants to inspect the browser behavior during collection. It is not the same as a licensed odds feed.
| Option | Good fit | Trade-off |
|---|---|---|
| UScraper Sportium template | No-code CSV export from a local desktop app for supervised research | Best for controlled snapshots, not guaranteed live feeds |
| Sports odds API | Developer teams that need stable schemas, quotas, and supported bookmaker coverage | Requires keys, billing, integration work, and accepted coverage |
| Managed scraper service | Teams that want hosted infrastructure and less workflow maintenance | Source pages and extracted odds pass through a third party |
| Custom Playwright or Scrapy crawler | Engineers who need full control over sessions and parsing | Higher maintenance when Sportium markup or markets change |
Use the UScraper template when you need a repeatable research export, quick spreadsheet review, or a baseline before deciding whether an API contract is justified. Use an odds API or approved data provider when the business needs guaranteed coverage, historical backfill, redistribution rights, or service-level commitments.
For adjacent workflows, browse the UScraper templates library or read more tutorials on the UScraper blog.
Frequently asked questions
Sportium odds may be visible in a browser, but automated collection can still be restricted by Sportium terms, robots directives, age checks, geo-blocking, account rules, gambling regulation, database rights, and local law. Review the current rules, avoid bypassing access controls, keep runs modest, and get legal review before commercial reuse.