# FIFA World Cup 2026 — Results, Fixtures & Standings (`veeronica/fifa-world-cup-2026-results-fixtures-standings`) Actor

Scrape FIFA World Cup 2026 data: live scores, match results, upcoming fixtures, group standings, the knockout bracket, goal scorers, cards, venues, and attendance. Filter by stage, match status, or team.

- **URL**: https://apify.com/veeronica/fifa-world-cup-2026-results-fixtures-standings.md
- **Developed by:** [Veronica](https://apify.com/veeronica) (community)
- **Categories:** News, Automation
- **Stats:** 9 total users, 5 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 group standings

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## FIFA World Cup 2026 Scraper — Results, Fixtures, Standings & Bracket

### Overview

This Apify Actor scrapes the **entire FIFA World Cup 2026** — all 104 matches across the USA, Canada, and Mexico — in a single run, returning structured, deduplicated results. Get **live scores, final results, upcoming fixtures, the full knockout bracket, group standings, goal scorers, cards, venues, and attendance** without any API keys or coding.

Data updates live during matches, so a run started mid-game returns the latest available scoreline, scorers, and cards.

**At a glance:**
- ⚽ All 104 matches — group stage through the final
- 📊 All 12 group tables (48 teams)
- 🏆 Full knockout bracket, including placeholder fixtures before teams qualify
- 🔄 Auto-deduplicated across overlapping stage windows
- 💾 Export to JSON, CSV, Excel, or XML
- 🔌 No API key required

---

### ✨ Core Features

- **Complete coverage** — Group Stage, Round of 32, Round of 16, Quarterfinals, Semifinals, Third-Place Match, and Final
- **Live scores & results** — scoreline, status (scheduled / live / full-time), and winner, updated in real time
- **Upcoming fixtures** — kickoff times, venues, and broadcasters for games not yet played
- **Knockout bracket** — every knockout tie, with placeholders like *Group A Winner vs Group B Runner-up* until teams are confirmed
- **Group standings** — rank, played, W/D/L, goals for/against, goal difference, points, and qualification status
- **Goal scorers & cards** — every goal (with minute, own goals, penalties) and every yellow/red card
- **Match context** — stadium, city, country, attendance, TV/streaming networks, and a recap headline
- **Powerful filters** — by stage, match status, or specific team
- **Auto-deduplication** — each match appears exactly once, even across stage boundaries

---

### 📥 Input Parameters

All parameters are optional. Run with empty input to scrape the whole tournament plus standings.

| Field | Type | Default | Notes |
|-------|------|---------|-------|
| `stages` | array | all stages | Stages to scrape: `group-stage`, `round-of-32`, `round-of-16`, `quarterfinals`, `semifinals`, `3rd-place-match`, `final` |
| `matchStatus` | string | `all` | Filter by status: `all`, `completed` (results), `upcoming` (fixtures), `live` |
| `team` | string | — | Only matches involving this team. Accepts a name or 3-letter code (e.g. `Mexico`, `USA`, `BRA`) |
| `includeMatchDetails` | boolean | `true` | Include goal scorers, cards, attendance, broadcasts, and recap |
| `includeStandings` | boolean | `true` | Also output the 12 group tables (one row per team) |

---

### 📤 Output Fields

Results are stored in the default dataset. Each item has a `recordType` of either `match` or `standing`.

#### Match records (`recordType: "match"`)

**Identity:** `id`, `stage`, `stageSlug`, `group`, `name`, `shortName`, `url`

**Schedule & status:** `date` (ISO kickoff), `status` (`scheduled` / `in` / `post`), `statusDetail`, `completed`

**Teams** (`homeTeam` & `awayTeam`): `name`, `abbreviation`, `logo`, `score`, `shootoutScore`, `winner`, `advanced`, `form`, `record`

**Result:** `score` (e.g. `2-0` or `1-1 (4-2 pens)`), `winner`

**Venue:** `venue.name`, `venue.city`, `venue.country`, `attendance`

**Match events:** `goals[]` (minute, player, teamId, ownGoal, penalty), `cards[]` (minute, player, teamId, type), `broadcasts[]`, `recap`

#### Standing records (`recordType: "standing"`)

`group`, `rank`, `team` (name / abbreviation / logo), `played`, `wins`, `draws`, `losses`, `goalsFor`, `goalsAgainst`, `goalDifference`, `points`, `note` (qualification status, e.g. *Advance to Round of 32*)

---

### 💵 Pricing

**Pay-per-event** — you pay only for the data you actually pull:

- **Actor start** — once per run
- **Match** — per match record returned
- **Group standings** — once per run, only when *Include group standings* is on (flat fee for all 12 tables)

See the **Pricing** tab on the Actor's page for current rates.

---

### ⚠️ Notes & Limitations

- **Unplayed matches** return `score: null` and `winner: null`. Knockout fixtures show placeholder team names (e.g. *Group D 2nd Place*) until the bracket is decided.
- **Status values:** `scheduled` (upcoming), `in` (live now), `post` (finished). A draw is reported as `winner: "Draw"` once completed.
- **Mixed dataset:** matches and standings share one dataset. The dataset views ("Matches" and "Group standings") control which columns display — standings columns appear blank on match rows and vice versa.
- **Freshness:** schedule the Actor to re-run during the tournament (11 June – 19 July 2026) to keep results and standings current.
- **Source:** publicly available match data. Use responsibly and in line with applicable terms and laws.

---

### 🧪 Usage Examples

#### Whole tournament (default)
```json
{
  "matchStatus": "all",
  "includeMatchDetails": true,
  "includeStandings": true
}
````

#### Only completed results

```json
{
  "matchStatus": "completed",
  "includeStandings": false
}
```

#### Upcoming fixtures, knockout rounds only

```json
{
  "stages": ["round-of-32", "round-of-16", "quarterfinals", "semifinals", "final"],
  "matchStatus": "upcoming"
}
```

#### One team's matches

```json
{
  "team": "Mexico",
  "includeStandings": false
}
```

#### Group standings only

```json
{
  "stages": [],
  "matchStatus": "completed",
  "includeStandings": true,
  "includeMatchDetails": false
}
```

***

### 🛠️ Integration Guide

Replace `<YOUR_API_TOKEN>` with your Apify token and `<ACTOR_ID>` with this Actor's ID (e.g. `your-username/world-cup-2026-scraper`).

#### JavaScript / TypeScript

```bash
npm install apify-client
```

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_API_TOKEN>' });
const input = { matchStatus: 'completed', includeStandings: true };
const run = await client.actor('<ACTOR_ID>').call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

#### Python

```bash
pip install apify-client
```

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")
run_input = {"matchStatus": "completed", "includeStandings": True}
run = client.actor("<ACTOR_ID>").call(run_input=run_input)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

#### CLI

```bash
echo '{"matchStatus":"completed"}' | apify call <ACTOR_ID> --silent --output-dataset
```

#### MCP Server

```json
{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.apify.com/?tools=<ACTOR_ID>", "--header", "Authorization: Bearer <YOUR_API_TOKEN>"]
    }
  }
}
```

***

### FAQ & Best Practices

**Q: How current is the data?**
A: Scores, scorers, cards, and standings update live during matches, so a run started mid-game returns the latest available state.

**Q: How do I get only my country's games?**
A: Set the `team` filter to a country name or 3-letter code (e.g. `Argentina` or `ARG`).

**Q: Can I get the knockout bracket before the groups finish?**
A: Yes. Scrape the knockout `stages` with `matchStatus: "upcoming"` — fixtures appear with placeholder names (e.g. *Group A Winner*) and resolve to real teams as the bracket fills in.

**Q: What's the difference between the statuses?**
A: `scheduled` = upcoming fixture, `in` = match in progress, `post` = finished. Use `matchStatus` to filter to exactly what you need.

**Q: Do I need a proxy?**
A: No setup needed. The Actor uses the default Apify Proxy automatically, which is sufficient for the public data source.

***

**Ready to start?** Click **Start** with the default input to grab the full tournament, or set a filter to narrow it down to one stage, status, or team.

# Actor input Schema

## `stages` (type: `array`):

Which tournament stages to scrape matches from. Leave empty to include every stage (group stage through the final).

## `matchStatus` (type: `string`):

Filter matches by status. <code>Completed</code> = finished matches (results). <code>Upcoming</code> = scheduled fixtures yet to be played. <code>Live</code> = currently in progress.

## `team` (type: `string`):

Only return matches involving this team. Matches by team name or 3-letter code, e.g. <code>Mexico</code>, <code>USA</code>, <code>BRA</code>. Leave empty for all teams.

## `includeMatchDetails` (type: `boolean`):

Include goal scorers, cards, attendance, broadcasts, and the match recap for each match. Turn off for a lighter scoreline-only output.

## `includeStandings` (type: `boolean`):

Also output the 12 group tables (one record per team) with points, wins/draws/losses, goals for/against, and goal difference.

## Actor input object example

```json
{
  "stages": [],
  "matchStatus": "all",
  "includeMatchDetails": true,
  "includeStandings": true
}
```

# Actor output Schema

## `matches` (type: `string`):

World Cup 2026 matches: results, upcoming fixtures, the knockout bracket, scores, goal scorers, cards, venues, and attendance.

## `standings` (type: `string`):

Group tables for all 12 groups — one row per team with rank, played, W/D/L, goals for/against, goal difference, and points. Empty when 'Include group standings' is off.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("veeronica/fifa-world-cup-2026-results-fixtures-standings").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("veeronica/fifa-world-cup-2026-results-fixtures-standings").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call veeronica/fifa-world-cup-2026-results-fixtures-standings --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=veeronica/fifa-world-cup-2026-results-fixtures-standings",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "FIFA World Cup 2026 — Results, Fixtures & Standings",
        "description": "Scrape FIFA World Cup 2026 data: live scores, match results, upcoming fixtures, group standings, the knockout bracket, goal scorers, cards, venues, and attendance. Filter by stage, match status, or team.",
        "version": "1.0",
        "x-build-id": "6r13gUpNJaEkhAEKa"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/veeronica~fifa-world-cup-2026-results-fixtures-standings/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-veeronica-fifa-world-cup-2026-results-fixtures-standings",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/veeronica~fifa-world-cup-2026-results-fixtures-standings/runs": {
            "post": {
                "operationId": "runs-sync-veeronica-fifa-world-cup-2026-results-fixtures-standings",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/veeronica~fifa-world-cup-2026-results-fixtures-standings/run-sync": {
            "post": {
                "operationId": "run-sync-veeronica-fifa-world-cup-2026-results-fixtures-standings",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "stages": {
                        "title": "Stages",
                        "type": "array",
                        "description": "Which tournament stages to scrape matches from. Leave empty to include every stage (group stage through the final).",
                        "items": {
                            "type": "string",
                            "enum": [
                                "group-stage",
                                "round-of-32",
                                "round-of-16",
                                "quarterfinals",
                                "semifinals",
                                "3rd-place-match",
                                "final"
                            ],
                            "enumTitles": [
                                "Group Stage",
                                "Round of 32",
                                "Round of 16",
                                "Quarterfinals",
                                "Semifinals",
                                "Third-Place Match",
                                "Final"
                            ]
                        },
                        "default": []
                    },
                    "matchStatus": {
                        "title": "Match status",
                        "enum": [
                            "all",
                            "completed",
                            "upcoming",
                            "live"
                        ],
                        "type": "string",
                        "description": "Filter matches by status. <code>Completed</code> = finished matches (results). <code>Upcoming</code> = scheduled fixtures yet to be played. <code>Live</code> = currently in progress.",
                        "default": "all"
                    },
                    "team": {
                        "title": "Team filter",
                        "type": "string",
                        "description": "Only return matches involving this team. Matches by team name or 3-letter code, e.g. <code>Mexico</code>, <code>USA</code>, <code>BRA</code>. Leave empty for all teams."
                    },
                    "includeMatchDetails": {
                        "title": "Include match details",
                        "type": "boolean",
                        "description": "Include goal scorers, cards, attendance, broadcasts, and the match recap for each match. Turn off for a lighter scoreline-only output.",
                        "default": true
                    },
                    "includeStandings": {
                        "title": "Include group standings",
                        "type": "boolean",
                        "description": "Also output the 12 group tables (one record per team) with points, wins/draws/losses, goals for/against, and goal difference.",
                        "default": true
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
