# Bundesliga Stats Scraper (`acquistion-automation/bundesliga-stats-scraper`) Actor

Scrapes official Bundesliga player leaderboards by stat category and season. Returns each player's rank, name, club, nationality, and stat total as a flat row.

- **URL**: https://apify.com/acquistion-automation/bundesliga-stats-scraper.md
- **Developed by:** [Acquisition Automation Co.](https://apify.com/acquistion-automation) (community)
- **Categories:** News, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $7.50 / 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

![Acquisition Automation Co. Search less. Close more.](https://api.apify.com/v2/key-value-stores/AOdPHdOpeDpzEPS5f/records/banner.jpg)

## ⚽ Bundesliga Stats Scraper

> **Export any official Bundesliga player leaderboard as flat rows: rank, player, club, the stat value, and the season it belongs to.** 19 stat categories, from goals and assists to top speed, sprints and pass accuracy. No API key, no account, no login.

`bundesliga.com` publishes a ranked leaderboard for each stat category and each season. The pages are built for reading, not for exporting: there is no public API, no download button, and the numbers reset when you change the category. This Actor reads one leaderboard per run and writes every player on it into a dataset you can open in a spreadsheet.

| Who uses it | What they use the leaderboards for |
|---|---|
| 📈 Football data analysts | Building season-over-season tables of the same stat across players and clubs |
| 🎲 Model builders | Feeding current-season form into prediction and pricing models |
| 📰 Sports journalists | Pulling the top of a category with exact numbers for a match preview |
| 🔍 Scouts and agency analysts | Shortlisting players who lead a specific category, with the club attached |

### 📋 What it does

> 💡 **Why it matters:** one leaderboard is a screenshot. Nineteen categories across several seasons, in one schema, is a dataset.

- 🏆 **Reads one leaderboard per run.** Pick the category and the Actor returns it in rank order, starting at 1.
- 📊 **19 categories.** `goals`, `assists`, `shots`, `woodwork`, `saves`, `crosses`, `tackles`, `aerialDuels`, `topSpeed`, `yellowCards`, `cards`, `passAccuracy`, `distance`, `sprints`, `intensiveRuns`, `penalties`, `penaltiesScored`, `foulsDrawn` and `ownGoals`.
- 📅 **Any season.** Leave `season` empty for the current one, or pass an official identifier such as `DFL-SEA-0001K8` for 2024/25.
- 🆔 **Stable player and season IDs.** `playerId` and `season` are the league's own identifiers, so runs from different categories join cleanly.
- 🖼 **Player and club images.** Each row carries the official player photo and club crest URL.
- 💾 **Exports to CSV, Excel, JSON or XML**, from the run page or the API.

### 📊 Output

Every player on the leaderboard is one flat row. 11 fields, the same in every category.

| Field | Type | Description |
|---|---|---|
| 🥇 `rank` | integer | Position on the leaderboard, starting at 1 |
| 👤 `player` | string | Player name as the league prints it |
| 🛡 `team` | string | Club the player is listed under for that season |
| 🆔 `playerId` | string | Official league player identifier, for example `DFL-OBJ-J00ZZ3` |
| 📊 `statCategory` | string | The category this row belongs to, for example `goals` |
| 🔢 `statValue` | number | The value for that category. Goals scored, kilometres run, pass accuracy, depending on the category |
| 📅 `season` | string | Official season identifier, for example `DFL-SEA-0001K9` |
| 🖼 `imageUrl` | string | Official player photo |
| 🏴 `teamLogoUrl` | string | Official club crest, as an SVG URL |
| 🕒 `scrapedAt` | string | ISO timestamp of collection |
| ⚠️ `error` | string | `null` on a normal row |

#### Example rows

```json
{
  "imageUrl": "https://assets.bundesliga.com/player/dfl-obj-j00zz3-dfl-clu-00000g-dfl-sea-0001k9.png",
  "rank": 1,
  "player": "Harry Kane",
  "team": "FC Bayern München",
  "teamLogoUrl": "https://assets.bundesliga.com/clublogos/DFL-SEA-0001K9/DFL-CLU-00000G.svg",
  "playerId": "DFL-OBJ-J00ZZ3",
  "statCategory": "goals",
  "statValue": 36,
  "season": "DFL-SEA-0001K9",
  "scrapedAt": "2026-09-14T17:23:56.999Z",
  "error": null
}
```

```json
{
  "imageUrl": "https://assets.bundesliga.com/player/dfl-obj-0027yk-dfl-clu-00000d-dfl-sea-0001k9.png",
  "rank": 2,
  "player": "Deniz Undav",
  "team": "VfB Stuttgart",
  "teamLogoUrl": "https://assets.bundesliga.com/clublogos/DFL-SEA-0001K9/DFL-CLU-00000D.svg",
  "playerId": "DFL-OBJ-0027YK",
  "statCategory": "goals",
  "statValue": 19,
  "season": "DFL-SEA-0001K9",
  "scrapedAt": "2026-09-14T17:23:57.101Z",
  "error": null
}
```

### ✨ Why choose this Actor

| | What you get |
|---|---|
| **The league's own numbers** | Data comes from the official Bundesliga leaderboards, not from an aggregator. |
| **No credentials** | The pages are public. No key, no account, no scraping setup of your own. |
| **19 categories, one schema** | Every category returns the same 11 fields, so datasets append and join on `playerId`. |
| **Past seasons included** | Pass a season identifier and get that season's table instead of the current one. |
| **You pay per row** | No subscription. A run that returns nothing costs nothing. |

### 🚀 How to use it

1. [Create a free Apify account](https://console.apify.com/sign-up). New accounts start with $5 of credit.
2. Open the Actor and select **Try for free**.
3. Pick a `statCategory`.
4. Leave `season` empty for the current season, and set `maxItems` to cap the run.
5. Select **Start**, then export from the **Dataset** tab as CSV, Excel, JSON or XML.

A first run:

```json
{
  "statCategory": "goals",
  "maxItems": 10
}
```

A past season, deeper into the table:

```json
{
  "statCategory": "tackles",
  "season": "DFL-SEA-0001K8",
  "maxItems": 200
}
```

### ⚙️ Input

| Field | Required | Description |
|---|---|---|
| `statCategory` | No | Which leaderboard to read. One of the 19 categories listed above. Default `goals` |
| `season` | No | Official season identifier, for example `DFL-SEA-0001K8` for 2024/25. Empty means the current season |
| `maxItems` | No | How many players to collect per run. Free plan is capped at 10 |

### 💰 Pricing

Pay per result. No subscription, and no Apify platform usage on top.

| Apify plan | Free | Bronze | Silver | Gold | Platinum | Diamond |
|---|---|---|---|---|---|---|
| Per player row | $0.0085 | $0.00817 | $0.00783 | $0.0075 | $0.0075 | $0.0075 |

| Rows collected | Cost on the Free plan |
|---|---|
| 100 | $0.85 |
| 1,000 | $8.50 |
| 10,000 | $85.00 |

**Free plan runs** return up to 10 rows as a preview. Any paid Apify plan lifts that to 1,000,000 per run.

### 🔌 Integrate with any app

The dataset is available through the Apify API as soon as the run finishes. Use `run-sync-get-dataset-items` for a one-shot call, webhooks to trigger what happens next, or the Make, Zapier, Airbyte and LangChain integrations listed on the Actor page.

### 🤖 Use with an AI agent

Give an agent live access to the leaderboards over the Model Context Protocol:

```bash
claude mcp add --transport http apify "https://mcp.apify.com?tools=acquistion-automation/bundesliga-stats-scraper"
```

Then ask it in plain language for the top scorers this season and read the result back.

### ❓ Frequently asked questions

**Can I get several categories in one run?**
No. One category per run. Run it once per category and join the datasets on `playerId` and `season`.

**Does a row include the player's nationality, age or position?**
No. A row carries rank, player, club, the stat value, the season and the two image URLs. Nothing else is on the leaderboard.

**What does `statValue` mean?**
Whatever the chosen category measures. Goals for `goals`, kilometres for `distance`, a percentage for `passAccuracy`.

**How do I find a season identifier?**
It appears in the URL on `bundesliga.com` when you switch seasons, in the form `DFL-SEA-0001K8`. An identifier that does not exist returns an empty leaderboard rather than an error.

**Why did I only get 10 rows?**
Free plan runs are capped at 10 as a preview. Any paid plan raises `maxItems` to 1,000,000.

**What can I export?**
CSV, Excel, JSON and XML from the run page, or JSON straight from the API.

### 🔗 More from Acquisition Automation Co.

- [RAWG Video Game Database Scraper](https://apify.com/acquistion-automation/rawg-scraper)
- [Tunefind Soundtracks Scraper](https://apify.com/acquistion-automation/tunefind-soundtracks-scraper)
- [404 Media Articles Scraper](https://apify.com/acquistion-automation/404media-articles-scraper)
- [AirLive Aviation News RSS Scraper](https://apify.com/acquistion-automation/airlive-aviation-news-rss-scraper)
- [Mojang Minecraft Profile Scraper](https://apify.com/acquistion-automation/mojang-minecraft-profile-scraper)

### About Acquisition Automation Co.

We build automation for people buying businesses. The repetitive part of an acquisition search, checking listings, pulling public records, tracking owners and assets, is work a machine should do, so the buyer's time goes into judging deals instead of collecting them.

We add new Actors regularly. If there is a source you need and do not see here, tell us.

### 🆘 Support

Open an issue in the **Issues** tab of this Actor with your run ID, the input you used, and what you expected to get back.

### ⚠️ Disclaimer

This Actor is independent and is not affiliated with, endorsed by, or sponsored by the Deutsche Fußball Liga, the Bundesliga or any club. It collects only publicly available data. You are responsible for using that data in compliance with the source's terms of service and applicable law.

# Actor input Schema

## `statCategory` (type: `string`):

Which leaderboard to scrape (live Bundesliga player ranking categories).

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

Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000

## `season` (type: `string`):

Season identifier (e.g. DFL-SEA-0001K8 for 2024/25). Leave empty for current.

## Actor input object example

```json
{
  "statCategory": "goals",
  "maxItems": 10
}
```

# Actor output Schema

## `results` (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 = {
    "statCategory": "goals",
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("acquistion-automation/bundesliga-stats-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 = {
    "statCategory": "goals",
    "maxItems": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("acquistion-automation/bundesliga-stats-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 '{
  "statCategory": "goals",
  "maxItems": 10
}' |
apify call acquistion-automation/bundesliga-stats-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,acquistion-automation/bundesliga-stats-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/Z8Cla5MWNcO6hNhAg/builds/0vQucrybe5aQV34Uu/openapi.json