ParseForge
Soccerway Football Results Scraper
parseforge/soccerway-scraper
Developer toolsAutomationOther
Scrapes Soccerway football match data by date offset, status, and league name. Returns each fixture or result as a flat row with score, kick-off time, and competition.
- Total users
- 11
- Monthly active
- 2
- Total runs
- 84
- Bookmarked
- 0
- Rating
- Not rated yet
- Last modified
- 12 days ago
Overview
Soccerway Football Results Scraper
Scrape Soccerway football results for any date, league, or match status, up to a million per run. Every match comes with its score, kick-off time, and competition name. No login or API key. Export to CSV, JSON, Excel, or XML.
Soccerway publishes football fixtures and results for hundreds of leagues worldwide, but there is no public API to pull them into your own tools. This Actor reads the match listings directly, filters by date offset, match status, and league name, and returns each match in one fixed schema.
| Who uses it | What they scrape Soccerway for |
|---|---|
| Sports data analysts | Build a historical dataset of match results across multiple leagues. |
| Betting model builders | Feed daily finished match scores into a prediction model. |
| Football content creators | Pull live or scheduled fixtures for a match preview blog or social media calendar. |
| League statisticians | Track results for a specific competition over a season. |
What it does
This Actor collects Soccerway football match data by date and returns each fixture or result as a flat row.
- 📅 Date offset control: fetch matches from today, yesterday, tomorrow, or any day within a 7-day window.
- 🏷️ Status filter: keep only scheduled, live, or finished matches, or collect all three.
- 🌍 League and country filter: narrow results to a specific competition or nation by name, such as 'La Liga' or 'England'.
- 📊 Flat row output: every match lands in your dataset as one row, ready for spreadsheets or databases.
Results export to CSV, JSON, Excel, or XML, or straight from the API.
What you can do with Soccerway data
📈 Build a match-results database.
A data analyst runs the Actor daily with status 'finished' and a league filter to populate a historical results table for trend analysis.
⚽ Power a football betting model.
A quant runs the Actor each morning for yesterday's finished matches and feeds the scores into a model that predicts upcoming outcomes.
📰 Automate a match preview feed.
A content creator runs the Actor with status 'scheduled' and a league filter to pull tomorrow's fixtures into a CMS for automated preview articles.
🏆 Monitor a specific competition.
A league statistician runs the Actor weekly with a 'Champions League' filter to collect all finished group-stage and knockout results.
Why choose this scraper
| What you get | |
|---|---|
| No API registration | Read public match feeds without OAuth or rate-limit headaches. |
| Date-range precision | Target a single day's matches with a simple integer offset. |
| League targeting | Isolate one competition or country with a free-text name filter. |
| Scalable collection | Pull up to a million matches per run for large backfills. |
How it compares
No other Store actor targets Soccerway the same way, so the honest comparison is with the alternatives teams actually weigh.
| Soccerway Football Results Scraper | Build it in-house | By hand | |
|---|---|---|---|
| Setup | Run it now, zero config | Days of engineering | None, but hours per pull |
| When Soccerway changes | Maintained for you | You fix it | You re-learn the page |
| Proxies, retries, anti-bot | Built in | Your problem | Browser only |
| Output | Fixed JSON schema, CSV/Excel export | Whatever you build | Copy-paste |
| Cost | Pay per result | Engineering time | Analyst hours |
Configure the run
Drive the Actor with a day offset, a match status, and an optional league or country name filter, and filters run as each match is read so only matches that meet your criteria reach your dataset. The Input tab lists every parameter.
A first run with the defaults:
{
"dayOffset": 0,
"maxItems": 10
}
A larger pull:
{
"dayOffset": 0,
"maxItems": 200
}
Pricing
Pay-per-result: $0.0055 per result collected. You pay only for the results written to your dataset.
| Results collected | Approximate cost |
|---|---|
| 100 results | $0.55 |
| 1,000 results | $5.50 |
| 10,000 results | $55.00 |
New Apify accounts start with $5 in free credit.
Free users
Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.
Run it
- Create a free Apify account with $5 in credit.
- Open the Soccerway Football Results Scraper.
- Set your inputs and any filters, then click Start.
- Export the results as CSV, Excel, JSON, or XML from the Dataset tab.
Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.
Use with AI agents (MCP)
Give an AI agent live access to Soccerway through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:
claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/soccerway-scraper"
Then prompt it in plain language to run the scraper and read back the results.
Troubleshooting
Why am I getting no results?
Check that your dayOffset points to a date with matches and that your league filter text matches an actual competition or country name. Also confirm that your status filter is not excluding all available matches.
The Actor returns fewer matches than I expected.
Your league filter may be too narrow, or the status filter may be hiding scheduled or live matches. Try setting status to 'all' and clearing the league filter to see the full day's slate.
Can I scrape historical matches from last season?
The dayOffset field accepts values from -7 to 7, so you can reach up to a week into the past. For older matches, you would need to modify the Actor's code to target specific Soccerway date URLs.
The league filter is not catching my league.
The filter is a simple text match. Try a shorter substring that appears in the league or country name on Soccerway. For example, 'premier' instead of 'Premier League'.
FAQ
| Question | Answer |
|---|---|
| Can I scrape more than one day at a time? | Each run targets a single day offset. To collect a range of dates, schedule multiple runs with different dayOffset values, or loop through offsets in an integration. |
| What does the league filter match against? | The filter checks whether the competition name or the country name contains your text. For example, 'england' matches Premier League matches, and 'la liga' matches Spanish top-flight fixtures. |
| Does this Actor handle live scores? | Yes. Set the status filter to 'live' to collect matches that are currently in progress, and the Actor will return the score at the moment of scraping. |
| Can I get team line-ups or player statistics? | This Actor returns match-level data such as scores, kick-off times, and competition names. It does not drill into individual player stats or starting elevens. |
| How do I export the data? | Apify stores your results in a dataset. From there you can export to CSV, JSON, Excel, or XML, or push the data to an external service via an integration. |
| Is there a risk of being blocked? | The Actor reads public match listing pages. Apify's platform handles proxies and retries automatically, so you get reliable collection without manual intervention. |
| What happens if I set maxItems higher than the available matches? | The Actor collects every match that meets your filters for that day and stops. It will not return empty rows or duplicate entries. |
| Can I filter by a specific team? | The league filter works on competition and country names, not individual team names. To isolate a team, you can post-filter the dataset after the run. |
| Does this cover international tournaments? | Yes. Soccerway lists fixtures for international competitions like the World Cup and continental championships. Use the league filter with the tournament name to target them. |
| How do I schedule daily runs? | After publishing the Actor, use Apify's scheduler to set a cron expression that runs it every day with your chosen dayOffset and filters. |
Related actors
Browse the full ParseForge collection for more scrapers.
🆘 Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.
⚠️ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Soccerway Ltd. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.
Input
| Field | Type | What it does | Default |
|---|---|---|---|
| dayOffset | integer | Which day's matches to fetch relative to today. 0 = today, -1 = yesterday, 1 = tomorrow, and so on. | 0 |
| status | string (4 options) | Keep only matches with this status. | all |
| leagueFilter | string | Optional. Keep only matches whose country or league name contains this text (for example england, la liga, champions). | not set |
| maxItems | integer | How many matches to collect per run. | 10 |
Pricing
from $4.98 per 1,000 results
| Charged for | What it is | Price each |
|---|---|---|
| result | Single result in the default dataset. | $0.00498 to $0.0055 |
Tiered: the lower figure is the price on a higher Apify plan. Billing and the free credit live on Apify.
API
One POST returns the dataset directly. Same shape for every scraper in the library, so swapping the slug is the only change.
curl -X POST "https://api.apify.com/v2/acts/parseforge~soccerway-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"helloWorld": 123
}' Examples
Input that runs as-is.
{
"helloWorld": 123
} Reviews
No reviews yet. Be the first.
Issues
We build and maintain this scraper, so a problem with it comes to us. Report it on the Apify listing and the thread stays attached to the scraper where the next person can find it: open an issue.
Broken and urgent, or you would rather not post in public? Write to parseforge@protonmail.com and it reaches the people who wrote it.
Related scrapers
Run Soccerway Football Results Scraper on Apify All scrapers