Openligadb De OpenLigaDB API

Name: OpenLigaDB API
Brand: OpenLigaDB API
Availability: InStock

✓ Official Vendor SpecMediaContent Deliverynone19 EndpointsREST

For Agents

Look up leagues, fixtures, results, standings, and goal scorers for football and other sports without an API key.

Install Jentic One Beta

Connect the OpenLigaDB API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the OpenLigaDB API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fopenligadb.de%2Fopenligadb" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fopenligadb.de%2Fopenligadb" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with OpenLigaDB API.

List the available leagues and seasons covered by OpenLigaDB

Retrieve all matches for a given league and season, including fixture and result data

Fetch the next or most recent match for a specific team in a league

GET STARTED

Start building with OpenLigaDB API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use OpenLigaDB API for, with concrete tasks.

★ Football Fixture and Results Widget

Build a website widget that shows the upcoming fixtures and latest results for a chosen league. The widget calls GET /getmatchdata/{leagueShortcut}/{leagueSeason} to pull the season's fixture list and updates after each matchday. Because OpenLigaDB is free and key-less, the widget can be embedded without provisioning credentials.

Call GET /getmatchdata/bl1/2025 and return the next 5 fixtures with kickoff time, home team, and away team.

League Standings Display

Render the current points table for a chosen league using OpenLigaDB's standings endpoint. The response includes points, goal difference, and matches played for each team, suitable for a fan dashboard or a Discord bot. The dataset covers multiple seasons so historical tables are available too.

Fetch the current standings for league 'bl1' and season '2025' and return the top 5 teams with points and goal difference.

Goal Scorer Leaderboard for a Season

Build a top-scorer leaderboard for a season. GET /getgoalgetters/{leagueShortcut}/{leagueSeason} returns each scorer with goalGetterName and goalCount, so the ranking needs no client-side aggregation. For per-match detail, OpenLigaDB also embeds a goals array in each match object, giving goalGetterName and matchMinute for every goal.

Call GET /getgoalgetters/bl1/2025 and return the top 10 entries by goalCount, each with its goalGetterName.

AI Agent Sports Data Lookup via Jentic

An agent producing match previews or fan-facing summaries can call OpenLigaDB through Jentic so the operations are discoverable by intent. Because the API takes no credential, wiring it up is just importing the API and calling the operation. The structured response keeps the LLM grounded in real fixtures rather than hallucinated dates.

Use Jentic to search for 'next match for a football team', execute GET /getnextmatchbyleagueteam/{leagueId}/{teamId}, and return the kickoff time and opponent name.

Key Endpoints

19 endpoints — openligadb is a community-maintained free api for sports match data, focused on football (soccer) but also covering other leagues.

METHOD

PATH

DESCRIPTION

GET

/getavailableleagues

List all available leagues

GET

/getmatchdata/{leagueShortcut}/{leagueSeason}

Get all matches for a league and season

GET

/getmatchdata/{matchId}

Get a single match by ID

GET

/getnextmatchbyleagueteam/{leagueId}/{teamId}

Get the next upcoming match for a team

GET

/getavailableteams/{leagueShortcut}/{leagueSeason}

Get teams in a league and season

GET

/getavailablegroups/{leagueShortcut}/{leagueSeason}

Get group or matchday list for a season

GET

/getavailableleagues

List all available leagues

GET

/getmatchdata/{leagueShortcut}/{leagueSeason}

Get all matches for a league and season

GET

/getmatchdata/{matchId}

Get a single match by ID

GET

/getnextmatchbyleagueteam/{leagueId}/{teamId}

Get the next upcoming match for a team

GET

/getavailableteams/{leagueShortcut}/{leagueSeason}

Get teams in a league and season

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring the OpenLigaDB API by hand means assembling its league-shortcut and season path segments correctly and parsing the fixture and result payloads yourself, even though it needs no key. Through Jentic you install once, import the OpenLigaDB API from the API Directory, and your agent calls it with no secret to manage.

Permission scoping

OpenLigaDB is read-only football data with no authentication, and you limit the agent to the operations it needs, such as listing available leagues or fetching match data for a season. The surface has no write operations, so the agent can only read fixtures, results, and standings.

Credential isolation

OpenLigaDB needs no credential, so there is no secret to store. Your Jentic One instance still mediates each call so the agent works from a structured operation rather than hand-built URLs.

Intent-based discovery

Agents search Jentic by intent such as 'get the next match for a team' or 'list matchday data for a league', and Jentic returns the matching OpenLigaDB operation with its path parameters so the agent calls the right endpoint without browsing the reference docs.

FAQs

Specific to using OpenLigaDB API through Jentic.

What authentication does the OpenLigaDB API use?

OpenLigaDB does not require authentication; all documented endpoints are publicly callable. Through Jentic the call is still mediated for structured responses, and any future authenticated extension would be vaulted in your Jentic One instance.

Can I get the next match for a specific team with the OpenLigaDB API?

Yes. GET /getnextmatchbyleagueteam/{leagueId}/{teamId} returns the next upcoming fixture for the team in the given league, including kickoff time and opponent.

What are the rate limits for the OpenLigaDB API?

OpenLigaDB's OpenAPI description declares no rate-limit headers and no throttling response, so a client has no published limit to code against. Treat the community-run service as fair-use: cache league, team, and fixture lists rather than re-fetching them on every request.

How do I list current standings for a league with the OpenLigaDB API through Jentic?

Search Jentic for 'get league standings', load the standings endpoint with the leagueShortcut and leagueSeason path parameters (for example 'bl1' and '2025'), and execute it. Because the API is unauthenticated, no credentials are required.

Is the OpenLigaDB API free to use?

Yes. The API requires no key and no credential, so any client can call it without registering. OpenLigaDB is a free community project and states that the data provided through this API is under the Open Database License (ODbL), with further licence information at openligadb.de/lizenz, so check that before redistributing the data in a public product.

Which sports does the OpenLigaDB API cover?

The primary focus is football (soccer), particularly the Bundesliga and other German leagues, but additional leagues and sports are listed via GET /getavailableleagues and GET /getavailablesports.

Is there an OpenLigaDB MCP server?

You do not need an MCP server to give your agent OpenLigaDB. Jentic connects it directly from the API Directory: import the OpenLigaDB API and, because the API takes no credential, your agent can call the fixture, standings, and goal scorer operations straight away, without loading another server's tool definitions into its context.

Can I limit what my agent is allowed to do with the OpenLigaDB API?

Yes. Because Jentic One is self-hosted, you set the rules that decide which OpenLigaDB operations your agent may call, so you can grant only what it needs, such as GET /getavailableleagues for the league list and GET /getmatchdata/{leagueShortcut}/{leagueSeason} for season fixtures, while withholding others like GET /getnextmatchbyleagueteam. OpenLigaDB is read-only football data with no authentication and no write operations, so a scoped agent can only read fixtures, results, and standings and can never modify anything. This lets the operator narrow the callable surface to exactly the match, standings, or team lookups a given task requires.