# Leagues (catalog) OpenLigaDB Football Matches

**Use case:** 

Extract OpenLigaDB Football Matches data filtered by Leagues (catalog). Export structured results ready for analysis, lead generation, or research.

## Input

```json
{
  "maxItems": 10,
  "mode": "leagues",
  "league": "bl1",
  "season": "2024"
}
```

## Output

```json
{
  "recordType": {
    "label": "Type",
    "format": "text"
  },
  "matchId": {
    "label": "Match ID",
    "format": "text"
  },
  "leagueShortcut": {
    "label": "League",
    "format": "text"
  },
  "leagueName": {
    "label": "League Name",
    "format": "text"
  },
  "leagueSeason": {
    "label": "Season",
    "format": "text"
  },
  "matchDate": {
    "label": "Kickoff",
    "format": "date"
  },
  "matchDateUtc": {
    "label": "Kickoff (UTC)",
    "format": "date"
  },
  "groupName": {
    "label": "Round / Group",
    "format": "text"
  },
  "team1": {
    "label": "Home",
    "format": "object"
  },
  "team2": {
    "label": "Away",
    "format": "object"
  },
  "score": {
    "label": "Score",
    "format": "text"
  },
  "scoreHalftime": {
    "label": "HT Score",
    "format": "text"
  },
  "matchFinished": {
    "label": "Finished",
    "format": "boolean"
  },
  "goals": {
    "label": "Goals",
    "format": "object"
  },
  "location": {
    "label": "Venue",
    "format": "object"
  },
  "numberOfViewers": {
    "label": "Viewers",
    "format": "number"
  },
  "lastUpdate": {
    "label": "Last Update",
    "format": "date"
  },
  "leagueId": {
    "label": "League ID",
    "format": "number"
  },
  "sportName": {
    "label": "Sport",
    "format": "text"
  },
  "teamName": {
    "label": "Team",
    "format": "text"
  },
  "points": {
    "label": "Pts",
    "format": "number"
  },
  "matches": {
    "label": "P",
    "format": "number"
  },
  "won": {
    "label": "W",
    "format": "number"
  },
  "draw": {
    "label": "D",
    "format": "number"
  },
  "lost": {
    "label": "L",
    "format": "number"
  },
  "goals_for": {
    "label": "GF",
    "format": "number"
  },
  "goals_against": {
    "label": "GA",
    "format": "number"
  },
  "goalDiff": {
    "label": "GD",
    "format": "number"
  },
  "teamIconUrl": {
    "label": "Crest",
    "format": "link"
  },
  "scrapedAt": {
    "label": "Collected",
    "format": "date"
  },
  "error": {
    "label": "Error",
    "format": "text"
  }
}
```

## About this Actor

This example demonstrates how to use [OpenLigaDB Football Matches Scraper](https://apify.com/parseforge/openligadb-football-matches-scraper) with a specific input configuration. Visit the [Actor detail page](https://apify.com/parseforge/openligadb-football-matches-scraper) to learn more, explore other use cases, and run it yourself.