# Fminside — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and explore the Football Manager player database to find detailed profiles, stats, and information about individual players. Quickly look up players by ID or browse through the complete player catalog to discover talent, compare performance metrics, and research squad options.

**Category:** Sports | **Website:** [fminside.net/](https://fminside.net/) | **Docs:** [parse.bot/marketplace/46d2f420-f76b-4cbd-a063-440e5912f427/fminside-net-api](https://parse.bot/marketplace/46d2f420-f76b-4cbd-a063-440e5912f427/fminside-net-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-fminside-net-api-46d2f420/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_player_by_id

Retrieve the full profile for a specific player using their unique FM ID. Returns the same detailed profile as get_player_details including current/potential ability, nationality, and contract expiry. The ID is obtainable from search_players or list_players results as unique_id.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `player_id` | string | Yes | Unique FM player ID (e.g. 85139014). Obtainable from search_players or list_players results as unique_id. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fminside-net-api-46d2f420/get_player_by_id \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"player_id":"<string>"}'
```

### get_player_details

Retrieve the full profile for a specific player using their profile URL path. Returns detailed attributes (Technical, Mental, Physical, Set Pieces), positions, club, biographical info, foot preferences, current/potential ability ratings, nationality, and contract expiry. The URL is obtainable from search_players or list_players results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Relative or absolute player profile URL (e.g. /players/7-fm-26/85139014-kylian-mbappe). Obtainable from search_players or list_players results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fminside-net-api-46d2f420/get_player_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### list_clubs

Browse clubs from the FM database ordered by reputation. Supports filtering by league name. Returns club summaries with name, ID, league, logo, and reputation. Paginates internally until the requested limit is reached.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `league` | string | No | Filter by league name (e.g. 'LaLiga', 'Premier League', 'Serie A', 'Bundesliga', 'Ligue 1'). Omitting returns clubs from all leagues. |
| `limit` | integer | No | Total number of clubs to retrieve. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fminside-net-api-46d2f420/list_clubs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"league":"<string>","limit":"<integer>"}'
```

### list_players

Browse the full FM player database ordered by default site ranking. Paginates internally until the requested limit is reached. Returns player summaries with IDs, positions, age, and profile URLs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Total number of players to retrieve. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fminside-net-api-46d2f420/list_players \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### search_players

Full-text search over the FM player database by name or keyword. Returns a list of matching player summaries with IDs, positions, age, and profile URLs. The server returns only top matches for the query.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return. |
| `query` | string | Yes | Player name or search phrase. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fminside-net-api-46d2f420/search_players \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>"}'
```