Live

list_expiring_contracts

transfermarkt.com.br

Returns one market-value-sorted page of players with expiring contracts in a Transfermarkt competition from https://transfermarkt.com.br, including complete player, club and contract fields.

Sports Finance

Parameters3

Runs7

Updated3d ago

Operational7 runs · 100% succeeded

30 days ago90 days agoranfailednot checkedtoday

Playground

GETlist_expiring_contracts GETget_club_squad GETget_player_page_data GETget_club_overview GETget_player_profile GETlist_free_agents GETget_player_performance_stats GETget_agency_details GETsearch_players GETlist_competition_clubs GETget_player_transfer_history GETget_player_market_value_history

Runs on Notte and spends your workspace credits — what comes back is the live response, not a sample.

Parameters

competition_idstr= GB1

expiry_yearint= 0

pageint= 1

Need another parameter? Ask the agent →

Waiting on your first callSet the parameters on the left and test it — the real response shows up right here.

What is list_expiring_contracts?

Returns one market-value-sorted page of players with expiring contracts in a Transfermarkt competition from https://transfermarkt.com.br, including complete player, club and contract fields. It runs on Notte's browser infrastructure and returns structured JSON, so you can call it like any other API — pass competition_id, expiry_year, page and get the result back without maintaining a scraper.

Response

{
  "page": 0,
  "players": [
    {
      "age": 0,
      "name": "<string>",
      "club_id": 0,
      "agent_id": 0,
      "club_url": "<string>",
      "fee_paid": "<string>",
      "position": "<string>",
      "agent_url": "<string>",
      "club_name": "<string>",
      "club_slug": "<string>",
      "image_url": "<string>",
      "player_id": 0,
      "agent_name": "<string>",
      "agent_slug": "<string>",
      "player_slug": "<string>",
      "profile_url": "<string>",
      "fee_paid_eur": 0,
      "market_value": "<string>",
      "club_logo_url": "<string>",
      "date_of_birth": "<string>",
      "nationalities": [
        "<string>"
      ],
      "contract_until": "<string>",
      "contract_option": "<string>",
      "market_value_eur": 0,
      "nationality_flag_urls": [
        "<string>"
      ],
      "previous_market_value": "<string>",
      "previous_market_value_eur": 0
    }
  ],
  "page_size": 0,
  "sorted_by": "<string>",
  "expiry_year": 0,
  "total_pages": 0,
  "has_next_page": true,
  "competition_id": "<string>",
  "returned_count": 0,
  "competition_name": "<string>"
}

Call it

curl --location 'https://us-prod.notte.cc/functions/743a428d-da7e-4a04-b0a2-aad8338d6926/runs/start' \
--header 'x-notte-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{
    "function_id": "743a428d-da7e-4a04-b0a2-aad8338d6926",
    "variables": {
        "competition_id": "GB1",
        "expiry_year": 0,
        "page": 1
    }
}'

Ask an agent

Paste this into Claude Code, Cursor or any MCP client to have an agent call this function for you.

prompt

Use the Anything API MCP server (https://anything.notte.cc/mcp).

Call run(function_id="743a428d-da7e-4a04-b0a2-aad8338d6926") — the "list_expiring_contracts" function, which returns one market-value-sorted page of players with expiring contracts in a Transfermarkt competition from https://transfermarkt.com.br, including complete player, club and contract fields..

It takes competition_id (str), expiry_year (int), page (int). Return the result as structured JSON.