Fantasy Premier League API

Does Fantasy Premier League have a public API?

Partly. The endpoints behind fantasy.premierleague.com return JSON, and developers have read the open ones for years, but the Premier League publishes no documentation, terms or support for them, and anything about your own squad requires a login session against the Premier League accounts service. Integuru's Fantasy Premier League integration provides 21 verified actions authenticated with your own FPL login, covering the reference data and your manager entry through one client that stays maintained.

| | Undocumented FPL endpoints | Integuru for Fantasy Premier League | |---|---|---| | Access | Open JSON for reference data; login cookies for your team | Your own FPL login, session managed for you | | Covers | Whatever you reverse-engineer and keep working yourself | 21 named actions with validated parameters, maintained on call | | Best for | A weekend script | A product or agent that has to work on Saturday at 11:00 |

What you can do with the Fantasy Premier League API

Reference data. list_fpl_teams returns the 20 clubs. list_fpl_gameweeks returns all 38, or only finished or only upcoming ones with finished_only; get_fpl_gameweek_status reports where the current one stands. list_fpl_fixtures filters by gameweek, team_id (1 to 20) and status (all, finished, upcoming), and get_fpl_fixture takes one fixture_id. get_fpl_game_rules returns the rules, and list_fpl_regions looks up regions by iso_code, query or region_id with a page size up to 300.

Players and points. search_fpl_players filters by a name query, position, and team given as a three-letter code, full name or FPL team id, sorted by sort_by. get_fpl_player returns one player with up to 38 upcoming_fixtures. get_fpl_gameweek_live returns live points for a gameweek, trimmed with played_only, position and team_id. get_fpl_dream_team returns a gameweek's best XI, or the season aggregate with scope: season_to_date. get_fpl_gameweek_winners and get_fpl_set_piece_notes round out the analyst's toolkit.

Your team. get_my_fpl_profile returns the signed-in account. get_fpl_manager, get_fpl_manager_history, get_fpl_manager_picks and get_fpl_manager_transfers all default to your own entry when entry_id is omitted; get_fpl_manager_picks takes a gameweek and get_fpl_manager_transfers filters by one.

Leagues. get_fpl_league_standings pages a classic league by league_id (314 is the global Overall league), get_fpl_league_cup_status reports the cup for a league, and get_fpl_game_leaderboards returns the game-wide boards.

Every paged action defaults to 20 rows and caps at 50. A gameweek outside 1 to 38 or a team_id outside 1 to 20 is rejected with a 400 that quotes the value; nothing is silently clamped, so an agent gets an honest error rather than the wrong week's data.

Transfers, captaincy and lineup changes are writes and are built on request through the Managed Service.

Who uses this

Squad assistants built on the AI agents pattern read get_fpl_manager_picks for the current week, get_fpl_player for each pick's next fixtures and get_fpl_gameweek_live on match day, and answer a question about who to captain in one turn. Mini-league bots poll get_fpl_league_standings after each gameweek and post the movers. Analytics products that once maintained their own client against undocumented endpoints move to these actions to stop repairing it after every site change. Fantasy Premier League sits alongside the other consumer platforms in the integrations catalogue.

Setup notes

Integuru authenticates against fantasy.premierleague.com with your own FPL login and manages the session with the Premier League accounts service for you. Manager actions read your own entry unless you pass another entry_id, in which case you get that entry's public data. All 21 actions are reads, so the integration can run on a schedule without touching your squad.

Get started

Install the CLI and connect your FPL login:

npm install -g integuru

Or sign in at app.integuru.com and add Fantasy Premier League. To add transfers or lineup changes, the Managed Service scopes and builds those actions against your entry.