{ "openapi": "3.0.1", "info": { "title": "FotMob Scraper - Live Scores, xG, Ratings & Standings", "description": "Scrape FotMob football data in one Actor: fixtures, live scores, league standings, match details with lineups/xG/player ratings, team squads, player profiles, transfers, and search. HTTP JSON API alternative — Python, Node.js, MCP.", "version": "0.1", "x-build-id": "MjDyujpVD4eFmoYr2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawloop~fotmob-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawloop-fotmob-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/crawloop~fotmob-scraper/runs": { "post": { "operationId": "runs-sync-crawloop-fotmob-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/crawloop~fotmob-scraper/run-sync": { "post": { "operationId": "run-sync-crawloop-fotmob-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": { "mode": { "title": "Mode", "enum": [ "auto", "matches", "leagues", "league", "match", "team", "player", "transfers", "search" ], "type": "string", "description": "What to scrape. matches = fixtures/live/results by date; leagues = full competition directory; league = standings+fixtures for league ids; match = deep match details; team / player / transfers / search; auto picks from filled inputs.", "default": "auto" }, "dates": { "title": "Dates (YYYYMMDD)", "type": "array", "description": "Dates for matches mode. Example: 20260804. Leave empty (with no range) for today UTC.", "default": [], "items": { "type": "string" } }, "dateFrom": { "title": "Date from (YYYYMMDD)", "type": "string", "description": "Inclusive start of a date range for matches mode.", "default": "" }, "dateTo": { "title": "Date to (YYYYMMDD)", "type": "string", "description": "Inclusive end of a date range for matches mode.", "default": "" }, "timezone": { "title": "Timezone", "type": "string", "description": "IANA timezone for the matches day bucket (e.g. Europe/Berlin, UTC).", "default": "UTC" }, "matchStatus": { "title": "Match status filter", "enum": [ "all", "finished", "live", "upcoming" ], "type": "string", "description": "Filter matches mode results by status.", "default": "all" }, "leagueIds": { "title": "League IDs", "type": "array", "description": "FotMob league ids (e.g. 54 = Bundesliga, 47 = Premier League). Used as filter in matches mode or as targets in league mode.", "default": [], "items": { "type": "string" } }, "leagueUrls": { "title": "League URLs", "type": "array", "description": "FotMob league page URLs. Ids are parsed automatically.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "seasons": { "title": "Seasons", "type": "array", "description": "Optional seasons for league mode (e.g. 2025/2026). Empty = current season.", "default": [], "items": { "type": "string" } }, "category": { "title": "League directory category", "enum": [ "all", "popular", "international", "domestic" ], "type": "string", "description": "For leagues mode: which bucket to return.", "default": "all" }, "countryCodes": { "title": "Country codes (domestic filter)", "type": "array", "description": "FIFA country codes for leagues mode domestic filter (e.g. GER, ENG, ESP).", "default": [], "items": { "type": "string" } }, "matchIds": { "title": "Match IDs", "type": "array", "description": "FotMob match ids for match mode (and optional enrich).", "default": [], "items": { "type": "string" } }, "matchUrls": { "title": "Match URLs", "type": "array", "description": "FotMob match page URLs.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "teamIds": { "title": "Team IDs", "type": "array", "description": "FotMob team ids for team mode.", "default": [], "items": { "type": "string" } }, "teamUrls": { "title": "Team URLs", "type": "array", "description": "FotMob team page URLs.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "playerIds": { "title": "Player IDs", "type": "array", "description": "FotMob player ids for player mode.", "default": [], "items": { "type": "string" } }, "playerUrls": { "title": "Player URLs", "type": "array", "description": "FotMob player page URLs.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchQueries": { "title": "Search queries", "type": "array", "description": "Terms for search mode (team, player, match suggest).", "default": [], "items": { "type": "string" } }, "fullSearch": { "title": "Use full search API", "type": "boolean", "description": "When true, use searchapi/search instead of suggest (search mode).", "default": false }, "transferPages": { "title": "Transfer pages", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many pages to pull in transfers mode (≈50 rows/page).", "default": 1 }, "enrichMatchDetails": { "title": "Enrich match details", "type": "boolean", "description": "In matches or league mode, also fetch full match details (lineups, xG, ratings) for each match id. Billed as separate match-detail events.", "default": false }, "includeStandings": { "title": "Include standings", "type": "boolean", "description": "Include standings tables in league / team modes.", "default": true }, "includeFixtures": { "title": "Include fixtures", "type": "boolean", "description": "Include fixtures / match lists in league / team modes.", "default": true }, "includeTopPlayers": { "title": "Include top players", "type": "boolean", "description": "Include season top players (rating / goals / assists) in league mode.", "default": true }, "includeSquad": { "title": "Include squad", "type": "boolean", "description": "Include squad groups in team mode.", "default": true }, "includeTeamStats": { "title": "Include team stats (match)", "type": "boolean", "description": "Match details: team-vs-team stats including xG when available.", "default": true }, "includeEvents": { "title": "Include events (match)", "type": "boolean", "description": "Match details: goals, cards, substitutions timeline.", "default": true }, "includeLineups": { "title": "Include lineups (match)", "type": "boolean", "description": "Match details: formations, starters, subs, coach.", "default": true }, "includePlayerStats": { "title": "Include player stats (match)", "type": "boolean", "description": "Match details: per-player stats and ratings.", "default": true }, "includeH2H": { "title": "Include H2H (match)", "type": "boolean", "description": "Match details: previous meetings block.", "default": true }, "includeShotmap": { "title": "Include shotmap (match)", "type": "boolean", "description": "Match details: raw shotmap payload (larger).", "default": false }, "includeMomentum": { "title": "Include momentum (match)", "type": "boolean", "description": "Match details: momentum graph data.", "default": false }, "includeRaw": { "title": "Include raw payload", "type": "boolean", "description": "Attach the full FotMob JSON as rawData (larger datasets).", "default": false }, "locale": { "title": "Locale", "enum": [ "en", "de" ], "type": "string", "description": "UI locale for URLs / Accept-Language (en or de). Data ids are global.", "default": "en" }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Stop after this many dataset records (0 = unlimited).", "default": 0 }, "requestDelaySecs": { "title": "Request delay (seconds)", "minimum": 0, "type": "number", "description": "Throttle between HTTP requests.", "default": 0.15 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional Apify Proxy. Datacenter is usually enough.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }