# Transfermarkt Scraper: Player Market Values, Squads, Transfers (`themineworks/transfermarkt-scraper`) Actor

Scrape Transfermarkt players, club squads, league tables and transfer windows by name, link or league code: market value and full value history, position, age, nationality, club, contract end, agency, career transfers and season stats. Any country site. No login.

- **URL**: https://apify.com/themineworks/transfermarkt-scraper.md
- **Developed by:** [The Mine Works](https://apify.com/themineworks) (community)
- **Categories:** Sports, Automation, Developer tools
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.70 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Transfermarkt Scraper: Player Market Values, Squads, Transfers

[![33 Transfermarkt players with market value, value history and transfers in 6 seconds](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/transfermarkt-scraper-hero.png)](https://console.apify.com/actors/yedsYqcBl2SXppkYd/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

Returns Transfermarkt players, club squads, league tables and transfer windows by name, link or league code: one row per player with market value, full value history, position, age, nationality, club, contract end, agency, career transfers and optional season stats; one row per club with table position and squad value; one row per transfer with fee, loan flag and both clubs. No login, no cookies, no API key. You pay $0.90 per 1,000 rows on the Free plan and $0.70 per 1,000 on the Gold plan, plus a $0.003 start fee per run.

**Part of The Mine Works More tools family:** [G2 Reviews Scraper](https://apify.com/themineworks/g2-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Naver Blog Scraper](https://apify.com/themineworks/naver-blog-posts-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [WeChat Article Scraper 微信公众号文章](https://apify.com/themineworks/wechat-article-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Taobao Products Scraper 淘宝 天猫](https://apify.com/themineworks/taobao-products-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [MLB Stats API Scraper](https://apify.com/themineworks/mlb-stats-api-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Flashscore Tennis Scraper](https://apify.com/themineworks/flashscore-tennis-results-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral).

Updated 17 Nov 2026: first release. Player names, profile links and ids, club squads (any season), club transfers, league tables with squad values, every squad of a league, and every transfer of a league for a season and window (summer or winter). Links from any Transfermarkt country site work. Bookmark this Actor on its Store page so it is one click away next time.

### Why choose this actor?

- **Market values as numbers, with the full history.** Every player row has `market_value_eur` as a plain number next to the shown `€220.00M`, the previous and highest value with their dates, and `market_value_history`: every value Transfermarkt has published for that player, with date, club and age. Sort a squad by value or chart a career without cleaning text.
- **A whole league in one run.** Give `GB1` and pick what you want back: the 20 clubs with table and squad value, all 547 players of the 20 squads (45 seconds in our test on Apify), or every arrival and departure of a transfer window (640 summer 2025 transfers in about 15 seconds).
- **Fast and steady.** It reads the same JSON that transfermarkt.com loads in your browser, not the HTML pages, so it does not run into the block that Transfermarkt shows after a dozen quick page views. Our test runs returned 1,849 of 1,850 rows with every core field (one young keeper has no market value on Transfermarkt yet).

[![Run it on Apify](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/button-run.png)](https://console.apify.com/actors/yedsYqcBl2SXppkYd/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

### Try it in one minute

Paste this into the input (JSON view) and press Start. It returns Erling Haaland, Lionel Messi and the 31 players of Liverpool's squad, each with market value, value history and transfers. It took 6 seconds in our test run on Apify:

```json
{
  "players": ["Erling Haaland", "https://www.transfermarkt.com/lionel-messi/profil/spieler/28003"],
  "clubs": ["https://www.transfermarkt.co.uk/liverpool-fc/startseite/verein/31"],
  "maxItems": 100
}
```

#### Copy to your AI assistant

```text
Run the Apify actor themineworks/transfermarkt-scraper with input {"competitions": ["GB1"], "competitionOutput": "players", "maxItems": 600} through POST https://api.apify.com/v2/acts/themineworks~transfermarkt-scraper/run-sync-get-dataset-items?token=<MY_APIFY_TOKEN>, then give me a table of the 20 most valuable players with club, position, age, market value and contract end.
```

### Key features

- Players by name (best match, or up to 10 matches per name), by profile link from any Transfermarkt country site, or by id.
- Club squads of the current or any past season, with the shirt number of that season.
- Club transfers of a season: arrivals and departures with fee, loan, end of loan, market value at the time and the other club.
- Leagues by link or code (GB1, ES1, L1, IT1, FR1, MLS1 and every other league Transfermarkt covers): clubs with table, points, goals and squad value; every squad; or every transfer of a window.
- Market value history, career transfers and season stats (appearances, starts, goals, assists, minutes, cards per season and competition) on each player row, same price per row.
- Agency name as listed on the profile, contract end, last renewal, boot supplier, other positions, second nationality.
- Links in the output point to the Transfermarkt site you choose: .com, .co.uk, .us, .de, .es, .it, .fr and more.

### How to use it

#### Basic: players by name

```json
{
  "players": ["Kylian Mbappe", "Jude Bellingham", "Bukayo Saka", "Lamine Yamal"]
}
```

One row per player. A typed name returns the best match; set `searchResultsPerName` to 5 to get everyone with that name.

#### Scouting: profiles with three seasons of stats

```json
{
  "players": ["Cole Palmer", "Florian Wirtz", "Jamal Musiala"],
  "includeSeasonStats": true,
  "statsSeasons": 3
}
```

`season_stats` holds one entry per season, competition and team (club and national team apart).

#### Every player of a league

```json
{
  "competitions": ["https://www.transfermarkt.com/premier-league/startseite/wettbewerb/GB1"],
  "competitionOutput": "players",
  "maxItems": 1000
}
```

#### A transfer window, league wide

```json
{
  "competitions": ["GB1", "ES1"],
  "competitionOutput": "transfers",
  "season": 2025,
  "transferWindow": "summer",
  "maxItems": 5000
}
```

One row per arrival or departure of each club, as on Transfermarkt's league transfer page. A move between two clubs of the same league shows on both clubs' lists, once as `in` and once as `out`; use `transfer_id` to count each move once.

#### League tables with squad values

```json
{
  "competitions": ["L1", "IT1", "FR1"],
  "competitionOutput": "clubs"
}
```

#### A club's squad in a past season

```json
{
  "clubs": ["https://www.transfermarkt.de/fc-liverpool/kader/verein/31/saison_id/2015"]
}
```

A link with `saison_id` reads that season. Or give the club and set `season` (start year: 2015 means 2015/16).

### Input parameters

| Field | What it does |
|---|---|
| `players` | Player names, profile links from any Transfermarkt site, or ids. |
| `clubs` | Club links, ids or names. |
| `clubOutput` | `squad` (one row per player, default) or `transfers` (one row per arrival or departure). |
| `competitions` | League links, codes like GB1, or names. |
| `competitionOutput` | `clubs` (default), `players` or `transfers`. |
| `season` | Start year of the season, 2025 means 2025/26. Empty means the current season. |
| `transferWindow` | `all` (default), `summer` (May to October) or `winter` (November to April). |
| `includeMarketValueHistory` | Every published market value on each player row. On by default. |
| `includeTransferHistory` | Career transfers on each player row. On by default. |
| `includeSeasonStats` | Stats per season and competition on each player row. Off by default. |
| `statsSeasons` | How many recent seasons the stats cover, default 3. |
| `searchResultsPerName` | Matches per typed name, 1 to 10, default 1. |
| `domain` | Which Transfermarkt site the output links use, default .com. |
| `maxItems` | Most rows of the whole run, default 1,000. |

### What data do you get?

Every row has `record_type`: `player`, `club` or `transfer`.

**Player rows**: `player_id`, `name`, `full_name`, `first_name`, `last_name`, `profile_url`, `image_url`, `date_of_birth`, `age`, `place_of_birth`, `country_of_birth`, `nationality`, `nationalities`, `height_m`, `foot`, `position`, `position_short`, `position_group`, `other_positions`, `club_id`, `club_name`, `club_url`, `club_country`, `league_id`, `league_name`, `status`, `shirt_number`, `is_captain`, `joined_club`, `contract_until`, `last_contract_renewal`, `agency`, `outfitter`, `market_value_eur`, `market_value`, `market_value_date`, `previous_market_value_eur`, `highest_market_value_eur`, `highest_market_value_date`, `market_value_history`, `transfer_history`, `season_stats`, and for squad rows `source_club`, `source_season`, `squad_shirt_number`.

**Club rows**: `club_id`, `club_name`, `short_name`, `club_url`, `crest_url`, `club_country`, `city`, `street`, `postcode`, `latitude`, `longitude`, `club_colors`, `league_id`, `league_name`, `season`, `table_position`, `points`, `played`, `wins`, `draws`, `losses`, `goals_for`, `goals_against`, `goal_difference`, `table_note`, and for the current season `squad_size`, `average_age`, `squad_market_value_eur`, `average_market_value_eur`.

**Transfer rows**: `transfer_id`, `transfer_url`, `player_id`, `name`, `profile_url`, `position`, `nationality`, `age`, `date`, `season`, `window`, `from_club`, `from_league_id`, `from_country`, `to_club`, `to_league_id`, `to_country`, `fee_eur`, `fee`, `transfer_type` (transfer, loan, end of loan, internal), `is_loan`, `is_pending`, `market_value_eur`, `contract_until`, `club_name`, `direction`.

#### Output example

```json
{
  "record_type": "player",
  "player_id": "937958",
  "name": "Lamine Yamal",
  "profile_url": "https://www.transfermarkt.com/lamine-yamal/profil/spieler/937958",
  "date_of_birth": "2007-07-13",
  "age": 19,
  "nationality": "Spain",
  "height_m": 1.83,
  "foot": "left",
  "position": "Right Winger",
  "other_positions": ["Left Winger"],
  "club_name": "FC Barcelona",
  "league_name": "LaLiga",
  "shirt_number": 10,
  "joined_club": "2023-07-01",
  "contract_until": "2031-06-30",
  "agency": "Gestifute",
  "market_value_eur": 220000000,
  "market_value": "€220.00M",
  "market_value_date": "2026-07-22",
  "highest_market_value_eur": 220000000,
  "market_value_history": [
    { "date": "2026-07-22", "value_eur": 220000000, "value": "€220.00M", "club_name": "FC Barcelona", "age": 19 }
  ],
  "season_stats": [
    { "season": "26/27", "competition": "LaLiga", "club": "FC Barcelona", "appearances": 12, "starts": 12, "goals": 10, "assists": 8, "minutes": 995, "yellow_cards": 2, "red_cards": 0 }
  ]
}
```

```json
{
  "record_type": "transfer",
  "transfer_id": "5911786",
  "name": "Alexander Isak",
  "position": "Centre-Forward",
  "age": 25,
  "date": "2025-09-01",
  "season": "25/26",
  "window": "summer",
  "from_club": "Newcastle United",
  "to_club": "Liverpool FC",
  "fee_eur": 145000000,
  "fee": "€145.00M",
  "transfer_type": "transfer",
  "is_loan": false,
  "market_value_eur": 120000000,
  "club_name": "Liverpool FC",
  "direction": "in"
}
```

### Pricing

Pay per event: you pay for the rows you receive, plus a flat $0.003 per run, whatever memory you choose. Value history, transfer history and season stats cost nothing extra.

| Event | When it is charged | Free plan | Bronze (Starter) | Silver (Scale) | Gold (Business) |
|---|---|---|---|---|---|
| `result-scraped` | Once per player, club or transfer row stored in your dataset | $0.90 per 1,000 | $0.84 per 1,000 | $0.77 per 1,000 | $0.70 per 1,000 |
| `run-start` | Once per run, after the first input returned rows | $0.003 | $0.003 | $0.003 | $0.003 |

Apify's free plan includes $5 of credit every month, which covers about 5,500 rows at this price.

Never charged:

- inputs that are not Transfermarkt links, and names that match nothing (each gets an error row);
- a row that a second input of the same run finds again;
- rows past your `maxItems`;
- the summary, info and error rows;
- a run whose inputs return nothing: the start fee is charged only once an input has returned rows;
- anything past your "Max cost per run". The actor checks the budget before each batch of rows and stops while the total is still below your limit, so the run ends SUCCEEDED with a partial result and a status message saying so.

### How it compares

| Actor | Price per 1,000 on the Free plan | Price per 1,000 on Gold | Start fee | Input | Whole league in one run |
|---|---|---|---|---|---|
| **This actor** | $0.90 | $0.70 | $0.003 per run | Names, links, ids, league codes | Clubs, players or transfers |
| [Transfermarkt Scraper (curious_coder)](https://apify.com/curious_coder/transfermarkt?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $1.00 | $1.00 | $0.00005 per run | One start link, crawl depth (stated) | By crawling from a league link (stated) |
| [Transfermarkt Scraper (data_xplorer)](https://apify.com/data_xplorer/transfermarkt-api-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $1.50 | $0.75 | $0.10 per run | Names or links, up to 200 per run (stated) | Competition transfers (stated) |
| [Transfermarkt Scraper (webdatalabs)](https://apify.com/webdatalabs/transfermarkt-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $10.00 per 1,000 players | $7.00 per 1,000 players | $0.0004 per run | Player links (stated) | not stated |

Checked 17 Nov 2026 from the public Store listings.

### Run it on a schedule

Market values change a few times a year per player and transfer windows move daily in summer and January. In Apify Console open this Actor, then Schedules, Add schedule, pick how often (daily during a window, monthly for values) and save. Each run uses the same input and adds a new dataset you can compare with the last one.

### FAQ

#### What does this actor read?

Transfermarkt's own public data: the JSON that transfermarkt.com pages load in your browser for player profiles, market values, transfers, squads, league tables and game stats. Typed names are looked up with Transfermarkt's search. Nothing behind a login is read.

#### Do I need an account, cookies or an API key?

No. Paste names, links or league codes and press Start.

#### Which Transfermarkt sites work?

Links from any country site work as input (.com, .co.uk, .us, .de, .es, .it, .fr, .nl, .pt, .com.tr, .com.br, .pl, .world and others): player and club ids are the same on every site. Labels in the output are in English; `domain` sets which site the output links open.

#### Why does a player have no market value?

Transfermarkt has not valued every player, often young reserve players and retired players. The field is then left out of the row.

#### Why do past-season club rows have no squad value?

Transfermarkt gives today's squad figures only. For a past season the actor returns the table but leaves the squad size, age and value empty, so no row carries today's numbers under an old season.

#### How are summer and winter windows split?

By the transfer date: May to October is summer, November to April is winter, within the season you choose.

#### How many rows can I get?

Up to 100,000 per run. A Premier League squad is about 30 players, all 20 squads about 550, and a summer window about 640 transfers.

#### How fast is it?

33 players with value history and transfers took 6 seconds on Apify; 547 players of a league took 45 seconds; 1,202 transfers of two leagues took 28 seconds. Season stats make each player slower for long careers.

#### Which formats can I download?

JSON, CSV, Excel, XML, HTML table or RSS from the dataset, or the API.

#### Can I use it from Claude, ChatGPT or Cursor (MCP)?

Yes, through Apify's MCP server. Connector URL: https://mcp.apify.com/?tools=themineworks/transfermarkt-scraper

- Claude: Settings > Connectors > Add custom connector, paste the URL, sign in with Apify.
- ChatGPT: turn on developer mode, add an MCP connector with the URL, sign in with Apify.
- Cursor or VS Code: add it as an HTTP MCP server with that URL.
- Claude Code: `claude mcp add -t http transfermarkt-scraper "https://mcp.apify.com/?tools=themineworks/transfermarkt-scraper"`

#### Is it legal to scrape Transfermarkt?

The actor reads only public data that anyone can see on transfermarkt.com without logging in. Player rows describe professional footballers as Transfermarkt publishes them; the agency is the company name shown on the profile, with no contact details. You are responsible for how you use the data, including Transfermarkt's terms, database rights and data protection law such as GDPR. This is general information, not legal advice.

### Integrations

- **Google Sheets**: send each run's rows to a sheet with Apify's Google Sheets integration.
- **Make, Zapier and n8n**: start a run and read its dataset with the Apify apps and nodes, for example "new arrivals in our league every morning to Slack".
- **Webhooks**: have Apify call your URL when a run succeeds, then fetch the dataset.
- **API and SDKs**: run it from Python or JavaScript with the Apify client, or with a plain HTTP call (see "Copy to your AI assistant" above).
- **MCP clients**: Claude, ChatGPT, Cursor and VS Code can run it as a tool through the connector URL in the FAQ.

If this actor saved you time, a short rating on the Store helps other buyers find it.

### More from The Mine Works

**More tools**

- [G2 Reviews Scraper](https://apify.com/themineworks/g2-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naver Blog Scraper](https://apify.com/themineworks/naver-blog-posts-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [WeChat Article Scraper 微信公众号文章](https://apify.com/themineworks/wechat-article-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Taobao Products Scraper 淘宝 天猫](https://apify.com/themineworks/taobao-products-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [MLB Stats API Scraper](https://apify.com/themineworks/mlb-stats-api-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Flashscore Tennis Scraper](https://apify.com/themineworks/flashscore-tennis-results-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Kwai Video Scraper](https://apify.com/themineworks/kwai-video-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Capterra Reviews Scraper](https://apify.com/themineworks/capterra-software-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LandWatch Scraper](https://apify.com/themineworks/landwatch-land-for-sale-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Lens OCR Scraper](https://apify.com/themineworks/google-lens-ocr-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Hotels Prices Scraper](https://apify.com/themineworks/google-hotels-prices-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Tennis Match & Player Data Scraper](https://apify.com/themineworks/tennis-match-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Social media and video**

- [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Leads and business directories**

- [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Skip Trace Lookup](https://apify.com/themineworks/skip-trace-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Maps Email Scraper](https://apify.com/themineworks/maps-leads?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [2GIS Places Scraper](https://apify.com/themineworks/2gis-places-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Marketing, SEO and reviews**

- [Facebook Ad Library Scraper](https://apify.com/themineworks/meta-ad-library-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Ads Transparency Scraper](https://apify.com/themineworks/google-ads-transparency?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Similarweb Scraper](https://apify.com/themineworks/similarweb-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google News Scraper](https://apify.com/themineworks/google-news?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**LinkedIn**

- [LinkedIn Company Scraper](https://apify.com/themineworks/linkedin-company-details?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Post Scraper](https://apify.com/themineworks/linkedin-post-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Employees Scraper](https://apify.com/themineworks/linkedin-employees?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Profile Scraper](https://apify.com/themineworks/linkedin-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Real estate**

- [Zillow Rentals Scraper](https://apify.com/themineworks/zillow-rental-listings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zillow Sold Comps Scraper](https://apify.com/themineworks/zillow-recently-sold?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Real Estate MCP](https://apify.com/themineworks/india-real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Housing.com Scraper](https://apify.com/themineworks/housing-com-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Science, health and government data**

- [Academic Research MCP](https://apify.com/themineworks/academic-research-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [CourtListener Scraper](https://apify.com/themineworks/courtlistener-court-records?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Socrata Open Data Scraper](https://apify.com/themineworks/socrata-open-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [OpenAlex Scraper](https://apify.com/themineworks/openalex-scholarly-works?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Jobs and hiring**

- [Foundit Monster India Jobs](https://apify.com/themineworks/foundit-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Hirist Jobs Scraper](https://apify.com/themineworks/hirist-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Jobs MCP](https://apify.com/themineworks/india-jobs-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naukri Jobs Scraper](https://apify.com/themineworks/naukri-jobs?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Company and business data**

- [Company Domain Finder](https://apify.com/themineworks/company-domain-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GST Taxpayer Lookup](https://apify.com/themineworks/gst-taxpayer-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Company KYB Resolver](https://apify.com/themineworks/company-identity-resolver?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [SEC EDGAR Filings Scraper](https://apify.com/themineworks/sec-edgar-filings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**E-commerce and marketplaces**

- [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Etsy Listings Scraper](https://apify.com/themineworks/etsy-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Food and local services**

- [NoBroker Scraper](https://apify.com/themineworks/nobroker-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Swiggy Restaurant Scraper](https://apify.com/themineworks/swiggy-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zomato Scraper](https://apify.com/themineworks/zomato-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Developer and AI tools**

- [Website to Markdown Crawler](https://apify.com/themineworks/rag-crawler?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Skill Finder](https://apify.com/themineworks/github-skill-discovery?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Repo Scraper](https://apify.com/themineworks/github-repo-intelligence?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Trending Scraper](https://apify.com/themineworks/github-trending-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

### Support

Found a problem or need a field we do not return? Open an issue in the Issues tab and we will look at it. For new data sources, email dmineworks@gmail.com.

*Transfermarkt Scraper turns names, links and league codes into clean rows of players, clubs and transfers, with market values as numbers and every value Transfermarkt has published.*

# Actor input Schema

## `players` (type: `array`):

Player names, Transfermarkt profile links from any country site (.com, .co.uk, .de, .es, .it, .fr, .us and others) or player ids. Example: Erling Haaland, https://www.transfermarkt.com/lionel-messi/profil/spieler/28003, 342229. One row per player.

## `clubs` (type: `array`):

Club links from any Transfermarkt country site, club ids or club names. Example: https://www.transfermarkt.co.uk/liverpool-fc/startseite/verein/31, 418 (Real Madrid), FC Barcelona. A link with saison_id reads that season. What each club returns is set by 'Club output'.

## `clubOutput` (type: `string`):

squad: one row per player in the club's squad, with the full player profile. transfers: one row per arrival and departure of the season, with fee, loan flag, market value and the other club.

## `competitions` (type: `array`):

League links from any Transfermarkt country site, league codes or league names. Example: https://www.transfermarkt.com/premier-league/startseite/wettbewerb/GB1, ES1 (LaLiga), L1 (Bundesliga), IT1 (Serie A), FR1 (Ligue 1), MLS1. What each league returns is set by 'Competition output'.

## `competitionOutput` (type: `string`):

clubs: one row per club with table position, points, goals, squad size, average age and squad market value. players: every player of every club in the league (one row each). transfers: every arrival and departure of every club in the league for the season and window you choose.

## `season` (type: `integer`):

The season to read for squads, league tables and transfers, as its start year: 2025 means 2025/26. Leave empty for the current season. A club or league link with saison_id overrides this for that link.

## `transferWindow` (type: `string`):

For transfers: all of the season, only the summer window (May to October) or only the winter window (November to April).

## `includeMarketValueHistory` (type: `boolean`):

Each player row gets every market value Transfermarkt has published for that player, with date, value, club and age. Same price per row.

## `includeTransferHistory` (type: `boolean`):

Each player row gets the career transfers: date, season, from club, to club, fee, loan or transfer, market value at the time. Same price per row.

## `includeSeasonStats` (type: `boolean`):

Each player row gets stats per season and competition: appearances, starts, goals, assists, minutes, yellow and red cards. Summed from every game Transfermarkt records. Slower for long careers. Same price per row.

## `statsSeasons` (type: `integer`):

How many of the latest seasons the season stats cover, 1 to 40. Example: 3.

## `searchResultsPerName` (type: `integer`):

For a typed name, how many matches to return, best match first, 1 to 10. Example: 1 for the best match only, 5 for everyone called Haaland.

## `domain` (type: `string`):

The Transfermarkt country site used for the profile, club and transfer links in the output. The data is the same on every site.

## `maxItems` (type: `integer`):

The most rows (players, clubs and transfers together) the whole run returns, 1 to 100,000. A Premier League squad is about 30 players; all 20 squads are about 550. Example: 1000.

## Actor input object example

```json
{
  "players": [
    "Erling Haaland",
    "https://www.transfermarkt.com/lionel-messi/profil/spieler/28003"
  ],
  "clubs": [
    "https://www.transfermarkt.co.uk/liverpool-fc/startseite/verein/31"
  ],
  "clubOutput": "squad",
  "competitionOutput": "clubs",
  "transferWindow": "all",
  "includeMarketValueHistory": true,
  "includeTransferHistory": true,
  "includeSeasonStats": false,
  "statsSeasons": 3,
  "searchResultsPerName": 1,
  "domain": "com",
  "maxItems": 100
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "players": [
        "Erling Haaland",
        "https://www.transfermarkt.com/lionel-messi/profil/spieler/28003"
    ],
    "clubs": [
        "https://www.transfermarkt.co.uk/liverpool-fc/startseite/verein/31"
    ],
    "maxItems": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("themineworks/transfermarkt-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "players": [
        "Erling Haaland",
        "https://www.transfermarkt.com/lionel-messi/profil/spieler/28003",
    ],
    "clubs": ["https://www.transfermarkt.co.uk/liverpool-fc/startseite/verein/31"],
    "maxItems": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("themineworks/transfermarkt-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "players": [
    "Erling Haaland",
    "https://www.transfermarkt.com/lionel-messi/profil/spieler/28003"
  ],
  "clubs": [
    "https://www.transfermarkt.co.uk/liverpool-fc/startseite/verein/31"
  ],
  "maxItems": 100
}' |
apify call themineworks/transfermarkt-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,themineworks/transfermarkt-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/yedsYqcBl2SXppkYd/builds/CbFhDvc1MSNe01E65/openapi.json
