# FotMob Match Details Scraper (`incognito_mode/fotmob-match-details-scraper`) Actor Scrape full FotMob match details: final score, lineups & formations, per-player stats and ratings, a goal/card/substitution timeline, the team-stat comparison, venue, referee and player of the match. One normalized JSON/CSV record per match. Failed lookups are never billed. - **URL**: https://apify.com/incognito\_mode/fotmob-match-details-scraper.md - **Developed by:** [Elena Vance](https://apify.com/incognito_mode) (community) - **Categories:** News, Developer tools, Integrations - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $10.00 / 1,000 match details results 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 ## FotMob Match Details Scraper — Lineups, Per-Player Stats, Events & xG, in One Record **Turn any FotMob match into clean, structured JSON or CSV: the final score, both teams' formations and lineups, per-player statistics and ratings, a goal/card/substitution timeline, the full head-to-head team-stat comparison (possession, shots, xG, passing, duels…), plus venue, referee, attendance and player of the match — one rich, normalized record per match.** Give it one or more match ids (or match URLs), toggle exactly which sections you want, and get back the deepest per-match football data FotMob exposes — ready for a spreadsheet, database, model, or app. No login, no account, no HTML wrangling — and **you are never billed for failed lookups**. > **Good to know:** don't have match ids? Run the **[FotMob Matches Scraper](https://apify.com/incognito_mode/fotmob-matches-scraper)** (by > date) or the **[FotMob League Scraper](https://apify.com/incognito_mode/fotmob-league-scraper)** (a whole season of fixtures) first — both > emit the `matchId`s you feed straight in here. --- ### Why this Actor - **The whole match in one record.** Score, lineups, per-player stats, events, the team-stat comparison, and the match info box come back together — not scattered across a dozen requests. - **Per-player depth.** Each player carries their rating, minutes, goals/assists, shots, xG/xA, passing accuracy, duels, defensive actions, and (for keepers) saves and goals conceded — flattened into a flat, analysis-ready dict. - **A clean events timeline.** Goals, cards, and substitutions as a single ordered `events` array with minute, player, and running score — not buried inside player objects (a known bug in naïve scrapers, fixed here). - **Pick exactly what you need.** Toggle player stats, events, lineups, team stats, and head-to-head independently to control item size and cost. - **Robust two-tier fetch.** Tries FotMob's embedded page data first (no auth), and falls back to the signed API — automatically, and only trusting the page when its match id matches what you asked for. - **Works globally, no login.** No FotMob account, no per-region setup. Apify Proxy (datacenter by default) handles the requests for you. - **You never pay for failures.** A match that can't be parsed or fetched is reported in the run summary — **not** written to your dataset and **not billed**. - **Clean, consistent output.** Integer ids, parsed scores, ISO timestamps, and a stable schema across every league and match. --- ### Problems this Actor solves | If you are… | Your problem | How this Actor solves it | |---|---|---| | **A football data / analytics builder** | Per-player and team stats live in messy nested payloads behind request signing | One run returns a flat, normalized record per match — players, team stats, events | | **A model / prediction developer** | You need rich match features (xG, shots, duels, ratings) at scale | Feed a list of match ids; pull every stat in a stable schema, history included | | **A fantasy / scouting tool builder** | Tracking individual performances across matches is manual | Per-player ratings and stats in every record — filter and aggregate downstream | | **A content creator / journalist** | Compiling lineups, timelines, and stat comparisons is slow | Lineups, the event timeline, and the head-to-head stat table, export-ready | | **An app / chatbot / agent developer** | You want deep match data without building and maintaining a scraper | Pay per match on demand; toggle off sections you don't need to cut size and cost | --- ### What data you get Each match becomes one dataset record. Top-level fields are always present; the larger sections are **optional** (toggled by input): | Field | Description | |---|---| | `matchId` | FotMob's stable numeric match id (the record's unique id). Integer | | `matchName` | FotMob's match label (e.g. `Aston Villa-vs-Manchester United_…`) | | `matchUrl` | Absolute FotMob match URL | | `leagueId` / `leagueName` | Competition id and name | | `round` / `roundName` | Match round / matchday | | `countryCode` | FIFA country code (e.g. `ENG`) | | `matchTimeUtc` | Kickoff time in UTC (ISO 8601) | | `started` / `finished` | Match status booleans | | `homeTeam` / `awayTeam` | `{ id, name, score }` per side | | `tournament` | Tournament / stage label, when present | | `venue` | Stadium name | | `referee` | Match referee | | `attendance` | Reported attendance | | `playerOfTheMatch` | `{ playerId, name, teamName }`, when awarded | | `teamStats` | *Optional:* head-to-head stat comparison — see below | | `events` | *Optional:* goal/card/substitution timeline — see below | | `lineups` | *Optional:* both teams' formations, starters, subs, coach — see below | | `playerStats` | *Optional:* per-player stats and ratings — see below | | `h2h` | *Optional:* previous meetings between the two teams | | `source` | Always `fotmob-match-details-scraper` | | `scrapedAt` | ISO 8601 timestamp of the run | | `rawData` | *Optional:* the full raw FotMob match payload, when **Include raw data** is on | **`teamStats[]`** — the head-to-head comparison, grouped (`Top stats`, `Shots`, `Expected goals (xG)`, `Passes`, `Defence`, `Duels`, `Discipline`): each entry is `{ group, title, key, home, away }`. Values are numbers or `"value (pct%)"` strings, matching how FotMob renders them. **`events[]`** — one ordered entry per goal/card/substitution: `{ type, minute, minuteLabel, isHome, playerId, playerName, homeScore, awayScore }`, plus `card` for cards, `goalType`/`assist` for goals, and `playersInvolved` for substitutions. **`lineups`** — `{ home, away }`; each side is `{ teamId, teamName, formation, coach, starters[], subs[] }`, and each player is `{ playerId, name, shirtNumber, position, rating }`. **`playerStats[]`** — one entry per player who featured, with identity (`playerId`, `name`, `teamId`, `teamName`, `shirtNumber`, `position`, `isGoalkeeper`) plus a flat set of that player's match stats — e.g. `rating_title`, `minutes_played`, `goals`, `assists`, `expected_goals`, `expected_assists`, `total_shots`, `accurate_passes` (`"36/42 (85.7%)"`), `chances_created`, `touches`, `duel_won`, `clearances`, and (for keepers) `saves`, `goals_conceded`. Available stats vary by player and competition. #### Example output Aston Villa 0–0 Manchester United — heavily trimmed (`teamStats`, `events`, `lineups`, and `playerStats` are much longer in a real record): ```jsonc { "matchId": 4506324, "matchName": "Aston Villa-vs-Manchester United_Sun, Oct 6, 2024, 13:00 UTC", "matchUrl": "https://www.fotmob.com/match/4506324", "leagueId": 47, "leagueName": "Premier League", "round": "7", "countryCode": "ENG", "matchTimeUtc": "2024-10-06T13:00:00.000Z", "started": true, "finished": true, "homeTeam": { "id": 10252, "name": "Aston Villa", "score": 0 }, "awayTeam": { "id": 10260, "name": "Manchester United", "score": 0 }, "venue": "Villa Park", "referee": "Robert Jones", "attendance": 42682, "playerOfTheMatch": { "playerId": 268375, "name": "Emiliano Martinez", "teamName": "Aston Villa" }, "teamStats": [ { "group": "Top stats", "title": "Ball possession", "key": "BallPossesion", "home": 54, "away": 46 }, { "group": "Top stats", "title": "Expected goals (xG)", "key": "expected_goals", "home": "0.50", "away": "0.56" }, { "group": "Top stats", "title": "Accurate passes", "key": "accurate_passes", "home": "345 (83%)", "away": "302 (82%)" } // … more, grouped by Shots / xG / Passes / Defence / Duels / Discipline ], "events": [ { "type": "Card", "minute": 3, "minuteLabel": 3, "isHome": false, "playerId": 157723, "playerName": "Christian Eriksen", "card": "Yellow" }, { "type": "Substitution", "minute": 12, "isHome": true, "playersInvolved": ["Diego Carlos", "Ezri Konsa"] } // … goals carry goalType + assist ], "lineups": { "home": { "teamId": 10252, "teamName": "Aston Villa", "formation": "4-4-1-1", "coach": "Unai Emery", "starters": [ { "playerId": 268375, "name": "Emiliano Martinez", "shirtNumber": "23" } /* … */ ], "subs": [ /* … */ ] }, "away": { "teamId": 10260, "teamName": "Manchester United", "formation": "4-2-3-1", "coach": "Erik ten Hag", "starters": [ /* … */ ], "subs": [ /* … */ ] } }, "playerStats": [ { "playerId": 268375, "name": "Emiliano Martinez", "teamId": 10252, "teamName": "Aston Villa", "shirtNumber": "23", "isGoalkeeper": true, "rating_title": 8.36, "minutes_played": 90, "saves": 4, "goals_conceded": 0, "accurate_passes": "24/32 (75.0%)", "touches": 40 } // … one entry per player who featured ], "source": "fotmob-match-details-scraper", "scrapedAt": "2026-06-18T11:11:32+00:00" } ```` A match id that can't be parsed, or a match that won't load, is **not** written to the dataset (and never billed). It is listed in the run's `SUMMARY` record in the key-value store — `{ "failures": [ { "input": "…", "matchId": …, "error": "…" } ] }` — and the run's status message tells you at a glance how many matches succeeded. *** ### How to use it (60 seconds) 1. Click **Try for free / Start**. 2. Add one or more **Match ids or URLs** (one per line) — e.g. `4506324`, or a full match URL like `https://www.fotmob.com/match/4506324`. *(Don't have ids? Run the **FotMob Matches Scraper** or **FotMob League Scraper** first — both emit `matchId`s.)* 3. Toggle the sections you want: **player stats**, **events**, **lineups**, **team stats** (all on by default), **head-to-head** (off by default), and optionally **raw data**. 4. Keep the **Apify Proxy** enabled (datacenter is enough — the default). 5. Click **Save & Start**. Download results as **JSON, CSV, Excel, or via API** from the **Dataset** tab; check **Key-value store → SUMMARY** for run totals and any failed lookups. *** ### Input reference | Field | Type | Default | Description | |---|---|---|---| | **Match ids or URLs** | list | `["4506324"]` | One FotMob match id or match URL per line. Numeric ids, `/match/` URLs, and `…#` URLs all work. | | **Include player stats** | boolean | `true` | Per-player statistics and ratings (for started matches). | | **Include events timeline** | boolean | `true` | The goal / card / substitution timeline. | | **Include lineups** | boolean | `true` | Both teams' formations, starters, subs, and coach. | | **Include team stats** | boolean | `true` | The head-to-head team-stat comparison (possession, shots, xG…). | | **Include head-to-head history** | boolean | `false` | Previous meetings between the two teams. Increases item size. | | **Include raw data** | boolean | `false` | Adds the full raw FotMob match payload under `rawData`. Significantly increases item size. | | **Proxy configuration** | object | Apify Proxy (datacenter) | Routes requests through Apify Proxy. Datacenter is enough; switch to Residential only for very large jobs. | | **Max concurrency** | integer | `5` | Parallel requests (1–20). Kept moderate to be respectful. | | **Delay between requests** | integer | `1` | Politeness delay in seconds before each request (0–10). | | **Max items** | integer | `0` | Stop after producing this many records (`0` = no limit). | *** ### Pricing — what a run costs This Actor uses transparent **pay-per-event** pricing with a built-in **volume discount**: a small Actor-start fee, a fixed price per successful match record for the first 10,000 results of a run, and a cheaper rate for every result beyond that. **No subscription, no minimums, and failed lookups are never charged.** The exact per-result rate is shown on the Actor's **Pricing** tab. - **One billed record per match.** Failed lookups bill nothing. - **Failed lookups are free.** Unparseable ids and matches that won't load are reported in the summary, never billed. - **Bigger runs cost less per item.** The discount tier resets per run, so one large run is cheaper than the same job split into many small ones. - **Trim what you don't need.** Toggle off sections (e.g. raw data, head-to-head) to keep items small. - **Try it free:** an Apify free account includes **$5 of monthly platform credit** — enough to try the Actor before paying anything. - **Stay in control:** set **Max items** and Apify's **maximum charge per run**; the Actor stops gracefully at your cap, keeping everything already scraped. *** ### Compared to the alternatives | | **This Actor** | Build your own scraper | Manual checking | |---|---|---|---| | Score + lineups + per-player stats + events in one record | Yes | You maintain it | Impractical | | Team-stat comparison (xG, shots, duels…) | Yes | You parse it | Read off the page | | Clean event timeline (no dropped assists) | Yes | Easy to get wrong | – | | Handles FotMob request signing & fallback | Built in | You reverse-engineer it | – | | Toggle sections to control size/cost | Yes | You build it | – | | Never billed for failures | Yes | – | – | | Export JSON / CSV / Excel / API | Yes, built-in | DIY | Copy-paste | | Setup time | ~60 seconds | Days; breaks on site changes | Hours per match | *** ### A family of FotMob Actors This Actor is the deep-dive endpoint of a set that fit together: - **[FotMob Leagues List Scraper](https://apify.com/incognito_mode/fotmob-leagues-list-scraper)** — discover every league/competition and its id. - **[FotMob League Scraper](https://apify.com/incognito_mode/fotmob-league-scraper)** — standings, fixtures, results, and season top players; emits a season's `matchId`s. - **[FotMob Matches Scraper](https://apify.com/incognito_mode/fotmob-matches-scraper)** — every match for a date or range; emits `matchId`s. - **FotMob Match Details Scraper** *(this Actor)* — pass those `matchId`s to get lineups, events, team stats, and per-player match stats. Typical flow: discover matches with the Matches or League Scraper → take the `matchId`s → run this Actor for the deep per-match data. *** ### Integrate the data - **Exports:** JSON, CSV, Excel, XML from the Dataset tab — or fetch programmatically: ``` GET https://api.apify.com/v2/datasets/{datasetId}/items?format=json ``` - **Run on a schedule:** use Apify **Schedules** to expand each day's finished matches into details, and **webhooks** to push finished runs into your pipeline (Sheets, Slack, your backend). - **Chain from discovery:** read `matchId`s from the **FotMob Matches Scraper** or **FotMob League Scraper** and pass them straight in here. - **From code:** call the Actor with the [Apify API or SDKs](https://docs.apify.com/api) (Python / JavaScript) and read the dataset when the run finishes. - **Run summary:** every run writes a `SUMMARY` record (key-value store) with totals, successes, failures, and billing counts — ideal for monitoring automated pipelines. *** ### FAQ **Do I need a FotMob account or login?** No. There is no account or login required. **Where do I get match ids?** From the **FotMob Matches Scraper** (by date) or the **FotMob League Scraper** (a whole season of fixtures) — both emit `matchId`s. You can also paste a full FotMob match URL here; the Actor extracts the id for you. **Why is `playerStats` missing on some matches?** Per-player stats are only emitted for matches that have started. Upcoming matches return lineups (when announced) but no player stats. **Are player ratings included?** Yes — each player's `rating_title` is in `playerStats`. (Ratings in the `lineups` section can be `null` until FotMob populates them post-match; the authoritative rating is in `playerStats`.) **Can I make the records smaller?** Yes. Turn off any of **player stats**, **events**, **lineups**, **team stats**, **head-to-head**, or **raw data** to keep only what you need. **Do I need a proxy?** Apify Proxy is pre-selected (datacenter) and is enough for most runs; switch to Residential only if you hit blocks on very large jobs. **How fresh is the data?** Each run fetches live data, so you get exactly what FotMob shows at that moment — including in-progress matches. **What formats can I export?** JSON, CSV, Excel, XML — from the Console or via the Apify API. *** ### Disclaimer This Actor is intended for personal and research use. You are responsible for ensuring your use complies with FotMob's terms and applicable law. Please scrape responsibly — keep concurrency moderate and delays reasonable. This project is **not affiliated with, endorsed by, or sponsored by FotMob**. # Actor input Schema ## `matchIds` (type: `array`): One FotMob match id or match URL per line, e.g. "4506324" or "https://www.fotmob.com/match/4506324". Match ids are produced by the FotMob Matches Scraper and FotMob League Scraper. ## `includePlayerStats` (type: `boolean`): Include per-player statistics and ratings for started matches. ## `includeEvents` (type: `boolean`): Include the goal / card / substitution timeline. ## `includeLineups` (type: `boolean`): Include both teams' formations, starters, substitutes and coach. ## `includeTeamStats` (type: `boolean`): Include the head-to-head team statistics comparison (possession, shots, xG, …). ## `includeH2H` (type: `boolean`): Include previous meetings between the two teams. Increases item size. ## `includeRawData` (type: `boolean`): Adds the full raw FotMob match payload to each record under 'rawData'. Significantly increases item size; leave off unless you need fields beyond the normalized ones. ## `proxyConfiguration` (type: `object`): Apify Proxy routes requests and spreads load. Datacenter proxy is enough for most runs; switch to Residential if you hit blocks on very large jobs. ## `maxConcurrency` (type: `integer`): Maximum number of parallel requests. Keep this moderate to stay respectful. ## `requestDelaySecs` (type: `integer`): Politeness delay applied before each request. Keep a delay of at least 1 second to stay respectful. ## `maxItems` (type: `integer`): Stop after producing this many match records. Set to 0 for no limit. ## Actor input object example ```json { "matchIds": [ "4506324", "https://www.fotmob.com/matches/aston-villa-vs-manchester-united/2pj9x9#4506324" ], "includePlayerStats": true, "includeEvents": true, "includeLineups": true, "includeTeamStats": true, "includeH2H": false, "includeRawData": false, "proxyConfiguration": { "useApifyProxy": true }, "maxConcurrency": 5, "requestDelaySecs": 1, "maxItems": 0 } ``` # Actor output Schema ## `matches` (type: `string`): All scraped match-detail records (one item per match). ## `summary` (type: `string`): JSON summary of the run: totals, successes, failures, and billing counts. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "matchIds": [ "4506324" ], "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("incognito_mode/fotmob-match-details-scraper").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "matchIds": ["4506324"], "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("incognito_mode/fotmob-match-details-scraper").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 '{ "matchIds": [ "4506324" ], "proxyConfiguration": { "useApifyProxy": true } }' | apify call incognito_mode/fotmob-match-details-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=incognito_mode/fotmob-match-details-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "FotMob Match Details Scraper", "description": "Scrape full FotMob match details: final score, lineups & formations, per-player stats and ratings, a goal/card/substitution timeline, the team-stat comparison, venue, referee and player of the match. One normalized JSON/CSV record per match. Failed lookups are never billed.", "version": "0.1", "x-build-id": "6fhiiB8DNLjYtNReX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/incognito_mode~fotmob-match-details-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-incognito_mode-fotmob-match-details-scraper", "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/incognito_mode~fotmob-match-details-scraper/runs": { "post": { "operationId": "runs-sync-incognito_mode-fotmob-match-details-scraper", "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/incognito_mode~fotmob-match-details-scraper/run-sync": { "post": { "operationId": "run-sync-incognito_mode-fotmob-match-details-scraper", "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": { "matchIds": { "title": "Match ids or URLs", "type": "array", "description": "One FotMob match id or match URL per line, e.g. \"4506324\" or \"https://www.fotmob.com/match/4506324\". Match ids are produced by the FotMob Matches Scraper and FotMob League Scraper.", "items": { "type": "string" } }, "includePlayerStats": { "title": "Include player stats", "type": "boolean", "description": "Include per-player statistics and ratings for started matches.", "default": true }, "includeEvents": { "title": "Include events timeline", "type": "boolean", "description": "Include the goal / card / substitution timeline.", "default": true }, "includeLineups": { "title": "Include lineups", "type": "boolean", "description": "Include both teams' formations, starters, substitutes and coach.", "default": true }, "includeTeamStats": { "title": "Include team stats", "type": "boolean", "description": "Include the head-to-head team statistics comparison (possession, shots, xG, …).", "default": true }, "includeH2H": { "title": "Include head-to-head history", "type": "boolean", "description": "Include previous meetings between the two teams. Increases item size.", "default": false }, "includeRawData": { "title": "Include raw data", "type": "boolean", "description": "Adds the full raw FotMob match payload to each record under 'rawData'. Significantly increases item size; leave off unless you need fields beyond the normalized ones.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy routes requests and spreads load. Datacenter proxy is enough for most runs; switch to Residential if you hit blocks on very large jobs.", "default": { "useApifyProxy": true } }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of parallel requests. Keep this moderate to stay respectful.", "default": 5 }, "requestDelaySecs": { "title": "Delay between requests (seconds)", "minimum": 0, "maximum": 10, "type": "integer", "description": "Politeness delay applied before each request. Keep a delay of at least 1 second to stay respectful.", "default": 1 }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Stop after producing this many match records. Set to 0 for no limit.", "default": 0 } } }, "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 } } } } } } } } } } ```