Reef AI: ask for any data. Try it
Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the Transfermarkt API page →
Media, Film & Knowledge

Transfermarkt API & Scraper

This API reads Transfermarkt, the football market-value and transfer database, as JSON, logged out.

47 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
Get a free keyOpen in playground

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

Every money field comes twice: in whole euros (market_value_eur: 220000000) and exactly as the site prints it (market_value_display: "€220.00M"); a fee the site prints as text stays text ("free transfer", "loan transfer", "End of loan", "-", "?") with fee_eur null. `player` is the full profile: citizenship, position, foot, height, current club with the date he joined, contract expiry and last extension, player agent, market value with its last update, the previous and the highest value ever, national-team caps and goals, social media links and, for a loan, the parent club and its contract. `player_market_value` is every valuation since the first one, with club and age at the time; `player_transfers` is every move with both clubs, league, country, fee, market value at the time and contract length. Clubs: `club_squad` returns every player as a full card plus the squad total the site prints ("Total market value"), `club_transfers` the season's arrivals and departures with expenditure, income and balance. Leagues: tables (home, away, after any match day), fixtures, transfers sorted by fee, top scorers, champions. Feeds: the transfer ticker, record transfers, free agents, expiring contracts, the newest market-value updates and the rumour mill. Names, URLs and Transfermarkt ids are accepted wherever an id is asked for.

Reference

What a Transfermarkt field actually contains

Fields that read differently from how they look. Every row was measured against live transfermarkt.com pages on 2026-11-16.

FieldWhat it holds
market_value_eur, market_value_displayThe player's current Transfermarkt market value in euros and as the profile prints it. Both matched the profile page's "Market value" on 8 of 8 players checked in the same minute (Haaland €220.00M, Mbappé €200.00M, Messi €15.00M).
market_value_last_updateThe date the site prints under the value as "Last update" (Haaland: 2026-07-22). previous_market_value_* is the valuation before it; highest_market_value_* the highest one ever with its date.
fee_eur, fee_displayThe transfer fee as the transfer history prints it in the "Fee" column. A free, loan or end-of-loan move has fee_eur null and the site's own words in fee_display. 8 of 8 most-recent transfers matched the site's transfer history, including a loan (Grealish: "loan transfer").
transfers[].market_value_eurThe player's market value at the time of the move (the "MV" column), not today's value. 8 of 8 matched.
total_market_value_eur (club_squad, club)The squad total the club page prints as "Total market value". It matched on 4 of 4 clubs (Manchester City €1.50B, Bayern €1.04B, Real Madrid €1.50B, Manchester United €928.80M) and equalled the sum of the players' values in all 4.
expenditure_eur, income_eur, balance_eurclub_transfers: the season's fee totals for arrivals and departures as Transfermarkt sums them; balance is income minus expenditure. Manchester City 2025/26: €301.80M spent, €107.28M received, 20 arrivals and 20 departures, the same 40 rows the club's transfer page lists.
season, season_idseason is the site's own label ("22/23", or "2026" for a calendar-year competition); season_id is the year the season starts (2025 = 2025/26). Every season parameter takes 2025, "25/26" or "2025/26".
player_agentThe agency the profile prints as "Player agent", with its Transfermarkt id and verification status. Filled for 238 of 263 players in the 10 squads checked; "Relatives" is marked is_relatives.
on_loan_fromFor a loaned player: the parent club and the date its own contract ends ("Contract there expires"). contract_expires is then the loan contract the profile prints.

Market values are Transfermarkt's own estimates, in euros. A past season's squad lists that season's players with their CURRENT market value; the site does not publish historic values through that route.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on .

Captured request
{
  "method": "POST",
  "url": "https://api.reefapi.com/transfermarkt/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "haaland"
  }
}
Captured response
{
  "ok": true,
  "meta": {
    "api": "transfermarkt",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 2578.9,
    "record_count": 11,
    "bytes": 38201,
    "cache_hit": false,
    "upstream_requests": 4,
    "charged_credits": 2,
    "version": "0.1.0",
    "request_id": "d677926fbcfa42ad",
    "queue_ms": 1.9,
    "fetched_at": "2026-11-16T21:05:28.218Z"
  },
  "data": {
    "query": "haaland",
    "type": "all",
    "page": 1,
    "limit": 10,
    "players": [
      {
        "player_id": "418560",
        "name": "Erling Haaland",
        "first_name": "Erling",
        "last_name": "Haaland",
        "short_name": "E. Haaland",
        "artist_name": null,
        "display_name": null,
        "url": "https://www.transfermarkt.com/erling-haaland/profil/spieler/418560",
        "portrait_url": "https://img.a.transfermarkt.technology/portrait/big/418560-1788115885.jpg",
        "portrait_source": "IMAGO",
        "date_of_birth": "2000-07-21",
        "age": 26,
        "date_of_birth_unknown": false,
        "date_of_death": null,
        "place_of_birth": "Leeds",
        "place_of_birth_info": null,
        "country_of_birth_id": "189",
        "country_of_birth": "England",
        "gender": "male",
        "name_in_home_country": "Erling Braut Håland",
        "citizenship": [
          "Norway"
        ],
        "citizenship_ids": [
          "125"
        ],
        "height_m": 1.95,
        "foot": "left",
        "outfitter": "Nike",
        "position": "Centre-Forward",
        "position_short": "CF",
        "position_id": 14,
        "position_category": "Striker",
        "position_group": "FORWARD",
        "other_positions": [],
        "contract_expires": "2034-06-30",
        "contract_option": null,
        "last_contract_extension": "2025-01-17",
        "former_clubs_note": "Bryne FK (2006-2015)",
        "player_agent": {
          "agent_id": "282",
          "name": "Rafaela Pimenta",
          "short_name": "Rafaela Pimenta",
          "verification_status": "verified",
          "verification_date": "2023-01-10",
          "is_relatives": false,
          "url": "https://www.transfermarkt.com/rafaela-pimenta/beraterfirma/berater/282"
        },
        "market_value_eur": 220000000,
        "market_value_display": "€220.00M",
        "market_value_last_update": "2026-07-22",
        "previous_market_value_eur": 200000000,
        "previous_market_value_display": "€200.00M",
        "previous_market_value_last_update": "2026-06-03",
        "highest_market_value_eur": 220000000,
        "highest_market_value_display": "€220.00M",
        "highest_market_value_date": "2026-07-22",
        "market_value_change_display": "+20.000.000 €",
        "market_value_change_percent": "+10,00 %",
        "market_value_trend": "INCREASED",
        "current_club": {
          "club_id": "281",
          "club_name": "Manchester City",
          "type": "current",
          "shirt_number": 9,
          "is_captain": false,
          "joined": "2022-07-01",
          "debut": "2022-07-30"
        },
        "national_team": {
          "club_id": "3440",
          "club_name": "Norway",
          "type": "nationalTeam",
          "shirt_number": null,
          "is_captain": false,
          "joined": null,
          "debut": "2019-09-05"
        },
        "club_assignments": [
          {
            "club_id": "[trimmed-depth]",
            "club_name": "[trimmed-depth]",
            "type": "[trimmed-depth]",
            "shirt_number": "[trimmed-depth]",
            "is_captain": "[trimmed-depth]",
            "joined": "[trimmed-depth]",
            "debut": "[trimmed-depth]"
          },
          {
            "club_id": "[trimmed-depth]",
            "club_name": "[trimmed-depth]",
            "type": "[trimmed-depth]",
            "shirt_number": "[trimmed-depth]",
            "is_captain": "[trimmed-depth]",
            "joined": "[trimmed-depth]",
            "debut": "[trimmed-depth]"
          }
        ],
        "last_club_id": null,
        "nominations": [],
        "participations": []
      },
      {
        "player_id": "42223",
        "name": "Stig Krohn Haaland",
        "first_name": "Stig Krohn",
        "last_name": "Haaland",
        "short_name": "S. Haaland",
        "artist_name": null,
        "display_name": null,
        "url": "https://www.transfermarkt.com/stig-krohn-haaland/profil/spieler/42223",
        "portrait_url": null,
        "portrait_source": null,
        "date_of_birth": "1975-02-23",
        "age": 51,
        "date_of_birth_unknown": false,
        "date_of_death": null,
        "place_of_birth": "Haugesund",
        "place_of_birth_info": null,
        "country_of_birth_id": "125",
        "country_of_birth": "Norway",
        "gender": "male",
        "name_in_home_country": null,
        "citizenship": [
          "Norway"
        ],
        "citizenship_ids": [
          "125"
        ],
        "height_m": 1.73,
        "foot": "left",
        "outfitter": null,
        "position": "Left-Back",
        "position_short": "LB",
        "position_id": 4,
        "position_category": "Defender",
        "position_group": "DEFENDER",
        "other_positions": [],
        "contract_expires": null,
        "contract_option": null,
        "last_contract_extension": null,
        "former_clubs_note": null,
        "player_agent": null,
        "market_value_eur": 0,
        "market_value_display": "€0.00",
        "market_value_last_update": "2012-01-01",
        "previous_market_value_eur": 100000,
        "previous_market_value_display": "€100.00K",
        "previous_market_value_last_update": "2009-01-18",
        "highest_market_value_eur": 100000,
        "highest_market_value_display": "€100.00K",
        "highest_market_value_date": "2009-01-18",
        "market_value_change_display": "-100.000 €",
        "market_value_change_percent": "-100,00 %",
        "market_value_trend": "DECREASED",
        "current_club": {
          "club_id": "123",
          "club_name": "Retired",
          "type": "current",
          "shirt_number": null,
          "is_captain": false,
          "joined": "2012-01-01",
          "debut": null
        },
        "national_team": null,
        "club_assignments": [
          {
            "club_id": "[trimmed-depth]",
            "club_name": "[trimmed-depth]",
            "type": "[trimmed-depth]",
            "shirt_number": "[trimmed-depth]",
            "is_captain": "[trimmed-depth]",
            "joined": "[trimmed-depth]",
            "debut": "[trimmed-depth]"
          }
        ],
        "last_club_id": "6477",
        "last_club_name": "SK Vard Haugesund",
        "nominations": [],
        "participations": []
      },
      {
        "player_id": "107179",
        "name": "Alf-Inge Haaland",
        "first_name": "Alf-Inge",
        "last_name": "Haaland",
        "short_name": "A. Haaland",
        "artist_name": null,
        "display_name": null,
        "url": "https://www.transfermarkt.com/alf-inge-haaland/profil/spieler/107179",
        "portrait_url": "https://img.a.transfermarkt.technology/portrait/big/s_107179_123_2012_12_07_1.jpg",
        "portrait_source": "Getty Images",
        "date_of_birth": "1972-11-23",
        "age": 53,
        "date_of_birth_unknown": false,
        "date_of_death": null,
        "place_of_birth": "Bryne",
        "place_of_birth_info": null,
        "country_of_birth_id": "125",
        "country_of_birth": "Norway",
        "gender": "male",
        "name_in_home_country": "Alf-Inge Rasdal Håland",
        "citizenship": [
          "Norway"
        ],
        "citizenship_ids": [
          "125"
        ],
        "height_m": 1.86,
        "foot": "right",
        "outfitter": null,
        "position": "Right-Back",
        "position_short": "RB",
        "position_id": 5,
        "position_category": "Defender",
        "position_group": "DEFENDER",
        "other_positions": [
          "Defensive Midfield",
          "Central Midfield"
        ],
        "contract_expires": null,
        "contract_option": null,
        "last_contract_extension": null,
        "former_clubs_note": "Bryne FK",
        "player_agent": null,
        "market_value_eur": null,
        "market_value_display": null,
        "market_value_last_update": null,
        "previous_market_value_eur": null,
        "previous_market_value_display": null,
        "previous_market_value_last_update": null,
        "highest_market_value_eur": null,
        "highest_market_value_display": null,
        "highest_market_value_date": null,
        "market_value_change_display": null,
        "market_value_change_percent": null,
        "market_value_trend": null,
        "current_club": {
          "club_id": "123",
          "club_name": "Retired",
          "type": "current",
          "shirt_number": null,
          "is_captain": false,
          "joined": "2013-07-01",
          "debut": null
        },
        "national_team": null,
        "club_assignments": [
          {
            "club_id": "[trimmed-depth]",
            "club_name": "[trimmed-depth]",
            "type": "[trimmed-depth]",
            "shirt_number": "[trimmed-depth]",
            "is_captain": "[trimmed-depth]",
            "joined": "[trimmed-depth]",
            "debut": "[trimmed-depth]"
          }
        ],
        "last_club_id": "36241",
        "last_club_name": "Rosseland BK",
        "nominations": [],
        "participations": []
      }
    ],
    "players_total": 14,
    "players_has_more": true,
    "clubs": [],
    "clubs_total": 0,
    "clubs_has_more": false,
    "competitions": [],
    "competitions_total": 0,
    "competitions_has_more": false,
    "coaches": [
      {
        "coach_id": "95010",
        "name": "Ferdinand Krohn Haaland",
        "url": "https://www.transfermarkt.com/ferdinand-krohn-haaland/profil/trainer/95010",
        "portrait_url": null,
        "date_of_birth": "1976-12-30",
        "age": 49,
        "date_of_death": null,
        "place_of_birth": null,
        "country_of_birth": null,
        "gender": "male",
        "name_in_home_country": null,
        "citizenship": [
          "Norway"
        ],
        "citizenship_ids": [
          "125"
        ],
        "license": "none",
        "role": "Manager",
        "former_player_id": "1527316",
        "is_available": false,
        "former_clubs_note": null
      }
    ],
    "coaches_total": 1,
    "coaches_has_more": false,
    "referees": [],
    "referees_total": 0,
    "referees_has_more": false,
    "agents": [],
    "agents_total": 0,
    "agents_has_more": false
  }
}
Actions

What the Transfermarkt API does

ActionDescriptionConcrete use caseKey params
searchQuick 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).Content platforms call search to get quick search across Transfermarkt.query, type, page, limit, only_active, ...
advanced_searchTransfermarkt'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.Research tools call advanced_search to get transfermarkt's advanced player search (the scouting form).name, first_name, exact_name, place_of_birth, nationality, ...
playerOne 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.Community analysts call player to get one player's full Transfermarkt profile.player_id
player_market_valueA 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.Media monitors call player_market_value to get a player's market value over time as Transfermarkt publishes it.player_id
player_transfersA 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.Content platforms call player_transfers to get a player's full transfer history.player_id
player_statsA 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.Research tools call player_stats to get a player's performance statistics, by season × competition × club (default), by competition,….player_id, season, group_by, competition_ids, club_ids, ...
player_matchesA 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.Community analysts call player_matches to get a player's match-by-match log for a season (default.player_id, season, competition_ids, club_ids, status, ...
player_injuriesA 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.Media monitors call player_injuries to get a player's injury history (injury, from, until, days out, games missed) and his other absence….player_id, only_current
player_national_teamA 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.Content platforms call player_national_team to get a player's national-team career.player_id
player_achievementsA player's titles and individual awards: every title with season, club or national team, competition; counts per title; club / international / individual totals.Research tools call player_achievements to get a player's titles and individual awards.player_id
player_rumorsTransfer 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.Community analysts call player_rumors to get transfer rumours about one player from Transfermarkt's rumour mill.player_id, page, limit
player_squad_numbersEvery shirt number a player wore, per season, for each club and national team.Media monitors call player_squad_numbers to get every shirt number a player wore, per season, for each club and national team..player_id
player_upcoming_matchesThe 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.Content platforms call player_upcoming_matches to get the coming (and the most recent) games of a player's club and national team, as the profile p….player_id, limit
clubOne 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.Research tools call club to get one club's profile.club_id
club_squadA 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.Community analysts call club_squad to get a club's squad for a season (default current).club_id, season
club_squad_statsA 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.Media monitors call club_squad_stats to get a club's squad statistics table for a season (default current).club_id, season
club_transfersA 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.Content platforms call club_transfers to get a club's transfers in a season (default current).club_id, season
club_fixturesA club's fixtures and results for a season (default current), all competitions: date, competition, round, opponent, score, result, attendance.Research tools call club_fixtures to get a club's fixtures and results for a season (default current), all competitions.club_id, season
club_achievementsEvery trophy a club won, by season, with counts per title.Community analysts call club_achievements to get every trophy a club won, by season, with counts per title..club_id
club_rumorsActive transfer rumours about a club: incoming and outgoing players, probability, sources.Media monitors call club_rumors to get active transfer rumours about a club.club_id
club_historyA club's league placement in every season: league, level, W/D/L, goals, points, rank, manager.Content platforms call club_history to get a club's league placement in every season.club_id
club_transfer_recordsA club's record signings (arrivals) or record sales (departures), all time or one season, ranked by fee.Research tools call club_transfer_records to get a club's record signings (arrivals) or record sales (departures), all time or one season, ran….club_id, season, direction, page
club_national_playersPlayers of a club who play for a national team (senior and youth), with caps and goals.Community analysts call club_national_players to get players of a club who play for a national team (senior and youth), with caps and goals..club_id
competitionA 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.Media monitors call competition to get a league or cup.competition_id, season
competition_listLeagues and cups ranked by total market value, filterable by confederation, country and tier (first tier, second tier, cups, …).Content platforms call competition_list to get leagues and cups ranked by total market value, filterable by confederation, country and tier….confederation, country, tier, limit
competition_tableLeague table for a season (default current), overall or home / away, optionally after a given match day; group tables for cups.Research tools call competition_table to get league table for a season (default current), overall or home / away, optionally after a given….competition_id, season, venue, game_day
competition_fixturesAll fixtures and results of a competition season, or one match day.Community analysts call competition_fixtures to get all fixtures and results of a competition season, or one match day..competition_id, season, game_day
competition_transfersEvery transfer involving a league's clubs in a season, sorted by date or fee, arrivals and departures, paged.Media monitors call competition_transfers to get every transfer involving a league's clubs in a season, sorted by date or fee, arrivals and de….competition_id, season, sort, order, direction, ...
competition_rumorsLatest transfer rumours about a league's clubs, newest first (25 per page).Content platforms call competition_rumors to get latest transfer rumours about a league's clubs, newest first (25 per page)..competition_id, page, limit
competition_championsEvery champion of a competition by season, and titles per club.Research tools call competition_champions to get every champion of a competition by season, and titles per club..competition_id
top_scorersTop 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.Community analysts call top_scorers to get top players by goals, assists, goals + assists or clean sheets.stat, competition_ids, season, season_from, season_to, ...
latest_transfersThe newest transfers worldwide (Transfermarkt's transfer ticker), filterable by league, from/to league, from/to country, confederation, position, citizenship, age and market value.Media monitors call latest_transfers to get the newest transfers worldwide (Transfermarkt's transfer ticker), filterable by league, from/….competition_ids, from_competition_ids, to_competition_ids, from_country, to_country, ...
record_transfersThe 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.Content platforms call record_transfers to get the most expensive transfers ever (or of one season), 25 per page.season, nationality, position, age_group, birth_year, ...
latest_rumorsThe latest transfer rumours worldwide from Transfermarkt's rumour mill.Research tools call latest_rumors to get the latest transfer rumours worldwide from Transfermarkt's rumour mill..page
most_valuable_playersPlayers 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.Community analysts call most_valuable_players to get players ranked by market value, filterable by league, club, position, citizenship, confederat….competition_ids, club_ids, position, nationality, confederation, ...
most_valuable_clubsClubs (or national teams) ranked by total squad market value, by league, country or confederation.Media monitors call most_valuable_clubs to get clubs (or national teams) ranked by total squad market value, by league, country or confedera….competition_ids, country, confederation, national_teams, limit
free_agentsPlayers without a club, by market value: position, citizenship, age, last club and league, without a contract since.Content platforms call free_agents to get players without a club, by market value.position, nationality, age_min, age_max, market_value_min, ...
expiring_contractsPlayers whose contract ends in a given year (default: next summer), by league, position, citizenship and age, highest market value first.Research tools call expiring_contracts to get players whose contract ends in a given year (default.contract_end_year, competition_ids, position, nationality, age_min, ...
market_value_updatesThe newest market-value updates (players Transfermarkt just revalued) with the new value and date, filterable by league, position, age and value.Community analysts call market_value_updates to get the newest market-value updates (players Transfermarkt just revalued) with the new value and….competition_ids, position, nationality, confederation, age_min, ...
coachA coach's profile and career: every post (club, role, appointed, until, days), current post, average tenure, licence, preferred formation and formations used.Media monitors call coach to get a coach's profile and career.coach_id
coach_statsA coach's record per club, season and competition: games, wins, draws, losses, points per game, goals, cards.Content platforms call coach_stats to get a coach's record per club, season and competition.coach_id, season, competition_ids, club_ids, national_team
coach_achievementsEvery title and award a coach won.Research tools call coach_achievements to get every title and award a coach won..coach_id
refereeA referee's profile: name, date of birth, citizenship.Community analysts call referee to get a referee's profile.referee_id
matchA 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.Media monitors call match to get a match report.game_id
newsTransfermarkt news about a player, club, competition, coach, referee or match (or the latest overall), with headline, teaser and link, paged.Content platforms call news to get transfermarkt news about a player, club, competition, coach, referee or match (or the latest….player_id, club_id, competition_id, coach_id, referee_id, ...
fifa_rankingThe FIFA men's world ranking as Transfermarkt lists it: rank, previous rank, points, confederation; current or at a past date.Research tools call fifa_ranking to get the FIFA men's world ranking as Transfermarkt lists it.date, confederation
reference_dataTransfermarkt's lookup tables: countries (ids for the nationality / country filters), positions, confederations, competition types, injuries, absences, contract options, tactics, staff roles, match actions, outfitters.Community analysts call reference_data to get transfermarkt's lookup tables.type
Code samples

Call search from your stack

curl -X POST https://api.reefapi.com/transfermarkt/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"haaland"}'
MCP one-liner
Ask your MCP-connected assistant: call reefapi.transfermarkt.search with {"query":"haaland"}.
Use cases

Who uses this API and why

  • Track market values and their history for a list of players or a whole league.
  • Pull every transfer with fee, clubs and contract length for a club, a league or a season.
  • Build scouting shortlists by position, age, citizenship, value and contract expiry.
  • Feed fantasy and media apps with squads, tables, fixtures, line-ups and top scorers.
  • Watch the transfer ticker, rumours, free agents and new market-value updates.
FAQ

Questions developers ask before integrating

Do I need a Transfermarkt account?

No. Everything is read logged out.

Can I search by name instead of an id?

Yes. Every player_id, club_id, competition_id and coach_id also takes a name or a transfermarkt.com URL; the best quick-search match is used and returned in resolved_from ("arsenal" → club 11, "premier league" → GB1).

How far back does the market value history go?

To the player's first valuation. Erling Haaland has 28 points from €200.00K on 2016-12-18 to €220.00M on 2026-07-22, each with the club and his age at the time.

How many players does most_valuable_players return?

Up to 100 per call, filtered by league, club, position, citizenship, confederation, age, birth year or value range. next_cursor continues down the list: three calls walked 252 different players with no repeats.

Which filters does the transfer ticker take?

League, from-league, to-league, from-country, to-country, confederation, position, citizenship, age and market value. Each was checked against the unfiltered feed in the same run: to_country England 50 of 50 rows into English clubs, position goalkeeper 50 of 50 goalkeepers. A minimum fee filter is not offered: the site ignores it.

Are injuries included?

player_injuries returns every injury with dates, days out and games missed (Haaland: 23 injuries, 337 days, 68 games), plus suspensions and national-team absences.

Can I get a match line-up?

match returns both line-ups and benches with each player's market value, formations, coaches, referee and assistants, attendance, the stadium, and every goal, card and substitution with minute and players.

How many results does the advanced search give?

25 per page and at most 250 hits per filter set, as on the site; narrow the filters to reach more players.

What is the Transfermarkt API?

Transfermarkt API is a ReefAPI endpoint group for football market values with their full history, every transfer and fee, squads, league tables, player stats and match reports as json. It returns live JSON through POST requests under /transfermarkt/v1.

Is the Transfermarkt API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. Transfermarkt calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Transfermarkt login or account?

No login to Transfermarkt is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Transfermarkt data?

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Transfermarkt API use?

Transfermarkt actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call Transfermarkt from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call transfermarkt actions with the same key, credit pool and JSON envelope used by normal REST requests.

docs / transfermarkt

Transfermarkt

Football market values with their full history, every transfer and fee, squads, league tables, player stats and match reports as JSON.

base /transfermarkt/v147 endpoints
post/transfermarkt/v1/player2 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.

ParameterAllowed / rangeDescription
player_idrequired—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`).
Try in playground →
post/transfermarkt/v1/player_market_value2 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.

ParameterAllowed / rangeDescription
player_idrequired—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`).
Try in playground →
post/transfermarkt/v1/player_transfers2 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.

ParameterAllowed / rangeDescription
player_idrequired—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`).
Try in playground →
post/transfermarkt/v1/player_stats2 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.

ParameterAllowed / rangeDescription
player_idrequired—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`).
seasonoptional—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 = seasonoptionalseason · competition · club · coachHow rows are grouped.
competition_idsoptional—Only these competitions.
club_idsoptional—Only these clubs.
national_teamoptional—true = only national-team games, false = only club games.
Try in playground →
post/transfermarkt/v1/player_matches2 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.

ParameterAllowed / rangeDescription
player_idrequired—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`).
seasonoptional—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_idsoptional—Only these.
club_idsoptional—Only for these clubs.
statusoptional—played, in_squad, not_in_squad, injured, absent, other_team.
date_fromoptional—From date, YYYY-MM-DD.
date_tooptional—To date, YYYY-MM-DD.
national_teamoptional—Only national-team (true) or club (false) games.
page = 1optional1–1000Result page (1-based). `has_more` says whether another page exists.
limit = 50optional1–200How many matches per call (1-200).
Try in playground →
post/transfermarkt/v1/player_injuries2 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.

ParameterAllowed / rangeDescription
player_idrequired—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 = falseoptional—Only injuries/absences still running.
Try in playground →
post/transfermarkt/v1/player_national_team2 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.

ParameterAllowed / rangeDescription
player_idrequired—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`).
Try in playground →
post/transfermarkt/v1/player_achievements2 credits

A player's titles and individual awards: every title with season, club or national team, competition; counts per title; club / international / individual totals.

ParameterAllowed / rangeDescription
player_idrequired—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`).
Try in playground →
post/transfermarkt/v1/player_rumors2 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.

ParameterAllowed / rangeDescription
player_idrequired—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 = 1optional1–1000Result page (1-based). `has_more` says whether another page exists.
limit = 25optional1–100How many archived rumours per call (1-100).
Try in playground →
post/transfermarkt/v1/player_squad_numbers1 credit

Every shirt number a player wore, per season, for each club and national team.

ParameterAllowed / rangeDescription
player_idrequired—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`).
Try in playground →
post/transfermarkt/v1/player_upcoming_matches1 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.

ParameterAllowed / rangeDescription
player_idrequired—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 = 10optional1–50How many games per list per call (1-50).
Try in playground →
post/transfermarkt/v1/club2 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.

ParameterAllowed / rangeDescription
club_idrequired—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`).
Try in playground →
post/transfermarkt/v1/club_squad2 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.

ParameterAllowed / rangeDescription
club_idrequired—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`).
seasonoptional—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'.
Try in playground →
post/transfermarkt/v1/club_squad_stats1 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.

ParameterAllowed / rangeDescription
club_idrequired—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`).
seasonoptional—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'.
Try in playground →
post/transfermarkt/v1/club_transfers3 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.

ParameterAllowed / rangeDescription
club_idrequired—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`).
seasonoptional—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'.
Try in playground →
post/transfermarkt/v1/club_fixtures2 credits

A club's fixtures and results for a season (default current), all competitions: date, competition, round, opponent, score, result, attendance.

ParameterAllowed / rangeDescription
club_idrequired—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`).
seasonoptional—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'.
Try in playground →
post/transfermarkt/v1/club_achievements1 credit

Every trophy a club won, by season, with counts per title.

ParameterAllowed / rangeDescription
club_idrequired—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`).
Try in playground →
post/transfermarkt/v1/club_rumors2 credits

Active transfer rumours about a club: incoming and outgoing players, probability, sources.

ParameterAllowed / rangeDescription
club_idrequired—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`).
Try in playground →
post/transfermarkt/v1/club_history1 credit

A club's league placement in every season: league, level, W/D/L, goals, points, rank, manager.

ParameterAllowed / rangeDescription
club_idrequired—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`).
Try in playground →
post/transfermarkt/v1/club_transfer_records1 credit

A club's record signings (arrivals) or record sales (departures), all time or one season, ranked by fee.

ParameterAllowed / rangeDescription
club_idrequired—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`).
seasonoptional—Only transfers of this season (the year it starts: 2024 = 2024/25; '24/25' is accepted). Leave out for all-time records.
direction = arrivalsoptionalarrivals · departuresSignings or sales.
page = 1optional1–100—
Try in playground →
post/transfermarkt/v1/club_national_players1 credit

Players of a club who play for a national team (senior and youth), with caps and goals.

ParameterAllowed / rangeDescription
club_idrequired—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`).
Try in playground →
post/transfermarkt/v1/competition2 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.

ParameterAllowed / rangeDescription
competition_idrequired—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`).
seasonoptional—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'.
Try in playground →
post/transfermarkt/v1/competition_list2 credits

Leagues and cups ranked by total market value, filterable by confederation, country and tier (first tier, second tier, cups, …).

ParameterAllowed / rangeDescription
confederationoptional—Confederation: UEFA, CONMEBOL, CONCACAF, CAF, AFC, OFC.
countryoptional—Country name, FIFA code or id.
tieroptional—Competition type: first_tier, second_tier, … (see reference_data type=competition_types).
limit = 50optional1–100How many rows per call (1-100).
Try in playground →
post/transfermarkt/v1/competition_table2 credits

League table for a season (default current), overall or home / away, optionally after a given match day; group tables for cups.

ParameterAllowed / rangeDescription
competition_idrequired—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`).
seasonoptional—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 = alloptionalall · home · awayWhich games count.
game_dayoptional1–60Table after this match day.
Try in playground →
post/transfermarkt/v1/competition_fixtures2 credits

All fixtures and results of a competition season, or one match day.

ParameterAllowed / rangeDescription
competition_idrequired—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`).
seasonoptional—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_dayoptional1–100Only this match day.
Try in playground →
post/transfermarkt/v1/competition_transfers3 credits

Every transfer involving a league's clubs in a season, sorted by date or fee, arrivals and departures, paged.

ParameterAllowed / rangeDescription
competition_idrequired—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`).
seasonoptional—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 = dateoptionaldate · fee—
order = descoptionaldesc · asc—
direction = alloptionalall · arrivals · departures—
page = 1optional1–1000Result page (1-based). `has_more` says whether another page exists.
limit = 50optional1–100How many transfers per call (1-100).
Try in playground →
post/transfermarkt/v1/competition_rumors2 credits

Latest transfer rumours about a league's clubs, newest first (25 per page).

ParameterAllowed / rangeDescription
competition_idrequired—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 = 1optional1–100—
limit = 25optional1–25How many rumours per call (1-25).
Try in playground →
post/transfermarkt/v1/competition_champions2 credits

Every champion of a competition by season, and titles per club.

ParameterAllowed / rangeDescription
competition_idrequired—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`).
Try in playground →
post/transfermarkt/v1/top_scorers2 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.

ParameterAllowed / rangeDescription
stat = goalsoptionalgoals · assists · goals_and_assists · scorers · clean_sheets—
competition_idsoptional—Only players at clubs in these competitions (codes, e.g. GB1, ES1).
seasonoptional—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_fromoptional—First season of a span (2020 or 20/21).
season_tooptional—Last season of a span (2024 or 24/25).
positionoptional—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.
nationalityoptional—Citizenship: country name, FIFA code (NOR) or Transfermarkt country id (125). Several are allowed.
club_idsoptional—Only players of these clubs (club ids).
age_minoptional10–60Minimum age.
age_maxoptional10–60Maximum age.
limit = 25optional1–100How many players per call (1-100).
Try in playground →
post/transfermarkt/v1/latest_transfers3 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.

ParameterAllowed / rangeDescription
competition_idsoptional—Only players at clubs in these competitions (codes, e.g. GB1, ES1).
from_competition_idsoptional—Leaving these leagues.
to_competition_idsoptional—Joining these leagues.
from_countryoptional—Leaving clubs of these countries.
to_countryoptional—Joining clubs of these countries.
confederationoptional—Confederation: UEFA, CONMEBOL, CONCACAF, CAF, AFC, OFC.
positionoptional—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.
nationalityoptional—Citizenship: country name, FIFA code (NOR) or Transfermarkt country id (125). Several are allowed.
age_minoptional10–60Minimum age.
age_maxoptional10–60Maximum age.
market_value_minoptional0–Minimum market value in euros (10000000 = €10m).
market_value_maxoptional0–Maximum market value in euros.
limit = 50optional1–100How many rows per call (1-100).
Try in playground →
post/transfermarkt/v1/record_transfers2 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.

ParameterAllowed / rangeDescription
seasonoptional—Only transfers of this season (the year it starts: 2024 = 2024/25; '24/25' is accepted). Leave out for all-time records.
nationalityoptional—One citizenship.
positionoptional—A group (forward, …) or a detailed position.
age_groupoptional—u15 … u23, 23-30, o30, o32, o34, o36.
birth_yearoptional1900–2025—
loans = includeoptionalinclude · only · exclude_previous_loan—
window = anyoptionalany · summer · winter—
page = 1optional1–100—
Try in playground →
post/transfermarkt/v1/latest_rumors1 credit

The latest transfer rumours worldwide from Transfermarkt's rumour mill.

ParameterAllowed / rangeDescription
page = 1optional1–100—
Try in playground →
post/transfermarkt/v1/most_valuable_players2 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.

ParameterAllowed / rangeDescription
competition_idsoptional—Only players at clubs in these competitions (codes, e.g. GB1, ES1).
club_idsoptional—Only players of these clubs (club ids).
positionoptional—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.
nationalityoptional—Citizenship: country name, FIFA code (NOR) or Transfermarkt country id (125). Several are allowed.
confederationoptional—Confederation: UEFA, CONMEBOL, CONCACAF, CAF, AFC, OFC.
age_minoptional10–60Minimum age.
age_maxoptional10–60Maximum age.
birth_year_minoptional1900–2025Born in this year or later.
birth_year_maxoptional1900–2025Born in this year or earlier.
market_value_minoptional0–Minimum market value in euros (10000000 = €10m).
market_value_maxoptional0–Maximum market value in euros.
limit = 50optional1–100How many rows per call (1-100).
cursoroptional—`next_cursor` of the previous call.
Try in playground →
post/transfermarkt/v1/most_valuable_clubs2 credits

Clubs (or national teams) ranked by total squad market value, by league, country or confederation.

ParameterAllowed / rangeDescription
competition_idsoptional—Only players at clubs in these competitions (codes, e.g. GB1, ES1).
countryoptional—Country name, FIFA code or id.
confederationoptional—Confederation: UEFA, CONMEBOL, CONCACAF, CAF, AFC, OFC.
national_teamsoptional—true = national teams only.
limit = 50optional1–100How many rows per call (1-100).
Try in playground →
post/transfermarkt/v1/free_agents1 credit

Players without a club, by market value: position, citizenship, age, last club and league, without a contract since.

ParameterAllowed / rangeDescription
positionoptional—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.
nationalityoptional—Citizenship: country name, FIFA code (NOR) or Transfermarkt country id (125). Several are allowed.
age_minoptional10–60Minimum age.
age_maxoptional10–60Maximum age.
market_value_minoptional0–Minimum market value in euros (10000000 = €10m).
market_value_maxoptional0–Maximum market value in euros.
last_competition_idsoptional—League of the last club.
free_since_fromoptional—Without contract since, from (YYYY-MM-DD).
free_since_tooptional—Without contract since, to (YYYY-MM-DD).
limit = 50optional1–100How many rows per call (1-100).
Try in playground →
post/transfermarkt/v1/expiring_contracts2 credits

Players whose contract ends in a given year (default: next summer), by league, position, citizenship and age, highest market value first.

ParameterAllowed / rangeDescription
contract_end_yearoptional2000–2100—
competition_idsoptional—Only players at clubs in these competitions (codes, e.g. GB1, ES1).
positionoptional—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.
nationalityoptional—Citizenship: country name, FIFA code (NOR) or Transfermarkt country id (125). Several are allowed.
age_minoptional10–60Minimum age.
age_maxoptional10–60Maximum age.
limit = 50optional1–100How many rows per call (1-100).
Try in playground →
post/transfermarkt/v1/market_value_updates2 credits

The newest market-value updates (players Transfermarkt just revalued) with the new value and date, filterable by league, position, age and value.

ParameterAllowed / rangeDescription
competition_idsoptional—Only players at clubs in these competitions (codes, e.g. GB1, ES1).
positionoptional—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.
nationalityoptional—Citizenship: country name, FIFA code (NOR) or Transfermarkt country id (125). Several are allowed.
confederationoptional—Confederation: UEFA, CONMEBOL, CONCACAF, CAF, AFC, OFC.
age_minoptional10–60Minimum age.
age_maxoptional10–60Maximum age.
birth_year_minoptional1900–2025Born in this year or later.
birth_year_maxoptional1900–2025Born in this year or earlier.
market_value_minoptional0–Minimum market value in euros (10000000 = €10m).
market_value_maxoptional0–Maximum market value in euros.
limit = 50optional1–100How many rows per call (1-100).
Try in playground →
post/transfermarkt/v1/coach2 credits

A coach's profile and career: every post (club, role, appointed, until, days), current post, average tenure, licence, preferred formation and formations used.

ParameterAllowed / rangeDescription
coach_idrequired—Transfermarkt coach id (5672 = Pep Guardiola), a coach URL, or a name.
Try in playground →
post/transfermarkt/v1/coach_stats2 credits

A coach's record per club, season and competition: games, wins, draws, losses, points per game, goals, cards.

ParameterAllowed / rangeDescription
coach_idrequired—Transfermarkt coach id (5672 = Pep Guardiola), a coach URL, or a name.
seasonoptional—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_idsoptional—Only these competitions.
club_idsoptional—Only these clubs.
national_teamoptional—Only national-team (true) or club (false) games.
Try in playground →
post/transfermarkt/v1/coach_achievements2 credits

Every title and award a coach won.

ParameterAllowed / rangeDescription
coach_idrequired—Transfermarkt coach id (5672 = Pep Guardiola), a coach URL, or a name.
Try in playground →
post/transfermarkt/v1/referee1 credit

A referee's profile: name, date of birth, citizenship.

ParameterAllowed / rangeDescription
referee_idrequired—Transfermarkt referee id or a referee URL (/schiedsrichter/<id>).
Try in playground →
post/transfermarkt/v1/match3 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.

ParameterAllowed / rangeDescription
game_idrequired—Transfermarkt match id: `game_id` from fixtures / match logs, or a match-report URL (/spielbericht/<id>).
Try in playground →
post/transfermarkt/v1/news1 credit

Transfermarkt news about a player, club, competition, coach, referee or match (or the latest overall), with headline, teaser and link, paged.

ParameterAllowed / rangeDescription
player_idoptional—Player id/URL/name.
club_idoptional—Club id/URL/name.
competition_idoptional—Competition code/URL/name.
coach_idoptional—Coach id/URL/name.
referee_idoptional—Referee id/URL.
game_idoptional—Match id/URL.
page = 1optional1–100—
limit = 20optional1–100How many news per call (1-100).
Try in playground →
post/transfermarkt/v1/fifa_ranking1 credit

The FIFA men's world ranking as Transfermarkt lists it: rank, previous rank, points, confederation; current or at a past date.

ParameterAllowed / rangeDescription
dateoptional—Ranking date YYYY-MM-DD (leave out for the current one).
confederationoptional—Confederation: UEFA, CONMEBOL, CONCACAF, CAF, AFC, OFC.
Try in playground →
post/transfermarkt/v1/reference_datafree

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.

ParameterAllowed / rangeDescription
typerequiredcountries · positions · confederations · competition_types · injuries · absences · contract_options · tactics · staff_roles · match_actions · outfittersWhich table.
Try in playground →
Built for volume
5M+ requests a day

Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.

Missing a source?
We build it

Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.

Support
2 minute median reply

Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.

One key, one balance
Every API included

No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.

Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.