agent-data
Start free
Catalog / Transfermarkt

Transfermarkt API

transfermarkt.com

Read-only live access to Transfermarkt player search, profiles, top market values, transfer histories, and market value histories.

  • Sports
  • football
  • players
  • transfermarkt
  • market-values
Connect your agent Call over HTTP
5 endpointsDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.

Then ask your agent to use the Transfermarkt API for your task.

Call it over HTTP

Get an API key

Sign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.

Get top market values

View call pricing
cURL · Top market values
curl --request GET --get 'https://api.agent-data.dev/transfermarkt-com/v1/top-market-values' \
  --header "Authorization: Bearer $AGENT_DATA_API_KEY"

Endpoints

Inputs and response fields for every endpoint in this API.

GETTop market values/v1/top-market-values

Get top market values

Input

No input parameters.

Response

playersobject[]
players[].idinteger
players[].namestring
players[].profile_urlstring
players[].market_value?string | null
total_playersinteger

Fields marked ? are optional.

GETSearch players/v1/search-players

Search football players

Input

queryRequiredQuery · string

Search keyword — player name or partial name

Example: Kylian Mbappe

pageOptionalQuery · integer, min: 1, max: 100, default: 1

1-based result page

Example: 1

Response

pageinteger
querystring
playersobject[]
players[].idinteger
players[].namestring
players[].profile_urlstring
players[].market_value?string | null
total_hitsinteger
total_pagesinteger

Fields marked ? are optional.

GETPlayer profile by player id/v1/player-profile/{player_id}

Get player profile

Input

player_idRequiredPath · integer, min: 1

Transfermarkt player ID

Example: 342229

Response

idinteger
ageinteger | null
namestring
heightstring | null
positionstring | null
full_namestring | null
profile_urlstring
market_valuestring | null
portrait_urlstring | null
date_of_birthunknown | null
contract_untilstring | null
preferred_footstring | null
GETPlayer transfers by player id/v1/player-transfers/{player_id}

Get player transfers

Input

player_idRequiredPath · integer, min: 1

Transfermarkt player ID

Example: 342229

Response

fee_sumobject | null
player_idinteger
transfersobject[]
transfers[].idstring
total_transfersinteger
GETPlayer market value history by player id/v1/player-market-value-history/{player_id}

Get player market value history

Input

player_idRequiredPath · integer, min: 1

Transfermarkt player ID

Example: 342229

Response

historyobject[]
history[].ageinteger
history[].clubIdstring
history[].playerIdstring
history[].seasonIdinteger
history[].marketValueobject
club_idsstring[]
player_idinteger
current_valueinteger | null
total_entriesinteger

Don’t see the endpoint you need?

Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.