OneFootball Scraper: News, Fixtures, Results & League Tables

OneFootball Scraper turns OneFootball into a clean, structured feed of football content. Get news articles, upcoming fixtures, played results with final scores, and league tables for the competitions and teams you choose, or paste your own OneFootball links to read exactly the pages you want. Search by competition and team, or bring your own links, then export to JSON, CSV or Excel, or pull the results straight into your app through the API.

Why This Scraper?

• Two ways to collect. Search mode walks the competitions, teams and global feed you list; links mode reads exactly the OneFootball pages you paste: competition, team, match or article pages, or the home feed.
• Three record kinds in one dataset. News articles, match fixtures and results, and league table rows, each labelled by recordType, so one run can feed a news page and a scores widget together.
• Full article text on demand. Turn on Read full article text to fetch each article's own page and add the complete body. A failed read keeps the feed data and is never billed.
• Whole seasons, not just a matchday. A competition's fixtures list follows the site's own continuation link to bring in the rest of the season in the same run.
• Built for schedules. Recurring updates returns only new and changed records on repeat runs, labelled NEW, UPDATED, REAPPEARED, UNCHANGED or EXPIRED. Scores, table numbers and article text are all watched for changes.
• Resume without repaying. Continue an interrupted run by pasting its run id, and records it already collected are skipped.
• Honest failures. A run where every page was refused fails loudly instead of returning a quiet empty dataset, and a genuinely empty search says so on the run page instead of guessing.

Use Cases

• Sports media and newsletters: turn a competition's news feed and results into automated match reports and roundups.
• Live scores and fixtures widgets: feed a site or app with a team's or competition's upcoming matches and results.
• Betting and fantasy research: track fixtures, results and league table movement across the competitions a model follows.
• Season datasets: run on a schedule to build your own archive of results and standings as a season unfolds.

Data You Get

Sample shape: values are illustrative placeholders, not from a live record.

Field	Example
recordType	"news" (also "match", "table")
id	"34521987"
title	"Sample club confirms new signing ahead of the weekend"
publisher / publisherIsVerified	"Sample Publisher" / true
publishedAt	"2026-09-20T10:15:00Z"
preview	"The club's manager praised the squad depth after completing the deal."
imageUrl	"https://onefootball.com/img/sample-news.jpg"
isVideo	false
articleText / articleChars	full body text / 2450 (only with Read full article text on)
homeTeam / awayTeam	"Home Team" / "Away Team" (match)
homeScore / awayScore	2 / 1 (match, once played)
kickoff	"2026-09-21T15:00:00Z" (match)
status / statusLabel	"FULL_TIME" / "Full time" (match)
competitionName	"Sample League" (match, table)
teamName	"Sample FC" (table)
position / positionChange	4 / "UP" (table; see the note below)
played / won / drawn / lost	10 / 6 / 2 / 2 (table)
goalDifference / points	5 / 20 (table)
url	"https://onefootball.com/en/news/sample-club-confirms-new-signing-34521987"
sourceType / sourceId	"competition" / "premier-league-9"
changeType / changedFields	"UPDATED" / ["homeScore", "status"] (recurring updates only)
firstSeenAt / lastSeenAt	"2026-09-14T10:00:00Z" / "2026-09-20T10:15:00Z" (recurring updates only)

Note on position: on every row it is the order in which the actor read the rows on that page (feed order for news and matches). For a normal single league table that equals the rank. It is not the official rank when a page holds several tables (for example World Cup or other group-stage tables, where the count runs on across groups and rows carry no group name) or when the site's ranking skips a number; in those cases do not rely on position as the rank. A team listed in more than one table on the same page appears once. Recurring updates does not compare position, so a rank change on its own is not reported as UPDATED.

A pasted match link (links mode) can additionally carry events (goals, cards and substitutions), lineups, match statistics and a short form guide, when the site's own match page carries them.

How to Use

1. Pick a mode: search (competitions, teams and the global feed) or your own OneFootball links.
2. For search mode, list competition slugs and, optionally, team slugs or turn on the global news feed, then switch the four content toggles (News, Fixtures, Results, League table) on or off.
3. Set Max records (and, if you need a tighter runaway guard, Max pages per source) to control run size and cost, then click Start.
4. Download the dataset as JSON, CSV or Excel, or read it through the API.

Competitions by slug:

{
  "mode": "search",
  "competitions": ["premier-league-9", "bundesliga-1"],
  "includeNews": true,
  "includeFixtures": true,
  "includeResults": true,
  "includeTable": true,
  "maxPages": 1,
  "maxItems": 1000
}

One team's news and matches:

{
  "mode": "search",
  "teams": ["arsenal-2"],
  "includeNews": true,
  "includeFixtures": true,
  "includeResults": true,
  "includeTable": false,
  "maxItems": 50
}

Global news feed, with full article text:

{
  "mode": "search",
  "includeGlobalNews": true,
  "includeNews": true,
  "includeFixtures": false,
  "includeResults": false,
  "includeTable": false,
  "fetchDetails": true,
  "maxItems": 20
}

Paste your own links:

{
  "mode": "url",
  "urls": [
    "https://onefootball.com/en/competition/premier-league-9/table",
    "https://onefootball.com/en/match/9000001"
  ]
}

Copied slugs matter: the number at the end is the site's own id (bundesliga-1 is the German Bundesliga, bundesliga-35 is Liga Portugal). Copy slugs and links from the site rather than typing them from memory.

Run it from your code

Python:

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("abotapi/onefootball-com-scraper").call(run_input={
    "mode": "search",
    "competitions": ["premier-league-9"],
    "maxItems": 50,
})
for record in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(record["recordType"], record.get("title") or record.get("homeTeam"))

JavaScript:

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('abotapi/onefootball-com-scraper').call({
  mode: 'search',
  competitions: ['premier-league-9'],
  maxItems: 50,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();

Or connect it to Make, Zapier, n8n, Google Sheets or webhooks from the Integrations tab.

How Max records is spent

Max records (maxItems) is the single cap for the whole run, counting news, matches and table rows together; 0 removes it and the walk ends only when its sources run out. With several competitions or teams listed, the cap is split across the sources still ahead so an early one cannot spend it all. Inside each competition the order is news, then fixtures (the whole remaining season, often a few hundred matches), then results, then the table, and news feeds go deep, so a small cap can be used up before the later kinds are reached (the default of 20 records on one competition returns 20 news articles). Max pages per source (maxPages) bounds how many pages any single news feed reads, about 10 articles per page: set it to 1 or 2 and raise Max records when you want every record kind from each competition, or turn off the kinds you do not need (for example News and Fixtures for results and tables only). 0 reads as deep as the feed goes, up to an internal safety ceiling.

Resume and recurring updates

• Continue a previous run (resumeFromRunId) finishes ONE interrupted run: paste its run or dataset id and the actor skips every record that run already collected, so you do not pay twice.
• Recurring updates (incrementalMode) is for running the same setup again and again, for example daily. Each record is classified NEW, UPDATED (with changedFields), UNCHANGED (suppressed and not billed unless emitUnchanged is on), REAPPEARED or EXPIRED (only after a run that read its whole setup end to end, and only with emitExpired on). EXPIRED means the record scrolled out of every source this setup reads, not that it was deleted from the site: results pages, team pages and the global feed show only their latest items, so an older result or article dropping off them is reported as EXPIRED. A capped, resumed or partially failed run never reports records as gone. stateKey names or shares the stored baseline. With Recurring updates off, output is exactly as before.

Send results into your apps (MCP connectors)

Optionally pipe the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. This is an extra delivery step after the scrape: the Apify dataset is never changed.

What gets written to the connector: a condensed, human readable summary of each record, not the full JSON. Each item becomes one entry with a title and its key fields flattened to plain text. The complete record always stays in the Apify dataset.

1. Authorize a connector once under Apify > Settings > Integrations (Notion, Linear, Airtable, or Apify).
2. Select it in the "Pipe results into your apps" input field. (If the picker is empty, you haven't authorized a connector yet.)
3. For Notion, also set notionParentPageUrl to the page where items should be created.

Only news records are sent to connectors; match and table rows stay in the dataset. The connection is mediated by Apify's MCP proxy, so this actor never sees your third party credentials. Leave the field empty to skip.

Input Parameters

Parameter	Type	Default	Description
mode	string	search	search (competitions, teams and news feeds) or url (your own links).
competitions	array	sample	Competition slugs or links to walk (search mode; prefilled with premier-league-9).
teams	array	(none)	Team slugs or links to walk (search mode, optional).
includeGlobalNews	boolean	false	Also read the site wide front page news feed (search mode).
urls	array	sample	OneFootball links to read exactly as pasted (url mode).
language	string	en	Content language. English is the only reliably complete edition.
includeNews	boolean	true	Collect news articles from competitions, teams and the global feed.
includeFixtures	boolean	true	Collect upcoming matches from competitions and teams.
includeResults	boolean	true	Collect played matches with final scores.
includeTable	boolean	true	Collect league table rows from competitions that have one.
fetchDetails	boolean	false	Read each article's own page and add the full article text.
maxItems	integer	20	Stop after this many records across the whole run (0 = no limit).
maxPages	integer	0	Max pages read per news feed, about 10 articles each (0 = as deep as the feed goes, up to an internal safety ceiling).
resumeFromRunId	string	(none)	Continue one interrupted run of this actor.
incrementalMode	boolean	false	Return only new and changed records on recurring runs.
stateKey	string	(none)	Name or share a recurring updates baseline.
emitUnchanged	boolean	false	Also return (and bill) unchanged records.
emitExpired	boolean	false	Also return (and bill) records that are gone.
mcpConnectors	array	(none)	Optional: send a summary of each news record to apps you authorized under Integrations.
notionParentPageUrl	string	(none)	Notion connector only: page under which item pages are created.
maxNotifyListings	integer	50	Cap on items written to each connector per run.
proxyConfiguration	object	Apify Proxy	Connection used for every request.

Output Example

Sample shape: values are illustrative placeholders, not from a live record.

{
  "recordType": "news",
  "id": "34521987",
  "title": "Sample club confirms new signing ahead of the weekend",
  "url": "https://onefootball.com/en/news/sample-club-confirms-new-signing-34521987",
  "publisher": "Sample Publisher",
  "publisherIsVerified": true,
  "publishedAt": "2026-09-20T10:15:00Z",
  "preview": "The club's manager praised the squad depth after completing the deal.",
  "imageUrl": "https://onefootball.com/img/sample-news.jpg",
  "isVideo": false,
  "language": "en",
  "articleText": "Sample paragraph one of the article body, for illustration only.\n\nSample paragraph two continuing the illustrative body text.",
  "articleChars": 130,
  "sourceType": "competition",
  "sourceId": "premier-league-9",
  "sourceUrl": "https://onefootball.com/en/competition/premier-league-9",
  "position": 3,
  "scrapedAt": "2026-09-20T10:20:00Z"
}

Plan Requirement

The default connection setting works out of the box: the site's content API answers on the standard connection pool. Other pools are not needed; switch under Connection only if your use case calls for it, for example to paste your own connection links for a specific exit country.

FAQ

How much does it cost?

You pay per record returned, plus a separate surcharge for every article whose full text you read (with Read full article text on). The Pricing tab shows the current rates. Use Max records to cap the cost of any run.

Is it legal to scrape OneFootball?

This actor collects only publicly available football content. You are responsible for how you use it: follow OneFootball's terms and the laws that apply to you, and get legal advice before any commercial redistribution. Scores and fixtures are generally facts, but article text, logos and photos may carry their own publisher or image rights.

Can I get only new or changed records on a schedule?

Yes. Schedule the actor from the Schedules tab and turn on Recurring updates. Each run then returns only NEW, UPDATED and REAPPEARED records, and unchanged ones are skipped and not billed unless you turn that on too.

What is the difference between "Continue a previous run" and "Recurring updates"?

They solve different problems. Continue a previous run (resumeFromRunId) finishes ONE run that was interrupted, skipping records it already collected. Recurring updates (incrementalMode) is for running the same setup again and again on a schedule, comparing against last time. Turning both on for the same setup fails the run with a message asking you to pick one.

Why did a competition return nothing, or the wrong league?

Slugs carry the site's own id, and it is not guessable: bundesliga-1 is the German Bundesliga, bundesliga-35 is Liga Portugal. Copy the slug, or the whole link, from the competition's own page on OneFootball rather than typing one from memory. A slug that does not exist fails that one source loud, with the rest of the run unaffected.

Why did my run fail instead of returning an empty dataset?

If every page the run tried was refused, the run stops with a clear message so a genuinely quiet news day is never confused with a connection problem. Run it again in a few minutes. If only some competitions, teams or links could be read, you still get what was found, with a note on the run page.

Can I use it with AI agents or MCP?

Yes. Call it from any Apify integration or MCP client, and use the connector field to push results into Notion, Linear or Airtable.

🔗 Want more sports data?

Pair this actor with these related scrapers from the same team:

⚽ Globo Esporte Scraper Scrape public sports content from ge.globo.com, including news, videos, matches and feed...	⚽ SofaScore Scraper ⚽ Live Scores, Stats, Players & Odds From $1/1K. Pull structured sports data from SofaScore across football, basketball...
⚽ Sportsbook Odds Scraper (1xBet, Melbet, Linebet, Paripulse) Collect live and prematch betting odds from 1xBet, Melbet, Linebet and Paripulse. Give it...	⚽ BookMyShow Scraper Scrape BookMyShow movies and live events by city, category or URL. Extract genres...
⚽ Whatnot Scraper Scrape Whatnot live and upcoming shows, queued items and lots, and seller profiles...	🧩 Duolingo Scraper Scrape public Duolingo data without login. Extract learner profiles with streaks, XP and...

👉 Browse all abotapi scrapers

💬 Support & custom scrapers

• 🐞 Found a bug or a missing field? Open a ticket on the Issues tab. We usually reply within hours.
• 🛠️ Need another site, extra fields or a private build? Email abotapi@proton.me or message Telegram @abotapi.
• ⭐ Enjoying it? A quick review on the actor page helps other users find it.