World Cup Results & Tables

What does World Cup Results & Tables do?

World Cup Results & Tables returns structured FIFA World Cup fixtures, results, scores, venues, groups, and calculated group tables for supported tournaments.

The actor is built for lightweight World Cup dashboards, spreadsheets, reporting feeds, scheduled tournament monitoring, and API workflows that need clean rows instead of manually checking football pages during the tournament.

The default tournament is World Cup 2026, hosted by Canada, Mexico, and the United States. Historical JSON-backed tournaments are also available for comparison and testing.

Why use World Cup Results & Tables?

Use this actor when you need World Cup match data in a consistent Apify dataset. It normalizes match rows and keeps group tables in a separate output table so downstream workflows can distinguish fixtures/results from standings.

Main capabilities:

• Retrieve World Cup fixtures, dates, teams, venues, scores, stage, group, and winners.
• Filter by tournament year, stage, group, and team.
• Calculate group standings from completed group-stage results.
• Schedule repeat runs during the tournament and export data through the Apify API.
• Append rows into an existing Apify dataset with datasetId.
• Add your own workflow identifier with runId.

What data can it extract?

Match rows

Field	Type	Description
tournamentName	string	World Cup tournament name
year	number	Tournament year
stage	string	group or knockout
round	string	Matchday or knockout-round label
group, groupName	string	Group label when available
matchDate	string	ISO 8601 date/time when safely normalized
localDate, localTime	string	Source-provided local date and time
venue	string	Stadium and city when available
homeTeam, awayTeam	string	Teams for the match row
homeScore, awayScore	number	Full-time score when available
halfTimeHomeScore, halfTimeAwayScore	number	Half-time score when available
extraTimeHomeScore, extraTimeAwayScore	number	Extra-time score when available
penaltyHomeScore, penaltyAwayScore	number	Penalty shootout score when available
status	string	scheduled or finished
winner	string	home, away, draw, or empty
sourceName	string	Source dataset name
runId	string	Optional workflow identifier

Group table rows

Field	Type	Description
tournamentName	string	World Cup tournament name
year	number	Tournament year
group, groupName	string	World Cup group
position	number	Calculated group position
teamName	string	Team name
played, won, drawn, lost	number	Group-stage record
goalsFor, goalsAgainst	number	Group-stage goals
goalDifference	number	Goals for minus goals against
points	number	Calculated points
sourceName	string	Source dataset name

Supported tournaments

This version supports JSON-backed tournaments:

• World Cup 2018
• World Cup 2022
• World Cup 2026

The actor does not claim full historical World Cup coverage in this launch version. Additional years can be added after their source files and output semantics are validated.

Use cases

• Build World Cup 2026 dashboards and score trackers.
• Feed editorial tools with structured fixtures and results.
• Keep spreadsheets of World Cup matches and group tables.
• Schedule daily tournament updates through Apify.
• Monitor specific teams during the group stage and knockout rounds.
• Compare recent World Cups using the same output schema.

How to use it

1. Open the actor input tab.
2. Choose the World Cup year.
3. Pick a stage: all stages, group stage, or knockout stage.
4. Optionally select a group or enter a team filter.
5. Keep Include Matches enabled for fixtures and scores.
6. Keep Include Group Tables enabled when you want calculated standings.
7. Run the actor and download the Matches and Group Tables outputs as JSON, CSV, Excel, XML, or HTML.

Input

See the input tab for full configuration options.

Example input:

{
  "year": 2026,
  "stage": "all",
  "group": "all",
  "includeMatches": true,
  "includeGroupTables": true,
  "maxMatches": 104
}

Example team-specific input:

{
  "year": 2026,
  "stage": "all",
  "team": "Portugal",
  "includeMatches": true,
  "includeGroupTables": true,
  "maxMatches": 20
}

Output

The actor creates two output tables:

• Matches: fixtures and results from the selected tournament scope.
• Group Tables: calculated group standings from completed group-stage matches.

Example output:

[
  {
    "tournamentName": "World Cup 2022",
    "year": 2022,
    "stage": "group",
    "round": "Matchday 1",
    "group": "Group A",
    "groupName": "Group A",
    "matchDate": "2022-11-20T00:00:00.000Z",
    "localDate": "2022-11-20",
    "localTime": "19:00 UTC+3",
    "venue": "Al Bayt Stadium, Al Khor",
    "homeTeam": "Qatar",
    "awayTeam": "Ecuador",
    "homeScore": 0,
    "awayScore": 2,
    "halfTimeHomeScore": 0,
    "halfTimeAwayScore": 2,
    "extraTimeHomeScore": null,
    "extraTimeAwayScore": null,
    "penaltyHomeScore": null,
    "penaltyAwayScore": null,
    "status": "finished",
    "winner": "away",
    "sourceName": "openfootball/worldcup.json"
  },
  {
    "tournamentName": "World Cup 2022",
    "year": 2022,
    "stage": "group",
    "group": "Group A",
    "groupName": "Group A",
    "position": 1,
    "teamName": "Netherlands",
    "played": 3,
    "won": 2,
    "drawn": 1,
    "lost": 0,
    "goalsFor": 5,
    "goalsAgainst": 1,
    "goalDifference": 4,
    "points": 7,
    "sourceName": "openfootball/worldcup.json"
  }
]

API usage example

curl "https://api.apify.com/v2/acts/trovevault~world-cup-results-tables/runs?waitForFinish=120" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "year": 2026,
    "stage": "all",
    "group": "all",
    "includeMatches": true,
    "includeGroupTables": true,
    "maxMatches": 104
  }'

Data semantics

Group tables are calculated only from completed matches that have a group value and a full-time score. Knockout matches never affect group tables.

For scheduled tournament monitoring, a match can remain scheduled until the public source adds a full-time score. The actor does not infer live scores from unofficial feeds.

When appending both output types to an external datasetId, the actor adds entityType as match or groupTable so downstream systems can split the rows.

Limitations

This actor uses the public openfootball/worldcup.json dataset. It is a lightweight no-key data source and is not an official FIFA live data feed.

World Cup 2026 fixtures, group labels, venues, and results depend on the upstream dataset being updated. During the tournament, recent results can lag until the source repository changes.

This version does not include player-level stats, scorers, cards, substitutions, odds, squads, rankings, or live minute-by-minute data. Historical coverage is limited to the supported JSON-backed years listed above.

FAQ

Does this actor cover World Cup 2026?

Yes. World Cup 2026 is the default input and the primary launch use case.

Does it include every World Cup ever played?

No. This launch version supports 2018, 2022, and 2026 because those years have validated JSON-backed coverage for this actor.

Are group tables official?

No. Group tables are calculated from completed full-time results in the source dataset. They are useful for dashboards and exports, but the source data should be checked if official standings are required.

Can I monitor one team?

Yes. Fill the Team Filter field, for example Portugal, Brazil, or United States.

Can I get only knockout matches?

Yes. Set Stage to Knockout stage. Group tables are still based only on completed group matches if Include Group Tables is enabled.

Is this suitable for spreadsheets?

Yes. Matches and group tables are flat outputs and export cleanly to CSV or Excel.

Troubleshooting

If a run returns fewer rows than expected, check the selected year, stage, group, team filter, and maxMatches value first.

If 2026 results are still empty before matches are played, that is expected. Fixtures can be present while scores and calculated group tables remain incomplete.

For bugs, missing supported years, or output issues, use the Issues tab on the actor page.

Related actors

For domestic football workflows, see Spain Football Results & Tables, Italy Football Results & Tables, France Football Results & Tables, and Turkey Football Results & Tables.

Changelog

0.1

Initial version with supported World Cup fixtures, results, filters, and calculated group tables for 2018, 2022, and 2026.