# Fantasy Premier League Player Stats Scraper (`parseforge/fpl-premier-league-scraper`) Actor Pull every Fantasy Premier League player with club, position, price, total points, form, ownership percent, goals, assists, minutes, and bonus. Switch modes for teams, gameweeks, and all 380 fixtures. Built for transfer planning, captaincy calls, and mini league research. - **URL**: https://apify.com/parseforge/fpl-premier-league-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 ![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true) ## ⚽ Fantasy Premier League Scraper > πŸš€ **Export every FPL player, team, gameweek and fixture in one run.** Pull all 841 players across 20 Premier League clubs with price, points, form and ownership, ready for your draft model or differential hunt. > πŸ•’ **Last updated:** 2026-06-04 Β· **πŸ“Š 20 fields** per player record Β· 841 players Β· 20 clubs Β· 38 gameweeks Β· 380 fixtures The Fantasy Premier League Scraper reads the official Fantasy Premier League data feed and turns it into clean, structured rows you can sort, filter and load anywhere. Pick players to get every footballer with live price, total points, form, ownership, goals, assists, minutes, clean sheets and bonus. Switch the data type to pull the 20 clubs, the 38 gameweek schedule, or all 380 fixtures with scorelines and difficulty ratings. Coverage spans the full current season. Player rows include a head shot photo URL, club name, playing position and injury or availability status, so you can build a transfer planner, a captaincy model, or a price change watchlist without touching the raw feed. | 🎯 Target Audience | πŸ’‘ Primary Use Cases | |---|---| | FPL managers and mini-league rivals | Transfer planning and differential hunting | | Football data analysts | Player value and form modelling | | Content creators and tipsters | Weekly team of the week and stat posts | | App and bot developers | Powering Telegram or Discord FPL tools | ### πŸ“‹ What the Fantasy Premier League Scraper does This Actor connects to the official Fantasy Premier League data feed and returns one of four data sets per run, chosen with a single dropdown. - **Players** returns all 841 players with photo, club, position, price, total points, form, ownership percent, goals, assists, minutes, clean sheets, bonus and availability news. - **Teams** returns the 20 Premier League clubs with short name and attack, defence and overall strength ratings split by home and away. - **Gameweeks** returns the 38 gameweek schedule with deadline times, average and highest scores and most selected and captained players. - **Fixtures** returns all 380 matches with kickoff time, home and away clubs, scoreline, difficulty ratings and match status. You can filter players by club and position, sort them by points, form, ownership, price, goals or assists, and cap how many rows you collect. ### 🎬 Full Demo (_🚧 Coming soon_) ### βš™οΈ Input The Actor accepts a small set of inputs. Only the data type is needed to get started, and it defaults to players. | Field | Type | Description | |---|---|---| | `dataType` | select | players, teams, gameweeks or fixtures. Defaults to players. | | `team` | select | Limit players or fixtures to one of the 20 clubs. Empty means all clubs. | | `position` | select | Limit players to Goalkeeper, Defender, Midfielder or Forward. | | `sortBy` | select | Order players by total points, form, ownership, price, goals or assists. | | `maxItems` | integer | Cap on rows. Free plan is limited to 10. | Example one, top scoring forwards: ```json { "dataType": "players", "position": "FWD", "sortBy": "totalPoints", "maxItems": 50 } ```` Example two, all fixtures for one club: ```json { "dataType": "fixtures", "team": "Arsenal" } ``` > ⚠️ **Good to Know:** The `team` and `position` filters apply to the players data type, and the `team` filter also narrows fixtures. They are ignored for teams and gameweeks, which always return the full 20 clubs and 38 gameweeks. ### πŸ“Š Output Each player record contains the following fields. | Field | Description | |---|---| | πŸ–Ό `imageUrl` | Player head shot photo URL | | πŸ†” `id` | Player element identifier | | πŸ“Œ `name` | Display name | | πŸͺͺ `fullName` | First and last name | | 🩺 `status` | Availability code (a available, i injured, d doubtful, s suspended, u unavailable) | | 🏟 `team` | Club name | | 🎽 `position` | Playing position | | πŸ’· `price` | Current price in millions | | ⭐ `totalPoints` | Total points this season | | πŸ“ˆ `form` | Recent form score | | πŸ‘₯ `selectedByPercent` | Ownership across all managers | | ⚽ `goals` | Goals scored | | πŸ…°οΈ `assists` | Assists | | ⏱ `minutes` | Minutes played | | 🧀 `cleanSheets` | Clean sheets | | 🎁 `bonus` | Bonus points | | πŸ“° `news` | Injury or availability note when present | | πŸ”’ `playerCode` | Source photo code | | πŸ•’ `scrapedAt` | Collection timestamp | | ❌ `error` | Null on success | Three real player records from a live run: ```json { "imageUrl": "https://resources.premierleague.com/premierleague/photos/players/110x140/p223094.png", "id": 430, "name": "Haaland", "fullName": "Erling Haaland", "status": "a", "team": "Man City", "position": "Forward", "price": 14.7, "totalPoints": 239, "form": 5, "selectedByPercent": 62.5, "goals": 27, "assists": 8, "minutes": 2953, "cleanSheets": 13, "bonus": 43, "news": "", "playerCode": 223094, "scrapedAt": "2026-06-04T20:00:18.550Z", "error": null } ``` ```json { "imageUrl": "https://resources.premierleague.com/premierleague/photos/players/110x140/p141746.png", "id": 449, "name": "B.Fernandes", "fullName": "Bruno Borges Fernandes", "status": "a", "team": "Man Utd", "position": "Midfielder", "price": 10.4, "totalPoints": 235, "form": 8.7, "selectedByPercent": 48, "goals": 9, "assists": 24, "minutes": 3065, "cleanSheets": 7, "bonus": 41, "news": "", "playerCode": 141746, "scrapedAt": "2026-06-04T20:00:18.550Z", "error": null } ``` ```json { "imageUrl": "https://resources.premierleague.com/premierleague/photos/players/110x140/p226597.png", "id": 5, "name": "Gabriel", "fullName": "Gabriel dos Santos MagalhΓ£es", "status": "a", "team": "Arsenal", "position": "Defender", "price": 7.3, "totalPoints": 209, "form": 6, "selectedByPercent": 45.4, "goals": 3, "assists": 5, "minutes": 2750, "cleanSheets": 18, "bonus": 30, "news": "", "playerCode": 226597, "scrapedAt": "2026-06-04T20:00:18.548Z", "error": null } ``` ### ✨ Why choose this Actor - **Four data sets in one Actor.** Players, teams, gameweeks and fixtures share the same clean schema, so you switch sets with a single dropdown. - **Official source.** Data comes straight from the Fantasy Premier League data feed, the same numbers you see in the game. - **Player photos included.** Every player row carries a head shot URL, ready to drop into a dashboard or card. - **Filter and sort built in.** Narrow by club and position and rank by the metric that matters for your move. - **Friendly fields.** Club names, position names and readable prices replace the raw numeric codes in the source. ### πŸ“ˆ How it compares to alternatives | Approach | Coverage | Friendly fields | Photos | Setup | |---|---|---|---|---| | This Actor | Players, teams, gameweeks, fixtures | Yes | Yes | One dropdown | | Copy from the game site | Manual, one screen at a time | No | No | Tedious | | Generic JSON tools | Raw codes only | No | No | Needs mapping work | | Spreadsheet plugins | Often stale | Partial | No | Fragile | ### πŸš€ How to use 1. Sign in or create a free Apify account using [this sign-up link](https://console.apify.com/sign-up?fpr=vmoqkp). 2. Open the Fantasy Premier League Scraper and choose a data type, starting with players. 3. Optionally set a club, a position, a sort order and a max items cap. 4. Click Start and watch the run log fill with collected records. 5. Open the dataset tab and use the results through the table view or the dataset URL. ### πŸ’Ό Business use cases #### πŸ“° Content and media | Need | How this helps | |---|---| | Weekly stat posts | Pull top scorers and form players in seconds | | Captaincy picks | Rank by form and ownership for differential angles | #### πŸ“± App and bot building | Need | How this helps | |---|---| | FPL Discord or Telegram bots | Feed live player prices and points into commands | | Transfer planner apps | Power a price and form table for users | #### πŸ“Š Analytics and modelling | Need | How this helps | |---|---| | Player value models | Combine price, minutes and points into value scores | | Fixture difficulty planning | Use fixture difficulty ratings per club run | #### πŸ† Mini-league strategy | Need | How this helps | |---|---| | Beat your rivals | Track ownership to find low owned high upside picks | | Injury watch | Read the news field to dodge flagged players | ### πŸ”Œ Automating Fantasy Premier League Scraper Connect the Actor to the tools you already use. - **Make** and **Zapier** can trigger a run on a schedule and route rows onward. - **Slack** can post a weekly form table to your mini-league channel. - **Airbyte** can sync the dataset into a warehouse for modelling. - **GitHub** Actions can run a scheduled collection and commit a snapshot. - **Google Drive** can store each run as a sheet for your group. ### 🌟 Beyond business use cases - **Research.** Study how price, form and ownership move across a season. - **Personal.** Build a private team planner for your own squad. - **Non-profit.** Run a community prediction league with shared data. - **Experimentation.** Train a simple model to forecast next gameweek points. ### πŸ€– Ask an AI assistant Paste a dataset row into your assistant and ask for help. - **ChatGPT**, **Claude**, **Perplexity** and **Copilot** can all summarise top picks, suggest transfers, or draft a captaincy argument from the fields you collect. ### ❓ Frequently Asked Questions **Where does the data come from?** The official Fantasy Premier League data feed, the same source that powers the game. **Which data types can I pull?** Players, teams, gameweeks and fixtures, selected with a single dropdown. **How many players are returned?** All 841 players in the current season pool, before any filters. **Can I get only one club?** Yes. Set the team filter to narrow players, and it also narrows fixtures. **How do I find forwards or goalkeepers?** Use the position filter on the players data type. **Are player photos included?** Yes. Each player row carries a head shot photo URL. **What does the price field mean?** The current in game price in millions, for example 14.7. **Why is the news field sometimes empty?** News only fills in when a player has an injury, suspension or availability note. Available players have an empty news field, which is expected. **Can I sort the players?** Yes. Sort by total points, form, ownership, price, goals or assists. **How many fixtures are there?** All 380 matches of the season, with scorelines for completed games. **Is there a free limit?** Free plan runs are capped at 10 rows. Paid plans lift the cap. **Does this need any login or key?** No. The Actor reads the public data feed for you. ### πŸ”Œ Integrate with any app Every run writes to an Apify dataset you can read through the dataset URL or the Apify API, so any app that can call an HTTP endpoint can consume the rows. ### πŸ”— Recommended Actors - [Understat xG Scraper](https://apify.com/parseforge/understat-xg-scraper) for expected goals and assists data. - [FBref Scraper](https://apify.com/parseforge/fbref-scraper) for deep football match and player statistics. - [Transfermarkt Scraper](https://apify.com/parseforge/transfermarkt-scraper) for player market values and transfers. - [Bundesliga Stats Scraper](https://apify.com/parseforge/bundesliga-stats-scraper) for German top flight numbers. - [Sofascore Live Scraper](https://apify.com/parseforge/sofascore-live-scraper) for live match data across competitions. > πŸ’‘ **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge). **πŸ†˜ Need Help?** [Open our contact form](https://tally.so/r/BzdKgA) > **⚠️ Disclaimer:** This is an independent tool, not affiliated with the Premier League or Fantasy Premier League. Only publicly available data is collected. # Actor input Schema ## `dataType` (type: `string`): Which Fantasy Premier League data set to pull. Players returns every footballer with price, points, form and ownership. Teams returns the 20 clubs. Gameweeks returns the season schedule with deadlines and average scores. Fixtures returns every match with kickoff time and scoreline. ## `team` (type: `string`): Limit Players or Fixtures to a single club. Leave empty for all 20 clubs. Ignored for Teams and Gameweeks. ## `position` (type: `string`): Limit Players to one outfield position. Leave empty for all positions. Applies to the Players data type only. ## `sortBy` (type: `string`): Order for the Players data type, highest first. Applies to the Players data type only. ## `maxItems` (type: `integer`): Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000 ## Actor input object example ```json { "dataType": "players", "team": "", "position": "", "sortBy": "totalPoints", "maxItems": 10 } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 = { "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/fpl-premier-league-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 = { "maxItems": 10 } # Run the Actor and wait for it to finish run = client.actor("parseforge/fpl-premier-league-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 '{ "maxItems": 10 }' | apify call parseforge/fpl-premier-league-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parseforge/fpl-premier-league-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Fantasy Premier League Player Stats Scraper", "description": "Pull every Fantasy Premier League player with club, position, price, total points, form, ownership percent, goals, assists, minutes, and bonus. Switch modes for teams, gameweeks, and all 380 fixtures. Built for transfer planning, captaincy calls, and mini league research.", "version": "0.1", "x-build-id": "y2qSqHPOwgMAuS539" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~fpl-premier-league-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-fpl-premier-league-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/parseforge~fpl-premier-league-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-fpl-premier-league-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/parseforge~fpl-premier-league-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-fpl-premier-league-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": { "dataType": { "title": "Data Type", "enum": [ "players", "teams", "gameweeks", "fixtures" ], "type": "string", "description": "Which Fantasy Premier League data set to pull. Players returns every footballer with price, points, form and ownership. Teams returns the 20 clubs. Gameweeks returns the season schedule with deadlines and average scores. Fixtures returns every match with kickoff time and scoreline.", "default": "players" }, "team": { "title": "Team", "enum": [ "", "Arsenal", "Aston Villa", "Bournemouth", "Brentford", "Brighton", "Burnley", "Chelsea", "Crystal Palace", "Everton", "Fulham", "Leeds", "Liverpool", "Man City", "Man Utd", "Newcastle", "Nott'm Forest", "Sunderland", "Spurs", "West Ham", "Wolves" ], "type": "string", "description": "Limit Players or Fixtures to a single club. Leave empty for all 20 clubs. Ignored for Teams and Gameweeks.", "default": "" }, "position": { "title": "Position", "enum": [ "", "GKP", "DEF", "MID", "FWD" ], "type": "string", "description": "Limit Players to one outfield position. Leave empty for all positions. Applies to the Players data type only.", "default": "" }, "sortBy": { "title": "Sort Players By", "enum": [ "totalPoints", "form", "selectedByPercent", "price", "goals", "assists" ], "type": "string", "description": "Order for the Players data type, highest first. Applies to the Players data type only.", "default": "totalPoints" }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" } } }, "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 } } } } } } } } } } ```