{ "openapi": "3.0.1", "info": { "title": "Flashscore Teams & Players: Squads, Transfers", "description": "Scrape Flashscore team and player profiles: squads with season stats, full match history, transfers with fees, market values, contracts, career stats per season, last-match ratings and injury history. Football, basketball, hockey and more. Search by name. No API key.", "version": "1.0", "x-build-id": "JWHu7aq1pnqRp2JYP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/incognito_mode~flashscore-team-player-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-incognito_mode-flashscore-team-player-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~flashscore-team-player-scraper/runs": { "post": { "operationId": "runs-sync-incognito_mode-flashscore-team-player-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~flashscore-team-player-scraper/run-sync": { "post": { "operationId": "run-sync-incognito_mode-flashscore-team-player-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": { "teamUrls": { "title": "Team URLs", "type": "array", "description": "Flashscore team pages, any team sport and any Flashscore edition (.com, .co.uk ...), e.g. https://www.flashscore.com/team/arsenal/hA1Zm19f/. Sub-pages such as .../squad/ work too.", "items": { "type": "string" } }, "playerUrls": { "title": "Player URLs", "type": "array", "description": "Flashscore player or coach pages, e.g. https://www.flashscore.com/player/saka-bukayo/08NLEo06/.", "items": { "type": "string" } }, "searchQueries": { "title": "Search by name", "type": "array", "description": "Team or player names, e.g. \"Real Madrid\" or \"Bukayo Saka\". Each name scrapes Flashscore's best team or team-sport player match.", "items": { "type": "string" } }, "searchSport": { "title": "Search sport", "enum": [ "", "football", "basketball", "hockey", "handball", "volleyball", "american-football", "baseball", "rugby-union", "rugby-league", "futsal", "floorball", "aussie-rules", "water-polo", "field-hockey", "cricket" ], "type": "string", "description": "Only match names in this sport (\"Rapperswil\" is both a football club and a hockey club).", "default": "" }, "teamSections": { "title": "Team data", "type": "array", "description": "Profile: venue, capacity, coach, squad size. Squad: every player and coach with season stats and injuries. Results: past matches (newest first). Fixtures: every scheduled match. Transfers: arrivals and departures with fees (newest first).", "items": { "type": "string", "enum": [ "profile", "squad", "results", "fixtures", "transfers" ], "enumTitles": [ "Profile", "Squad", "Results", "Fixtures", "Transfers" ] }, "default": [ "profile", "squad", "results", "fixtures", "transfers" ] }, "maxResultsPerTeam": { "title": "Results per team", "minimum": 0, "type": "integer", "description": "Newest results to return per team. 0 = the team's entire history (Arsenal: 5,077 matches, a century of them).", "default": 50 }, "maxTransfersPerTeam": { "title": "Transfers per team", "minimum": 0, "type": "integer", "description": "Newest transfers to return per team. 0 = every transfer Flashscore lists (Arsenal: about 1,700, back to the 1970s).", "default": 50 }, "squadPerCompetition": { "title": "Squad stats per competition", "type": "boolean", "description": "Besides the all-competitions squad table, add one squad table per competition (league, cups, Europe).", "default": false }, "scrapeSquadPlayers": { "title": "Full profiles for every squad member", "type": "boolean", "description": "Also scrape the player page of everyone in each team's squad (about 30 extra player profiles per team).", "default": false }, "playerSections": { "title": "Player data", "type": "array", "description": "Profile: club, position, age, date of birth, market value, contract expiry, height, current injury. Career: one row per season, club and competition. Last matches: the 10 most recent matches with rating and stats. Transfers: career moves with fees. Injuries: injury history.", "items": { "type": "string", "enum": [ "profile", "career", "lastMatches", "transfers", "injuries" ], "enumTitles": [ "Profile", "Career", "Last matches", "Transfers", "Injuries" ] }, "default": [ "profile", "career", "lastMatches", "transfers", "injuries" ] }, "maxItems": { "title": "Max rows", "minimum": 1, "type": "integer", "description": "Stop after this many dataset rows in total.", "default": 10000 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Not needed: Flashscore does not block by IP. The Actor escalates to Apify proxies automatically if it is ever refused.", "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }