OneFootball Scraper

Collect football news, fixtures, results and league tables from OneFootball, the football app covering 750+ competitions worldwide. This actor reads the same structured content the website itself uses, so runs are fast, cheap and reliable: no browsers, no queues of image downloads, just compact JSON.

What you get

Three record kinds, every row labelled with its recordType:

• news - headline, publisher, publish timestamp, preview, image and (with Read full article text) the complete article text.
• match - fixtures and results with home and away teams, scores where the match has been played, kickoff time and match status.
• table - league-table rows: position, movement, played, won, drawn, lost, goal difference and points.

Modes

• Competitions, teams & news feed (search mode): list competition slugs (premier-league-9, bundesliga-1, laliga-10, serie-a-13, ligue-1-23...), optional team slugs (arsenal-2), and optionally the global front-page news feed. Every competition yields its news, its fixtures, its results and, for leagues, its table. Pick exactly the record kinds you want with the four toggles.
• My own links (links mode): paste any OneFootball page - a competition page (with /fixtures, /results or /table for just that tab), a team page, a match page, a news article, or the home feed. Each link is read exactly as pasted.

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 links from the site rather than inventing them.

Content language

English is the one reliably complete edition and is the default. The site serves other languages only partially (most non-English competition and team routes answer with no content), so no other language is offered as a selector. Article links you paste are read in their own language when the site serves them.

Recurring updates and resuming

• Continue a previous run: paste an earlier run id to finish an interrupted collection without paying for the same rows twice.
• Recurring updates: for scheduled runs, returns only what changed - every row carries a changeType column (NEW, UPDATED, REAPPEARED, EXPIRED). Scores, table numbers and article text are watched, so a finished match or a moved table row arrives as UPDATED.

Limits and billing

• maxItems (default 20) is the single cap that stops a run; 0 removes it.
• maxPages (default 0) is a runaway guard per news feed; leave it at 0.
• Read full article text bills one detail-enrichment event per enriched article, on top of the per-record price. Articles that fail to read keep their feed data and are never billed.

Send results into your apps (MCP connectors)

Results can be piped into the apps you already use through Model Context Protocol (MCP) connectors. Authorize a connector under Apify, Settings, API & Integrations, then set:

• mcpConnectors - one or more connector names to export to.
• notionParentPageUrl - the Notion page under which item pages are created (Notion connector only).
• maxNotifyListings - how many items to write per connector (default 50).

The export happens after the scrape and never changes the dataset.

Connection

The site's content API answers on the standard connection pool, so the default works on every plan. You can paste your own connection links if your use case needs a specific exit country.

Output

The dataset carries one unified table (all record kinds), plus focused views: News, Matches and League table. Every row includes changeType, changedFields, firstSeenAt and lastSeenAt columns for recurring runs.