Reef AI: ask for any data. Try it
Transfermarkt API

Every football player's market value, transfer and squad, as JSON

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

endpoints
47
credits per call
0–3

2 credits per call≈ $2/1,000 calls1,000 free credits, no card

POST/transfermarkt/v1/search200
  1. Erling Haalandmarket_value_eur220,000,000
    short_name
    E. Haaland
    portrait_source
    IMAGO
  2. Stig Krohn Haalandmarket_value_eur0
    short_name
    S. Haaland
  3. Alf-Inge Haalandmarket_value_eur—
    short_name
    A. Haaland
    portrait_source
    Getty Images
Real result, captured Nov 16, 20263 of 11
Try it live

Run the call yourself, on the real endpoint

Change a parameter and press Try it. The response on the right is what your code will receive.

Transfermarkt API

6 of 47 endpoints, ready to run

View docs ↗

A player's full profile with market value, contract and agent

2 credits1 required · 0 optional
POST/transfermarkt/v1/player
idle
// Press "Try it" and this pane shows exactly what the
// live site returned this second — including an empty
// result, if that is the truth. No key, no account.

Try every endpoint in the playground

Endpoints

What Transfermarkt endpoints does ReefAPI ship?

47 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

47 endpoints

search

2 cr

Quick search across Transfermarkt.

required
query
optional
type, page, limit, only_active, national_teams, only_main_clubs

advanced_search

1 cr

Transfermarkt's advanced player search (the scouting form).

required
—
optional
name, first_name, exact_name, place_of_birth, nationality, second_nationality, country_of_birth, club_country, confederation, age_min, age_max, birth_year_min, birth_year_max, height_min_cm, height_max_cm, market_value_min, market_value_max, position, other_position, foot, captain, shirt_number, competition_id, caps_min, caps_max, contract_expires, league_tier, national_team_status, active_only, free_agents_only, page

player

2 cr

One player's full Transfermarkt profile.

required
player_id
optional
—

player_market_value

2 cr

A player's market value over time as Transfermarkt publishes it.

required
player_id
optional
—

player_transfers

2 cr

A player's full transfer history.

required
player_id
optional
—

player_stats

2 cr

A player's performance statistics, by season × competition × club (default), by competition,…

required
player_id
optional
season, group_by, competition_ids, club_ids, national_team

player_matches

2 cr

A player's match-by-match log for a season (default.

required
player_id
optional
season, competition_ids, club_ids, status, date_from, date_to, national_team, page, limit

player_injuries

2 cr

A player's injury history (injury, from, until, days out, games missed) and his other absence…

required
player_id
optional
only_current

player_national_team

2 cr

A player's national-team career.

required
player_id
optional
—

player_achievements

2 cr

A player's titles and individual awards.

required
player_id
optional
—

player_rumors

2 cr

Transfer rumours about one player from Transfermarkt's rumour mill.

required
player_id
optional
page, limit

player_squad_numbers

1 cr

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

required
player_id
optional
—

player_upcoming_matches

1 cr

The coming (and the most recent) games of a player's club and national team, as the profile p…

required
player_id
optional
limit

club

2 cr

One club's profile.

required
club_id
optional
—

club_squad

2 cr

A club's squad for a season (default current).

required
club_id
optional
season

club_squad_stats

1 cr

A club's squad statistics table for a season (default current).

required
club_id
optional
season

club_transfers

3 cr

A club's transfers in a season (default current).

required
club_id
optional
season

club_fixtures

2 cr

A club's fixtures and results for a season (default current), all competitions.

required
club_id
optional
season

club_achievements

1 cr

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

required
club_id
optional
—

club_rumors

2 cr

Active transfer rumours about a club.

required
club_id
optional
—

club_history

1 cr

A club's league placement in every season.

required
club_id
optional
—

club_transfer_records

1 cr

A club's record signings (arrivals) or record sales (departures), all time or one season, ran…

required
club_id
optional
season, direction, page

club_national_players

1 cr

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

required
club_id
optional
—

competition

2 cr

A league or cup.

required
competition_id
optional
season

competition_list

2 cr

Leagues and cups ranked by total market value, filterable by confederation, country and tier…

required
—
optional
confederation, country, tier, limit

competition_table

2 cr

League table for a season (default current), overall or home / away, optionally after a given…

required
competition_id
optional
season, venue, game_day

competition_fixtures

2 cr

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

required
competition_id
optional
season, game_day

competition_transfers

3 cr

Every transfer involving a league's clubs in a season, sorted by date or fee, arrivals and de…

required
competition_id
optional
season, sort, order, direction, page, limit

competition_rumors

2 cr

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

required
competition_id
optional
page, limit

competition_champions

2 cr

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

required
competition_id
optional
—

top_scorers

2 cr

Top players by goals, assists, goals + assists or clean sheets.

required
—
optional
stat, competition_ids, season, season_from, season_to, position, nationality, club_ids, age_min, age_max, limit

latest_transfers

3 cr

The newest transfers worldwide (Transfermarkt's transfer ticker), filterable by league, from/…

required
—
optional
competition_ids, from_competition_ids, to_competition_ids, from_country, to_country, confederation, position, nationality, age_min, age_max, market_value_min, market_value_max, limit

record_transfers

2 cr

The most expensive transfers ever (or of one season), 25 per page.

required
—
optional
season, nationality, position, age_group, birth_year, loans, window, page

latest_rumors

1 cr

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

required
—
optional
page

most_valuable_players

2 cr

Players ranked by market value, filterable by league, club, position, citizenship, confederat…

required
—
optional
competition_ids, club_ids, position, nationality, confederation, age_min, age_max, birth_year_min, birth_year_max, market_value_min, market_value_max, limit, cursor

most_valuable_clubs

2 cr

Clubs (or national teams) ranked by total squad market value, by league, country or confedera…

required
—
optional
competition_ids, country, confederation, national_teams, limit

free_agents

1 cr

Players without a club, by market value.

required
—
optional
position, nationality, age_min, age_max, market_value_min, market_value_max, last_competition_ids, free_since_from, free_since_to, limit

expiring_contracts

2 cr

Players whose contract ends in a given year (default.

required
—
optional
contract_end_year, competition_ids, position, nationality, age_min, age_max, limit

market_value_updates

2 cr

The newest market-value updates (players Transfermarkt just revalued) with the new value and…

required
—
optional
competition_ids, position, nationality, confederation, age_min, age_max, birth_year_min, birth_year_max, market_value_min, market_value_max, limit

coach

2 cr

A coach's profile and career.

required
coach_id
optional
—

coach_stats

2 cr

A coach's record per club, season and competition.

required
coach_id
optional
season, competition_ids, club_ids, national_team

coach_achievements

2 cr

Every title and award a coach won.

required
coach_id
optional
—

referee

1 cr

A referee's profile.

required
referee_id
optional
—

match

3 cr

A match report.

required
game_id
optional
—

news

1 cr

Transfermarkt news about a player, club, competition, coach, referee or match (or the latest…

required
—
optional
player_id, club_id, competition_id, coach_id, referee_id, game_id, page, limit

fifa_ranking

1 cr

The FIFA men's world ranking as Transfermarkt lists it.

required
—
optional
date, confederation

reference_data

0 cr

Transfermarkt's lookup tables.

required
type
optional
—

Every parameter, every allowed value →

Missing a Transfermarkt endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
How it works

How the Transfermarkt API works

Transfermarkt is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

01
Authenticate
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 694 engines.

02
Call
POST /transfermarkt/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

03
Pay
0 or 1 or 2 or 3 credits per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

04
Read
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

From a league to every squad, value and transfer

Start from a league code, read its clubs and squads, then each player's value history and transfers.

01competition?competition_id=GB1
GET/transfermarkt/v1/competition?competition_id=GB1

The league with every club's squad size, average age and total market value.

02club_squad?club_id=281
GET/transfermarkt/v1/club_squad?club_id=281

Every player as a full card: position, age, citizenship, market value, contract expiry, agent; plus the squad total the site prints.

03player_market_value?player_id=418560
GET/transfermarkt/v1/player_market_value?player_id=418560

Every valuation with date, club and age, the highest and lowest value, and the rank among all players.

04player_transfers?player_id=418560
GET/transfermarkt/v1/player_transfers?player_id=418560

Every move: both clubs with league and country, fee as printed and in euros, market value at the time, contract length.

A league-wide table of players with today's value, their value curve and their transfer record, ready for scouting, fantasy or valuation models.

request
curl -X POST https://api.reefapi.com/transfermarkt/v1/player \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"player_id":"418560"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "transfermarkt",
    "endpoint": "player",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

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.

Coverage

Transfermarkt coverage, measured

Every number below was read from live transfermarkt.com on 2026-11-16, in two runs of 470 calls across all 47 actions.

Values checked

Market value matched the profile page on 8 of 8 players; the last transfer's fee and market value at the time matched the site's transfer history on 8 of 8; the squad total matched the club page on 4 of 4 clubs.

Players

Profiles, value history, transfers, stats per season × competition × club, match logs, injuries and absences, national-team career, titles, squad numbers, rumours and upcoming games.

Clubs and leagues

Squads, squad statistics, transfers with spending and income, fixtures, staff, stadium, trophies, league placements in every season (Manchester City: 116 seasons), record signings and sales; league tables, fixtures, transfers (Premier League 2025/26: 714), top scorers, champions.

Filters that bite

Each was compared with the unfiltered call in the same run, e.g. most valuable players position=goalkeeper 50 of 50 goalkeepers, age_max=21 50 of 50 aged 21 or less; transfer ticker to_country=England 50 of 50; advanced search caps_min=100 25 of 25.

Identity

6 of 6 players, 3 of 3 clubs and 2 of 2 competitions found by search came back as the same record in their detail action, with the same name and market value.

Limits

Ranking lists (most valuable, top scorers, free agents, expiring contracts, transfer ticker) stop at 100 rows per call; the advanced search at 250 hits; a past season's squad shows today's market values; a cup has no transfer list of its own.

Use cases

What people build with Transfermarkt

The jobs this data is most often used for.

47

endpoints

0/1/2/3

credits per call

01

Track market values and their history for a list of players or a whole league.

02

Pull every transfer with fee, clubs and contract length for a club, a league or a season.

03

Build scouting shortlists by position, age, citizenship, value and contract expiry.

04

Feed fantasy and media apps with squads, tables, fixtures, line-ups and top scorers.

Pricing

What Transfermarkt data costs

The cheapest call here is 0 credits, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

Full pricing →
$0.67–$1.50 / 1,000 credits
  • 1,000 free credits on signup, no card
  • One key, all 694 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
curl -X POST https://api.reefapi.com/transfermarkt/v1/player \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"player_id":"418560"}'
python
import os
import requests

REEF_KEY = os.environ["REEF_KEY"]

r = requests.post(
    "https://api.reefapi.com/transfermarkt/v1/player",
    headers={"x-api-key": REEF_KEY},
    json={
        "player_id": "418560"
    },
    timeout=90,
)
print(r.json()["data"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up Transfermarkt.

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.

Same key

43 Media, Film & Knowledge APIs on the same key

One key, one credit pool, one response envelope. If you are pulling Transfermarkt, you are one call away from the rest of the category — no second contract, no second integration.

Contact

Need something this API does not do?

Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.

0/4000

No account needed · we reply from [email protected]

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 693 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-16.