fminside.net APIfminside.net ↗
Access the Football Manager player database via API. Search players, browse full rosters, and retrieve detailed profiles including positions, club, and attributes.
curl -X GET 'https://api.parse.bot/scraper/e737f35d-e126-4fda-8e43-a3a67a4f722f/search_players?limit=20&query=Mbappe' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for players by name or keyword. Returns a list of matching players with their IDs, positions, and profile URLs.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of results to return. |
| queryrequired | string | Player name or search phrase. |
{
"type": "object",
"fields": {
"total": "integer total number of players returned",
"players": "array of player summary objects with name, unique_id, url, age, positions, and image_url"
},
"sample": {
"data": {
"total": 5,
"players": [
{
"age": "26",
"url": "/players/7-fm-26/85139014-kylian-mbappe",
"name": "Kylian Mbappé",
"image_url": "https://img.fminside.net/facesfm26/85139014.png",
"positions": [
"AMR",
"AML",
"ST"
],
"unique_id": "85139014"
}
]
},
"status": "success"
}
}About the fminside.net API
The FMInside API exposes 4 endpoints covering the Football Manager player database, letting you search for players by name, paginate through the full catalog, and retrieve individual profiles with fields like club, height, positions, foot ratings, and FM unique IDs. The get_player_details endpoint accepts a profile URL and returns a complete player record, while get_player_by_id lets you look up any player directly by their FM unique ID.
Search and Browse
The search_players endpoint accepts a required query string and an optional limit integer. It returns a players array of summary objects, each containing name, unique_id, url, age, positions, and image_url, along with a total count of matched results. The list_players endpoint works without a query, paginating through the full player database up to the requested limit and returning a count alongside the same summary array.
Player Profiles
get_player_details takes a relative or absolute player profile URL — obtainable from any search or list result — and returns a detailed record. Fields include full_name, club, age, height (in CM), positions (as an array of abbreviation strings), left_foot, image_url, url, and unique_id. get_player_by_id returns the identical structure using only the numeric FM unique_id, which avoids the need to construct or store profile URLs.
Data Coverage
All player records reflect the Football Manager database as indexed on fminside.net. The positions field returns abbreviations such as ST, CM, or GK, and left_foot provides a rating string for the player's non-dominant foot. The image_url field points to the player's face image hosted on the source site. Pagination in list_players continues loading results automatically until the requested limit is satisfied.
- Build a scouting tool that searches players by name and filters on positions returned in the summary array
- Populate a squad-builder UI with full player profiles including club and height from get_player_details
- Sync a local FM player database by paginating list_players to a specified limit
- Cross-reference players by FM unique_id across multiple datasets using get_player_by_id
- Display player face images in a fantasy-FM app using the image_url field from any endpoint
- Aggregate positional distribution across a club's roster using positions arrays from bulk list results
- Resolve player profile URLs to full records without storing URL patterns by using the unique_id lookup
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.