# Transfermarkt API — football market values, transfers, squads, league tables, stats and match reports

> Quick search across Transfermarkt: players, clubs (and national teams), competitions, coaches, referees and agencies by name. Each type has its own total and pages; players come back as full profile cards (market value, club, position, age, citizenship, contract).
> ReefAPI engine `transfermarkt` · 47 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/transfermarkt/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/transfermarkt/v1/search — 2 credits
Quick search across Transfermarkt: players, clubs (and national teams), competitions, coaches, referees and agencies by name. Each type has its own total and pages; players come back as full profile cards (market value, club, position, age, citizenship, contract).

**Parameters:**
- `query` (string, required) — Name to look for (player, club, league, coach, referee or agency).
- `type` (enum, optional, default "all") — Which result type. [one of: all, player, players, club, clubs, competition, competitions, coach, coaches, referee, referees, agent, agents]
- `page` (integer, optional, default 1) — Result page (1-based). `has_more` says whether another page exists.
- `limit` (integer, optional, default 10) — How many results per type per call (1-100).
- `only_active` (boolean, optional) — Players: only living players; competitions: only running competitions.
- `national_teams` (boolean, optional) — Clubs: true = national teams only, false = clubs only.
- `only_main_clubs` (boolean, optional) — Clubs: leave out reserve and youth teams.

**Returns:** players[] / clubs[] / competitions[] / coaches[] / referees[] / agents[] + <type>_total + <type>_has_more + page + limit

**Example request body:**
```json
{
  "query": "haaland"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/advanced_search — 1 credit
Transfermarkt's advanced player search (the scouting form): filter by name, citizenship, second citizenship, country of birth, confederation, age, birth year, height, market value, main and other position, foot, captain, shirt number, competition, club country, caps, contract expiry year, league tier, national-team status, active, free agent. 25 rows per page; the site stops at 250 hits.

**Parameters:**
- `name` (string, optional) — Last name or part of it.
- `first_name` (string, optional) — First name.
- `exact_name` (boolean, optional) — Exact name match only.
- `place_of_birth` (string, optional) — Town of birth.
- `nationality` (array, optional) — Citizenship (name, FIFA code or id). One country.
- `second_nationality` (array, optional) — Second citizenship.
- `country_of_birth` (array, optional) — Country of birth.
- `club_country` (array, optional) — Country of the player's club.
- `confederation` (array, optional) — Confederation: UEFA, CONMEBOL, CONCACAF, CAF, AFC, OFC.
- `age_min` (integer, optional) — Minimum age.
- `age_max` (integer, optional) — Maximum age.
- `birth_year_min` (integer, optional) — Born in or after.
- `birth_year_max` (integer, optional) — Born in or before.
- `height_min_cm` (integer, optional) — Minimum height, cm.
- `height_max_cm` (integer, optional) — Maximum height, cm.
- `market_value_min` (integer, optional) — Minimum market value in euros (10000000 = €10m).
- `market_value_max` (integer, optional) — Maximum market value in euros.
- `position` (array, optional) — Main position (one detailed position, e.g. centre_forward, left_back).
- `other_position` (array, optional) — A side position the player also plays.
- `foot` (enum, optional) — Preferred foot. [one of: right, left, both]
- `captain` (boolean, optional) — Only captains.
- `shirt_number` (integer, optional) — Shirt number.
- `competition_id` (string, optional) — Competition code of the player's club.
- `caps_min` (integer, optional) — Minimum international caps.
- `caps_max` (integer, optional) — Maximum international caps (1 or more; for never-capped players use national_team_status=never).
- `contract_expires` (array, optional) — Contract end year(s).
- `league_tier` (array, optional) — first_tier, second_tier, third_tier, fourth_tier, fifth_tier.
- `national_team_status` (array, optional) — current, former, retired, never.
- `active_only` (boolean, optional) — Only active players.
- `free_agents_only` (boolean, optional) — Only players without a club.
- `page` (integer, optional, default 1) — Page 1-10 (25 rows each).

**Returns:** players[]{player_id, player_name, position, date_of_birth, age, nationalities[], club_id, club_name, competition_id, competition_name, other_positions[], height_m, national_team_id, national_team_name, national_team_status, international_matches, market_value_eur, market_value_display} + total (the site's 'Hits') + page + last_page + has_more

**Example request body:**
```json
{
  "name": "silva"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/player — 2 credits
One player's full Transfermarkt profile: name, name in home country, date and place of birth, citizenship, height, foot, position and other positions, current club (joined, shirt number, captain), contract expiry, last contract extension, contract option, player agent, outfitter, market value with its last update, previous value, change and highest value ever, national team, loan source and loan contract, social media links and every fact the profile page prints.

**Parameters:**
- `player_id` (string, required) — Transfermarkt player id (418560 = Erling Haaland), a transfermarkt.com player URL, or a player name (the best quick-search match is used and reported in `resolved_from`).

**Returns:** player{player_id, name, …, market_value_eur, market_value_display, market_value_last_update, highest_market_value_eur, highest_market_value_date, current_club{club_id, club_name, joined, shirt_number}, contract_expires, player_agent{agent_id, name, …}, citizenship[], social_media[], on_loan_from, international_caps, international_goals, profile_page_facts{label: value}}

**Example request body:**
```json
{
  "player_id": "418560"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/player_market_value — 2 credits
A player's market value over time as Transfermarkt publishes it: every valuation with its date, the club and age at that moment; current value, highest and lowest value with dates, and the player's rank among all players by market value.

**Parameters:**
- `player_id` (string, required) — Transfermarkt player id (418560 = Erling Haaland), a transfermarkt.com player URL, or a player name (the best quick-search match is used and reported in `resolved_from`).

**Returns:** player_id, player_name, market_value_eur, market_value_display, market_value_last_update, highest_market_value_eur/_date, lowest_market_value_eur/_date, market_value_rank_worldwide, points[]{date, market_value_eur, market_value_display, club_id, club_name, age, season_id}

**Example request body:**
```json
{
  "player_id": "418560"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/player_transfers — 2 credits
A player's full transfer history: every move with date, season, from and to club (with league, country and coach at the time), the fee as Transfermarkt prints it ('€60.00M', 'free transfer', 'loan transfer', '-', '?') and in euros, market value at the time, transfer type (standard, loan, end of loan), contract length; announced future transfers separately; total fees.

**Parameters:**
- `player_id` (string, required) — Transfermarkt player id (418560 = Erling Haaland), a transfermarkt.com player URL, or a player name (the best quick-search match is used and reported in `resolved_from`).

**Returns:** transfers[]{transfer_id, date, season, from{club_id, club_name, competition_id, competition_name, country, coach_name}, to{…}, fee_eur, fee_display, market_value_eur, market_value_display, type, contract_until, age_at_transfer, url} + upcoming_transfers[] + total_fees_eur

**Example request body:**
```json
{
  "player_id": "418560"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/player_stats — 2 credits
A player's performance statistics, by season × competition × club (default), by competition, by club or by coach: appearances, starts, minutes, goals, assists, own goals, penalties scored/missed (and saved for goalkeepers), yellow / second-yellow / red cards, subbed on/off, team goals while on the pitch; career totals.

**Parameters:**
- `player_id` (string, required) — Transfermarkt player id (418560 = Erling Haaland), a transfermarkt.com player URL, or a player name (the best quick-search match is used and reported in `resolved_from`).
- `season` (string, optional) — The year the season starts, as Transfermarkt numbers it (2025 = 2025/26; '25/26' and '2025/26' are accepted). Leave out for the current season. For calendar-year competitions the site labels season 2025 as '2026'.
- `group_by` (enum, optional, default "season") — How rows are grouped. [one of: season, competition, club, coach]
- `competition_ids` (array, optional) — Only these competitions.
- `club_ids` (array, optional) — Only these clubs.
- `national_team` (boolean, optional) — true = only national-team games, false = only club games.

**Returns:** rows[]{season, season_id, competition_id, competition_name, club_id, club_name, coach_id, coach_name, appearances_count, goals_sum, assists_sum, played_minutes_sum, starting_count, yellow_card_gross_sum, red_cards_count, …} + totals

**Example request body:**
```json
{
  "player_id": "418560"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/player_matches — 2 credits
A player's match-by-match log for a season (default: current): every game with date, competition, match day, both teams and score, shirt number, position, minutes, goals, assists, cards, subbed on/off, captaincy, and why he did not play (injured, not in squad, …). Newest first.

**Parameters:**
- `player_id` (string, required) — Transfermarkt player id (418560 = Erling Haaland), a transfermarkt.com player URL, or a player name (the best quick-search match is used and reported in `resolved_from`).
- `season` (string, optional) — The year the season starts, as Transfermarkt numbers it (2025 = 2025/26; '25/26' and '2025/26' are accepted). Leave out for the current season. For calendar-year competitions the site labels season 2025 as '2026'.
- `competition_ids` (array, optional) — Only these.
- `club_ids` (array, optional) — Only for these clubs.
- `status` (array, optional) — played, in_squad, not_in_squad, injured, absent, other_team.
- `date_from` (string, optional) — From date, YYYY-MM-DD.
- `date_to` (string, optional) — To date, YYYY-MM-DD.
- `national_team` (boolean, optional) — Only national-team (true) or club (false) games.
- `page` (integer, optional, default 1) — Result page (1-based). `has_more` says whether another page exists.
- `limit` (integer, optional, default 50) — How many matches per call (1-200).

**Returns:** matches[]{game_id, date_utc, competition_id, competition_name, club{club_id, club_name, venue, goals_total, …}, opponent{…}, participation_state, played_minutes, goals_scored_total, assists, …} + page + limit + total + has_more

**Example request body:**
```json
{
  "player_id": "418560"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/player_injuries — 2 credits
A player's injury history (injury, from, until, days out, games missed) and his other absences (suspensions for cards, national-team call-ups, illness) with the competition.

**Parameters:**
- `player_id` (string, required) — Transfermarkt player id (418560 = Erling Haaland), a transfermarkt.com player URL, or a player name (the best quick-search match is used and reported in `resolved_from`).
- `only_current` (boolean, optional, default false) — Only injuries/absences still running.

**Returns:** injuries[]{name, category, start, end, days, missed_games, season} + absences[]{name, competition_name, start, end, days, missed_games} + totals

**Example request body:**
```json
{
  "player_id": "418560"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/player_national_team — 2 credits
A player's national-team career: every national team (senior and youth) with caps, goals, shirt number, debut date, debut coach, last game, and whether he is a current international.

**Parameters:**
- `player_id` (string, required) — Transfermarkt player id (418560 = Erling Haaland), a transfermarkt.com player URL, or a player name (the best quick-search match is used and reported in `resolved_from`).

**Returns:** national_teams[]{national_team_id, national_team_name, games_played, goals_scored, shirt_number, debut, debut_coach_name, last_game, career_state, debut_match_url}

**Example request body:**
```json
{
  "player_id": "418560"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/player_achievements — 2 credits
A player's titles and individual awards: every title with season, club or national team, competition; counts per title; club / international / individual totals.

**Parameters:**
- `player_id` (string, required) — Transfermarkt player id (418560 = Erling Haaland), a transfermarkt.com player URL, or a player name (the best quick-search match is used and reported in `resolved_from`).

**Returns:** achievements[]{name, season, club_id, club_name, competition_id, competition_name} + by_title[] + summary{club_titles, international_titles, individual_awards}

**Example request body:**
```json
{
  "player_id": "418560"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/player_rumors — 2 credits
Transfer rumours about one player from Transfermarkt's rumour mill: active rumours and the full archive (paged), each with current and interested club, the user-rated probability and its trend, the sources (link and quoted text) and the dates.

**Parameters:**
- `player_id` (string, required) — Transfermarkt player id (418560 = Erling Haaland), a transfermarkt.com player URL, or a player name (the best quick-search match is used and reported in `resolved_from`).
- `page` (integer, optional, default 1) — Result page (1-based). `has_more` says whether another page exists.
- `limit` (integer, optional, default 25) — How many archived rumours per call (1-100).

**Returns:** active_rumors[] + historic_rumors[]{id, current_club_name, rumored_club_name, probabilities{probability, trend, history[]}, sources[]{url, text, creation_date}, creation_date, last_post_date, is_rumor_closed} + historic_paging{page, limit, total, has_more}

**Example request body:**
```json
{
  "player_id": "418560"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/player_squad_numbers — 1 credit
Every shirt number a player wore, per season, for each club and national team.

**Parameters:**
- `player_id` (string, required) — Transfermarkt player id (418560 = Erling Haaland), a transfermarkt.com player URL, or a player name (the best quick-search match is used and reported in `resolved_from`).

**Returns:** squad_numbers[]{scope (club|national_team), season, club_id, club_name, shirt_number}

**Example request body:**
```json
{
  "player_id": "418560"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/player_upcoming_matches — 1 credit
The coming (and the most recent) games of a player's club and national team, as the profile page's match slider lists them: kick-off, competition, match day, both teams, result, and whether the player is injured or suspended for it.

**Parameters:**
- `player_id` (string, required) — Transfermarkt player id (418560 = Erling Haaland), a transfermarkt.com player URL, or a player name (the best quick-search match is used and reported in `resolved_from`).
- `limit` (integer, optional, default 10) — How many games per list per call (1-50).

**Returns:** upcoming[]{game_id, kickoff_utc, competition_id, competition_name, match_day, home_team_name, away_team_name, state, player_injury, player_suspension, match_report_url} + recent[]{… result}

**Example request body:**
```json
{
  "player_id": "418560"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/club — 2 credits
One club's profile: official name, country, league, squad size, average age, total squad market value (and average, top-18 share, transfer spend of the squad), address, colours, former names, stadium (capacity, build year, pitch size, address, photos), the current manager and the full staff (coaches, medical, scouts, board) with roles and contracts.

**Parameters:**
- `club_id` (string, required) — Transfermarkt club id (281 = Manchester City; national teams are clubs too, 3440 = Norway), a club URL, or a club name (best quick-search match, see `resolved_from`).

**Returns:** club{club_id, name, official_name, country, primary_competition_id, primary_competition_name, squad_size, average_age, total_market_value_eur, total_market_value_display, stadium{…}, manager{…}, staff[]{name, role, category, contract_until, …}}

**Example request body:**
```json
{
  "club_id": "281"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/club_squad — 2 credits
A club's squad for a season (default current): every player as a full card — shirt number, captain, position, age, citizenship, height, foot, market value, joined date, contract expiry, agent — plus the squad's total market value as Transfermarkt prints it.

**Parameters:**
- `club_id` (string, required) — Transfermarkt club id (281 = Manchester City; national teams are clubs too, 3440 = Norway), a club URL, or a club name (best quick-search match, see `resolved_from`).
- `season` (string, optional) — The year the season starts, as Transfermarkt numbers it (2025 = 2025/26; '25/26' and '2025/26' are accepted). Leave out for the current season. For calendar-year competitions the site labels season 2025 as '2026'.

**Returns:** players[]{player card + shirt_number, is_captain} + total_market_value_eur + sum_of_player_market_values_eur + count

**Example request body:**
```json
{
  "club_id": "281"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/club_squad_stats — 1 credit
A club's squad statistics table for a season (default current): per player in squad, appearances, goals, assists, cards, subbed on/off, points per game, minutes played.

**Parameters:**
- `club_id` (string, required) — Transfermarkt club id (281 = Manchester City; national teams are clubs too, 3440 = Norway), a club URL, or a club name (best quick-search match, see `resolved_from`).
- `season` (string, optional) — The year the season starts, as Transfermarkt numbers it (2025 = 2025/26; '25/26' and '2025/26' are accepted). Leave out for the current season. For calendar-year competitions the site labels season 2025 as '2026'.

**Returns:** players[]{player_id, player_name, position, age, nationalities[], in_squad, appearances, goals, assists, yellow_cards, second_yellow_cards, red_cards, substitutions_on, substitutions_off, points_per_game, minutes_played} + columns[]

**Example request body:**
```json
{
  "club_id": "281"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/club_transfers — 3 credits
A club's transfers in a season (default current): arrivals and departures with player, other club, fee and market value, and the season's expenditure, income and balance as Transfermarkt sums them.

**Parameters:**
- `club_id` (string, required) — Transfermarkt club id (281 = Manchester City; national teams are clubs too, 3440 = Norway), a club URL, or a club name (best quick-search match, see `resolved_from`).
- `season` (string, optional) — The year the season starts, as Transfermarkt numbers it (2025 = 2025/26; '25/26' and '2025/26' are accepted). Leave out for the current season. For calendar-year competitions the site labels season 2025 as '2026'.

**Returns:** arrivals[] + departures[] (transfer rows) + upcoming_arrivals[] + upcoming_departures[] + expenditure_eur + income_eur + balance_eur

**Example request body:**
```json
{
  "club_id": "281"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/club_fixtures — 2 credits
A club's fixtures and results for a season (default current), all competitions: date, competition, round, opponent, score, result, attendance.

**Parameters:**
- `club_id` (string, required) — Transfermarkt club id (281 = Manchester City; national teams are clubs too, 3440 = Norway), a club URL, or a club name (best quick-search match, see `resolved_from`).
- `season` (string, optional) — The year the season starts, as Transfermarkt numbers it (2025 = 2025/26; '25/26' and '2025/26' are accepted). Leave out for the current season. For calendar-year competitions the site labels season 2025 as '2026'.

**Returns:** games[]{game_id, date_utc, competition_name, game_day, round, home_club_name, away_club_name, home_goals, away_goals, result_for_club, attendance, match_report_url}

**Example request body:**
```json
{
  "club_id": "281"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/club_achievements — 1 credit
Every trophy a club won, by season, with counts per title.

**Parameters:**
- `club_id` (string, required) — Transfermarkt club id (281 = Manchester City; national teams are clubs too, 3440 = Norway), a club URL, or a club name (best quick-search match, see `resolved_from`).

**Returns:** achievements[]{trophy_name, season} + by_title[]

**Example request body:**
```json
{
  "club_id": "281"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/club_rumors — 2 credits
Active transfer rumours about a club: incoming and outgoing players, probability, sources.

**Parameters:**
- `club_id` (string, required) — Transfermarkt club id (281 = Manchester City; national teams are clubs too, 3440 = Norway), a club URL, or a club name (best quick-search match, see `resolved_from`).

**Returns:** incoming[] + outgoing[] (rumour rows with player_name, current_club_name, rumored_club_name, probabilities, sources)

**Example request body:**
```json
{
  "club_id": "281"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/club_history — 1 credit
A club's league placement in every season: league, level, W/D/L, goals, points, rank, manager.

**Parameters:**
- `club_id` (string, required) — Transfermarkt club id (281 = Manchester City; national teams are clubs too, 3440 = Norway), a club URL, or a club name (best quick-search match, see `resolved_from`).

**Returns:** seasons[]{season, competition_id, competition_name, league_level, wins, draws, losses, goals_for, goals_against, goal_difference, points, rank, coach_name}

**Example request body:**
```json
{
  "club_id": "281"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/club_transfer_records — 1 credit
A club's record signings (arrivals) or record sales (departures), all time or one season, ranked by fee.

**Parameters:**
- `club_id` (string, required) — Transfermarkt club id (281 = Manchester City; national teams are clubs too, 3440 = Norway), a club URL, or a club name (best quick-search match, see `resolved_from`).
- `season` (string, optional) — Only transfers of this season (the year it starts: 2024 = 2024/25; '24/25' is accepted). Leave out for all-time records.
- `direction` (enum, optional, default "arrivals") — Signings or sales. [one of: arrivals, departures]
- `page` (integer, optional, default 1)

**Returns:** transfers[]{rank, player_id, player_name, position, age_at_transfer, nationalities[], season, left_club_name | joined_club_name, fee_eur, fee_display, transfer_id} + page + last_page

**Example request body:**
```json
{
  "club_id": "281"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/club_national_players — 1 credit
Players of a club who play for a national team (senior and youth), with caps and goals.

**Parameters:**
- `club_id` (string, required) — Transfermarkt club id (281 = Manchester City; national teams are clubs too, 3440 = Norway), a club URL, or a club name (best quick-search match, see `resolved_from`).

**Returns:** players[]{section, player_id, player_name, position, age, national_team_name, appearances, goals}

**Example request body:**
```json
{
  "club_id": "281"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/competition — 2 credits
A league or cup: country, confederation, tier, current season, number of match days, total market value, and every club in it for a season with squad size, average age and total squad market value.

**Parameters:**
- `competition_id` (string, required) — Transfermarkt competition code (GB1 Premier League, ES1 LaLiga, L1 Bundesliga, IT1 Serie A, FR1 Ligue 1, CL Champions League, FIWC World Cup), a competition URL, or a name (best quick-search match, see `resolved_from`).
- `season` (string, optional) — The year the season starts, as Transfermarkt numbers it (2025 = 2025/26; '25/26' and '2025/26' are accepted). Leave out for the current season. For calendar-year competitions the site labels season 2025 as '2026'.

**Returns:** competition{competition_id, name, country, confederation, type, current_season_id, total_market_value_eur, clubs[]{club card}, club_count}

**Example request body:**
```json
{
  "competition_id": "GB1"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/competition_list — 2 credits
Leagues and cups ranked by total market value, filterable by confederation, country and tier (first tier, second tier, cups, …).

**Parameters:**
- `confederation` (array, optional) — Confederation: UEFA, CONMEBOL, CONCACAF, CAF, AFC, OFC.
- `country` (array, optional) — Country name, FIFA code or id.
- `tier` (array, optional) — Competition type: first_tier, second_tier, … (see reference_data type=competition_types).
- `limit` (integer, optional, default 50) — How many rows per call (1-100).

**Returns:** competitions[]{competition card + rank_by_market_value}

**Example request body:**
```json
{
  "confederation": [
    "UEFA"
  ]
}
```

### POST https://api.reefapi.com/transfermarkt/v1/competition_table — 2 credits
League table for a season (default current), overall or home / away, optionally after a given match day; group tables for cups.

**Parameters:**
- `competition_id` (string, required) — Transfermarkt competition code (GB1 Premier League, ES1 LaLiga, L1 Bundesliga, IT1 Serie A, FR1 Ligue 1, CL Champions League, FIWC World Cup), a competition URL, or a name (best quick-search match, see `resolved_from`).
- `season` (string, optional) — The year the season starts, as Transfermarkt numbers it (2025 = 2025/26; '25/26' and '2025/26' are accepted). Leave out for the current season. For calendar-year competitions the site labels season 2025 as '2026'.
- `venue` (enum, optional, default "all") — Which games count. [one of: all, home, away]
- `game_day` (integer, optional) — Table after this match day.

**Returns:** tables[]{name, rows[]{rank, previous_rank, movement, club_id, club_name, played, wins, draws, losses, goals_for, goals_against, goal_difference, points, zone}} + zones[]

**Example request body:**
```json
{
  "competition_id": "GB1"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/competition_fixtures — 2 credits
All fixtures and results of a competition season, or one match day.

**Parameters:**
- `competition_id` (string, required) — Transfermarkt competition code (GB1 Premier League, ES1 LaLiga, L1 Bundesliga, IT1 Serie A, FR1 Ligue 1, CL Champions League, FIWC World Cup), a competition URL, or a name (best quick-search match, see `resolved_from`).
- `season` (string, optional) — The year the season starts, as Transfermarkt numbers it (2025 = 2025/26; '25/26' and '2025/26' are accepted). Leave out for the current season. For calendar-year competitions the site labels season 2025 as '2026'.
- `game_day` (integer, optional) — Only this match day.

**Returns:** games[]{game_id, date_utc, game_day, home_club_name, away_club_name, home_goals, away_goals, attendance, match_report_url} + game_days[]

**Example request body:**
```json
{
  "competition_id": "GB1"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/competition_transfers — 3 credits
Every transfer involving a league's clubs in a season, sorted by date or fee, arrivals and departures, paged.

**Parameters:**
- `competition_id` (string, required) — Transfermarkt competition code (GB1 Premier League, ES1 LaLiga, L1 Bundesliga, IT1 Serie A, FR1 Ligue 1, CL Champions League, FIWC World Cup), a competition URL, or a name (best quick-search match, see `resolved_from`).
- `season` (string, optional) — The year the season starts, as Transfermarkt numbers it (2025 = 2025/26; '25/26' and '2025/26' are accepted). Leave out for the current season. For calendar-year competitions the site labels season 2025 as '2026'.
- `sort` (enum, optional, default "date") [one of: date, fee]
- `order` (enum, optional, default "desc") [one of: desc, asc]
- `direction` (enum, optional, default "all") [one of: all, arrivals, departures]
- `page` (integer, optional, default 1) — Result page (1-based). `has_more` says whether another page exists.
- `limit` (integer, optional, default 50) — How many transfers per call (1-100).

**Returns:** transfers[] (transfer rows with player, from/to club, fee) + page + limit + total + has_more + fee_sum_eur

**Example request body:**
```json
{
  "competition_id": "GB1"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/competition_rumors — 2 credits
Latest transfer rumours about a league's clubs, newest first (25 per page).

**Parameters:**
- `competition_id` (string, required) — Transfermarkt competition code (GB1 Premier League, ES1 LaLiga, L1 Bundesliga, IT1 Serie A, FR1 Ligue 1, CL Champions League, FIWC World Cup), a competition URL, or a name (best quick-search match, see `resolved_from`).
- `page` (integer, optional, default 1)
- `limit` (integer, optional, default 25) — How many rumours per call (1-25).

**Returns:** rumors[] + page + has_more

**Example request body:**
```json
{
  "competition_id": "GB1"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/competition_champions — 2 credits
Every champion of a competition by season, and titles per club.

**Parameters:**
- `competition_id` (string, required) — Transfermarkt competition code (GB1 Premier League, ES1 LaLiga, L1 Bundesliga, IT1 Serie A, FR1 Ligue 1, CL Champions League, FIWC World Cup), a competition URL, or a name (best quick-search match, see `resolved_from`).

**Returns:** champions[]{season, club_id, club_name, title} + titles_by_club[]

**Example request body:**
```json
{
  "competition_id": "GB1"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/top_scorers — 2 credits
Top players by goals, assists, goals + assists or clean sheets — in one or more competitions, for a season or a span of seasons, filterable by position, citizenship, age and club.

**Parameters:**
- `stat` (enum, optional, default "goals") [one of: goals, assists, goals_and_assists, scorers, clean_sheets]
- `competition_ids` (array, optional) — Only players at clubs in these competitions (codes, e.g. GB1, ES1).
- `season` (string, optional) — The year the season starts, as Transfermarkt numbers it (2025 = 2025/26; '25/26' and '2025/26' are accepted). Leave out for the current season. For calendar-year competitions the site labels season 2025 as '2026'.
- `season_from` (string, optional) — First season of a span (2020 or 20/21).
- `season_to` (string, optional) — Last season of a span (2024 or 24/25).
- `position` (array, optional) — Position filter: a group (goalkeeper, defender, midfielder, forward) or a detailed position (centre_back, left_back, right_back, defensive_midfield, central_midfield, attacking_midfield, left_midfield, right_midfield, left_winger, right_winger, second_striker, centre_forward, sweeper). Several are allowed.
- `nationality` (array, optional) — Citizenship: country name, FIFA code (NOR) or Transfermarkt country id (125). Several are allowed.
- `club_ids` (array, optional) — Only players of these clubs (club ids).
- `age_min` (integer, optional) — Minimum age.
- `age_max` (integer, optional) — Maximum age.
- `limit` (integer, optional, default 25) — How many players per call (1-100).

**Returns:** players[]{rank, player card, goals_count, assists_count, scorers_count, appearances_count, total_minutes_played, by_competition[]}

**Example request body:**
```json
{
  "competition_ids": [
    "GB1"
  ]
}
```

### POST https://api.reefapi.com/transfermarkt/v1/latest_transfers — 3 credits
The newest transfers worldwide (Transfermarkt's transfer ticker), filterable by league, from/to league, from/to country, confederation, position, citizenship, age and market value.

**Parameters:**
- `competition_ids` (array, optional) — Only players at clubs in these competitions (codes, e.g. GB1, ES1).
- `from_competition_ids` (array, optional) — Leaving these leagues.
- `to_competition_ids` (array, optional) — Joining these leagues.
- `from_country` (array, optional) — Leaving clubs of these countries.
- `to_country` (array, optional) — Joining clubs of these countries.
- `confederation` (array, optional) — Confederation: UEFA, CONMEBOL, CONCACAF, CAF, AFC, OFC.
- `position` (array, optional) — Position filter: a group (goalkeeper, defender, midfielder, forward) or a detailed position (centre_back, left_back, right_back, defensive_midfield, central_midfield, attacking_midfield, left_midfield, right_midfield, left_winger, right_winger, second_striker, centre_forward, sweeper). Several are allowed.
- `nationality` (array, optional) — Citizenship: country name, FIFA code (NOR) or Transfermarkt country id (125). Several are allowed.
- `age_min` (integer, optional) — Minimum age.
- `age_max` (integer, optional) — Maximum age.
- `market_value_min` (integer, optional) — Minimum market value in euros (10000000 = €10m).
- `market_value_max` (integer, optional) — Maximum market value in euros.
- `limit` (integer, optional, default 50) — How many rows per call (1-100).

**Returns:** transfers[] (transfer rows with player_name, player_position, from/to, fee_eur, fee_display, market_value_eur, date)

**Example request body:**
```json
{
  "limit": 25
}
```

### POST https://api.reefapi.com/transfermarkt/v1/record_transfers — 2 credits
The most expensive transfers ever (or of one season), 25 per page: player, season, clubs, fee; filterable by citizenship, position, age group, birth year, loans and transfer window.

**Parameters:**
- `season` (string, optional) — Only transfers of this season (the year it starts: 2024 = 2024/25; '24/25' is accepted). Leave out for all-time records.
- `nationality` (array, optional) — One citizenship.
- `position` (array, optional) — A group (forward, …) or a detailed position.
- `age_group` (string, optional) — u15 … u23, 23-30, o30, o32, o34, o36.
- `birth_year` (integer, optional)
- `loans` (enum, optional, default "include") [one of: include, only, exclude_previous_loan]
- `window` (enum, optional, default "any") [one of: any, summer, winter]
- `page` (integer, optional, default 1)

**Returns:** transfers[]{rank, player_id, player_name, position, season, nationalities[], fee_eur, fee_display, transfer_id, from{…}, to{…}, date, market_value_at_transfer_eur} + page + last_page

**Example request body:**
```json
{
  "season": "2024"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/latest_rumors — 1 credit
The latest transfer rumours worldwide from Transfermarkt's rumour mill.

**Parameters:**
- `page` (integer, optional, default 1)

**Returns:** rumors[]{player_id, player_name, position, age, nationalities[], current_club_name, interested_club_name, last_reply, user_assessment_percent, thread_url} + page + last_page

### POST https://api.reefapi.com/transfermarkt/v1/most_valuable_players — 2 credits
Players ranked by market value, filterable by league, club, position, citizenship, confederation, age, birth year and market-value range. Up to 100 per call; follow `next_cursor` to go further down the list.

**Parameters:**
- `competition_ids` (array, optional) — Only players at clubs in these competitions (codes, e.g. GB1, ES1).
- `club_ids` (array, optional) — Only players of these clubs (club ids).
- `position` (array, optional) — Position filter: a group (goalkeeper, defender, midfielder, forward) or a detailed position (centre_back, left_back, right_back, defensive_midfield, central_midfield, attacking_midfield, left_midfield, right_midfield, left_winger, right_winger, second_striker, centre_forward, sweeper). Several are allowed.
- `nationality` (array, optional) — Citizenship: country name, FIFA code (NOR) or Transfermarkt country id (125). Several are allowed.
- `confederation` (array, optional) — Confederation: UEFA, CONMEBOL, CONCACAF, CAF, AFC, OFC.
- `age_min` (integer, optional) — Minimum age.
- `age_max` (integer, optional) — Maximum age.
- `birth_year_min` (integer, optional) — Born in this year or later.
- `birth_year_max` (integer, optional) — Born in this year or earlier.
- `market_value_min` (integer, optional) — Minimum market value in euros (10000000 = €10m).
- `market_value_max` (integer, optional) — Maximum market value in euros.
- `limit` (integer, optional, default 50) — How many rows per call (1-100).
- `cursor` (string, optional) — `next_cursor` of the previous call.

**Returns:** players[] (full player cards) + next_cursor + has_more

**Example request body:**
```json
{
  "limit": 25
}
```

### POST https://api.reefapi.com/transfermarkt/v1/most_valuable_clubs — 2 credits
Clubs (or national teams) ranked by total squad market value, by league, country or confederation.

**Parameters:**
- `competition_ids` (array, optional) — Only players at clubs in these competitions (codes, e.g. GB1, ES1).
- `country` (array, optional) — Country name, FIFA code or id.
- `confederation` (array, optional) — Confederation: UEFA, CONMEBOL, CONCACAF, CAF, AFC, OFC.
- `national_teams` (boolean, optional) — true = national teams only.
- `limit` (integer, optional, default 50) — How many rows per call (1-100).

**Returns:** clubs[]{rank, club card}

**Example request body:**
```json
{
  "competition_ids": [
    "GB1"
  ]
}
```

### POST https://api.reefapi.com/transfermarkt/v1/free_agents — 1 credit
Players without a club, by market value: position, citizenship, age, last club and league, without a contract since.

**Parameters:**
- `position` (array, optional) — Position filter: a group (goalkeeper, defender, midfielder, forward) or a detailed position (centre_back, left_back, right_back, defensive_midfield, central_midfield, attacking_midfield, left_midfield, right_midfield, left_winger, right_winger, second_striker, centre_forward, sweeper). Several are allowed.
- `nationality` (array, optional) — Citizenship: country name, FIFA code (NOR) or Transfermarkt country id (125). Several are allowed.
- `age_min` (integer, optional) — Minimum age.
- `age_max` (integer, optional) — Maximum age.
- `market_value_min` (integer, optional) — Minimum market value in euros (10000000 = €10m).
- `market_value_max` (integer, optional) — Maximum market value in euros.
- `last_competition_ids` (array, optional) — League of the last club.
- `free_since_from` (string, optional) — Without contract since, from (YYYY-MM-DD).
- `free_since_to` (string, optional) — Without contract since, to (YYYY-MM-DD).
- `limit` (integer, optional, default 50) — How many rows per call (1-100).

**Returns:** players[]{player_id, name, market_value_eur, age, position, citizenship[], last_club_name, last_competition_name, free_agent_since}

**Example request body:**
```json
{
  "position": [
    "centre_forward"
  ]
}
```

### POST https://api.reefapi.com/transfermarkt/v1/expiring_contracts — 2 credits
Players whose contract ends in a given year (default: next summer), by league, position, citizenship and age, highest market value first.

**Parameters:**
- `contract_end_year` (integer, optional)
- `competition_ids` (array, optional) — Only players at clubs in these competitions (codes, e.g. GB1, ES1).
- `position` (array, optional) — Position filter: a group (goalkeeper, defender, midfielder, forward) or a detailed position (centre_back, left_back, right_back, defensive_midfield, central_midfield, attacking_midfield, left_midfield, right_midfield, left_winger, right_winger, second_striker, centre_forward, sweeper). Several are allowed.
- `nationality` (array, optional) — Citizenship: country name, FIFA code (NOR) or Transfermarkt country id (125). Several are allowed.
- `age_min` (integer, optional) — Minimum age.
- `age_max` (integer, optional) — Maximum age.
- `limit` (integer, optional, default 50) — How many rows per call (1-100).

**Returns:** players[] (player cards + contract_expires)

**Example request body:**
```json
{
  "contract_end_year": 2027
}
```

### POST https://api.reefapi.com/transfermarkt/v1/market_value_updates — 2 credits
The newest market-value updates (players Transfermarkt just revalued) with the new value and date, filterable by league, position, age and value.

**Parameters:**
- `competition_ids` (array, optional) — Only players at clubs in these competitions (codes, e.g. GB1, ES1).
- `position` (array, optional) — Position filter: a group (goalkeeper, defender, midfielder, forward) or a detailed position (centre_back, left_back, right_back, defensive_midfield, central_midfield, attacking_midfield, left_midfield, right_midfield, left_winger, right_winger, second_striker, centre_forward, sweeper). Several are allowed.
- `nationality` (array, optional) — Citizenship: country name, FIFA code (NOR) or Transfermarkt country id (125). Several are allowed.
- `confederation` (array, optional) — Confederation: UEFA, CONMEBOL, CONCACAF, CAF, AFC, OFC.
- `age_min` (integer, optional) — Minimum age.
- `age_max` (integer, optional) — Maximum age.
- `birth_year_min` (integer, optional) — Born in this year or later.
- `birth_year_max` (integer, optional) — Born in this year or earlier.
- `market_value_min` (integer, optional) — Minimum market value in euros (10000000 = €10m).
- `market_value_max` (integer, optional) — Maximum market value in euros.
- `limit` (integer, optional, default 50) — How many rows per call (1-100).

**Returns:** players[] (player cards + new_market_value_eur, updated_on)

**Example request body:**
```json
{
  "competition_ids": [
    "GB1"
  ]
}
```

### POST https://api.reefapi.com/transfermarkt/v1/coach — 2 credits
A coach's profile and career: every post (club, role, appointed, until, days), current post, average tenure, licence, preferred formation and formations used.

**Parameters:**
- `coach_id` (string, required) — Transfermarkt coach id (5672 = Pep Guardiola), a coach URL, or a name.

**Returns:** coach{coach_id, name, date_of_birth, citizenship[], license, career[]{club_name, role, appointed, until, days_in_post}, preferred_formation, formations[]}

**Example request body:**
```json
{
  "coach_id": "5672"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/coach_stats — 2 credits
A coach's record per club, season and competition: games, wins, draws, losses, points per game, goals, cards.

**Parameters:**
- `coach_id` (string, required) — Transfermarkt coach id (5672 = Pep Guardiola), a coach URL, or a name.
- `season` (string, optional) — The year the season starts, as Transfermarkt numbers it (2025 = 2025/26; '25/26' and '2025/26' are accepted). Leave out for the current season. For calendar-year competitions the site labels season 2025 as '2026'.
- `competition_ids` (array, optional) — Only these competitions.
- `club_ids` (array, optional) — Only these clubs.
- `national_team` (boolean, optional) — Only national-team (true) or club (false) games.

**Returns:** rows[]{season, club_name, competition_name, games_count, wins, draws, losses, points, average_points_per_game, team_goals_total, opponent_goals_total} + totals

**Example request body:**
```json
{
  "coach_id": "5672"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/coach_achievements — 2 credits
Every title and award a coach won.

**Parameters:**
- `coach_id` (string, required) — Transfermarkt coach id (5672 = Pep Guardiola), a coach URL, or a name.

**Returns:** achievements[] + by_title[] + summary

**Example request body:**
```json
{
  "coach_id": "5672"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/referee — 1 credit
A referee's profile: name, date of birth, citizenship.

**Parameters:**
- `referee_id` (string, required) — Transfermarkt referee id or a referee URL (/schiedsrichter/<id>).

**Returns:** referee{referee_id, name, date_of_birth, citizenship[]}

**Example request body:**
```json
{
  "referee_id": "57"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/match — 3 credits
A match report: competition, round, date, stadium (with capacity and address), attendance, referee and assistants, coaches, formations, both line-ups and benches with each player's market value, every event (goals, cards, substitutions) with minute and players, score, and player availability.

**Parameters:**
- `game_id` (string, required) — Transfermarkt match id: `game_id` from fixtures / match logs, or a match-report URL (/spielbericht/<id>).

**Returns:** match{game_id, base_details, extended_details{crowd_size, …}, home_club{club_name, tactic, lineup{players[], substitutes[], market_values}}, away_club{…}, coaches, score, actions[]{type, minute, club_name, active_player_name, passive_player_name, action_name, action_reason_name}, referee_ids{…}, stadium{…}, competition{…}}

**Example request body:**
```json
{
  "game_id": "4504590"
}
```

### POST https://api.reefapi.com/transfermarkt/v1/news — 1 credit
Transfermarkt news about a player, club, competition, coach, referee or match (or the latest overall), with headline, teaser and link, paged.

**Parameters:**
- `player_id` (string, optional) — Player id/URL/name.
- `club_id` (string, optional) — Club id/URL/name.
- `competition_id` (string, optional) — Competition code/URL/name.
- `coach_id` (string, optional) — Coach id/URL/name.
- `referee_id` (string, optional) — Referee id/URL.
- `game_id` (string, optional) — Match id/URL.
- `page` (integer, optional, default 1)
- `limit` (integer, optional, default 20) — How many news per call (1-100).

**Returns:** news[]{id, headline, overline, text_preview, published_at, url, photo} + page + max_page + has_more

**Example request body:**
```json
{
  "limit": 20
}
```

### POST https://api.reefapi.com/transfermarkt/v1/fifa_ranking — 1 credit
The FIFA men's world ranking as Transfermarkt lists it: rank, previous rank, points, confederation; current or at a past date.

**Parameters:**
- `date` (string, optional) — Ranking date YYYY-MM-DD (leave out for the current one).
- `confederation` (array, optional) — Confederation: UEFA, CONMEBOL, CONCACAF, CAF, AFC, OFC.

**Returns:** rankings[]{current_ranking, previous_ranking, current_points, previous_points, country_name, confederation_name, national_team_id}

**Example request body:**
```json
{
  "confederation": [
    "UEFA"
  ]
}
```

### POST https://api.reefapi.com/transfermarkt/v1/reference_data — 0 credits
Transfermarkt's lookup tables: countries (ids for the nationality / country filters), positions, confederations, competition types, injuries, absences, contract options, tactics, staff roles, match actions, outfitters.

**Parameters:**
- `type` (enum, required) — Which table. [one of: countries, positions, confederations, competition_types, injuries, absences, contract_options, tactics, staff_roles, match_actions, outfitters]

**Returns:** items[] + count

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=transfermarkt
- Human docs page: https://reefapi.com/docs/transfermarkt
- Overview page: https://reefapi.com/transfermarkt-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
