Transfermarkt Scraper

Scrapes sports data from transfermarkt.com. Provide a starting URL (like a player, club, or competition page), and the actor automatically identifies the page type and extracts the relevant structured data.

Key Features

• Automatic Page Type Detection: Works with player, club, competition, and other page types. Just provide the start URL.
• Simple Configuration: Primarily requires just the start URL, with a few optional parameters for control.
• Comprehensive Crawling: Can follow links (crawlDepth) and pagination (pageDepth) to gather data beyond the initial page.
• Structured Output: Returns clean, categorized JSON data ready for analysis.

How to Use

The scraper is designed for extracting data for analysis, such as:
* Scraping live scores and match statistics.
* Monitoring transfer activity and player valuations.
* Collecting historical game data for forecasting models.
* Building data-driven strategies for sports analytics.

Cost: Runs cost approximately 2.5 USD in platform credits per 1000 scraped results on the basic plan. Check your usage in the Apify Console under Settings -> Usage and Billing. For full pricing details, see the platform pricing page.

Tutorial: For a detailed guide, read the Transfermarkt scraper tutorial on the Apify blog.

Input Parameters

Configure the actor using these input fields:

• startUrls (required): An array of one or more Transfermarkt URLs to begin scraping from.
• parallels (optional, default: 1): Number of parallel crawler sessions.
• crawlDepth (optional, default: 1): How many link levels deep to crawl from the start page(s). Set to 1 for the start page only.
• pageDepth (optional, default: 99999): How many pagination pages to scrape. The default is effectively unlimited.

Input Example

{
  "startUrls": [
    { "url": "https://www.transfermarkt.com/lionel-messi/profil/spieler/28003" }
  ],
  "proxyConfig": { "useApifyProxy": true },
  "crawlDepth": 1,
  "pageDepth": 1
}

Output

Results are stored in an Apify Dataset. You can download them in JSON, CSV, XML, and other formats after the run completes.

Output Example (Player Page)

{
  "id": "28003",
  "url": "https://www.transfermarkt.com/lionel-messi/profil/spieler/28003",
  "type": "player",
  "Name in home country": "Lionel Andrés Messi Cuccitini",
  "Date of birth/Age": "Jun 24, 1987 (37)",
  "Place of birth": "Rosario",
  "Height": "1,70 m",
  "Citizenship": ["Argentina", "Spain"],
  "Position": "Attack - Right Winger",
  "Foot": "left",
  "Player agent": "Relatives",
  "Current club": "Inter Miami CF",
  "Joined": "Jul 15, 2023",
  "Contract expires": "Dec 31, 2025",
  "Outfitter": "adidas",
  "transfers": [
    {
      "Season": "23/24",
      "Date": "Jul 15, 2023",
      "Left": "Paris SG",
      "Joined": "Miami",
      "MV": "€35.00m",
      "Fee": "free transfer"
    }
  ]
}