Transfermarkt API & Scraper
This API reads Transfermarkt, the football market-value and transfer database, as JSON, logged out.
🤖 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.
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.
| Field | What it holds |
|---|---|
| market_value_eur, market_value_display | The 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_update | The 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_display | The 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_eur | The 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_eur | club_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_id | season 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_agent | The 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_from | For 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.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/transfermarkt/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "haaland"
}
}{
"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
}
}What the Transfermarkt API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | 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). | Content platforms call search to get quick search across Transfermarkt. | query, type, page, limit, only_active, ... |
| advanced_search | 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. | Research tools call advanced_search to get transfermarkt's advanced player search (the scouting form). | name, first_name, exact_name, place_of_birth, nationality, ... |
| player | 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. | Community analysts call player to get one player's full Transfermarkt profile. | player_id |
| player_market_value | 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. | Media monitors call player_market_value to get a player's market value over time as Transfermarkt publishes it. | player_id |
| player_transfers | 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. | Content platforms call player_transfers to get a player's full transfer history. | player_id |
| player_stats | 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. | 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_matches | 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. | 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_injuries | 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. | 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_team | 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. | Content platforms call player_national_team to get a player's national-team career. | player_id |
| player_achievements | A 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_rumors | 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. | Community analysts call player_rumors to get transfer rumours about one player from Transfermarkt's rumour mill. | player_id, page, limit |
| player_squad_numbers | Every 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_matches | 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. | 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 |
| club | 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. | Research tools call club to get one club's profile. | club_id |
| club_squad | 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. | Community analysts call club_squad to get a club's squad for a season (default current). | club_id, season |
| club_squad_stats | 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. | Media monitors call club_squad_stats to get a club's squad statistics table for a season (default current). | club_id, season |
| club_transfers | 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. | Content platforms call club_transfers to get a club's transfers in a season (default current). | club_id, season |
| club_fixtures | A 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_achievements | Every 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_rumors | Active 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_history | A 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_records | A 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_players | Players 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 |
| competition | 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. | Media monitors call competition to get a league or cup. | competition_id, season |
| competition_list | Leagues 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_table | League 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_fixtures | All 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_transfers | Every 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_rumors | Latest 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_champions | Every 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_scorers | 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. | 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_transfers | The 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_transfers | 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. | 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_rumors | The 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_players | 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. | 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_clubs | Clubs (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_agents | Players 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_contracts | Players 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_updates | The 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, ... |
| coach | A 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_stats | A 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_achievements | Every title and award a coach won. | Research tools call coach_achievements to get every title and award a coach won.. | coach_id |
| referee | A referee's profile: name, date of birth, citizenship. | Community analysts call referee to get a referee's profile. | referee_id |
| match | 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. | Media monitors call match to get a match report. | game_id |
| news | Transfermarkt 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_ranking | The 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_data | 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. | Community analysts call reference_data to get transfermarkt's lookup tables. | type |
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"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/transfermarkt/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "haaland"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/transfermarkt/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "haaland"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.transfermarkt.search with {"query":"haaland"}.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.
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.