PHPackages                             developermarius/sporteins-public-api - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. developermarius/sporteins-public-api

ActiveProject

developermarius/sporteins-public-api
====================================

Wrapper for the Sport1 public api

07PHP

Since Oct 1Pushed 1y ago1 watchersCompare

[ Source](https://github.com/DeveloperMarius/sporteins-public-api)[ Packagist](https://packagist.org/packages/developermarius/sporteins-public-api)[ RSS](/packages/developermarius-sporteins-public-api/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Sport1 Public Api
=================

[](#sport1-public-api)

This is a simple wrapper for the Sport1 Public Api. It is written in PHP and provides a simple way to access the Sport1 Public Api.
The Sport1 Public Api is a RESTful API that provides access to the Sport1 data like game information.
After I did some simple analysis on the Sport1 Public Api, I documented some components of the API in a gist. You can find the gist [here](https://gist.github.com/DeveloperMarius/9e117e254b49bc131cae98c9099734c6).

> **Disclaimer** before using this client: please ensure that you have the permissions from the Website Owner.

Installation
------------

[](#installation)

To install this library, you need to have Composer installed on your system. If you don't have it installed, you can download it from [here](https://getcomposer.org/).

Once you have Composer installed, you can install the library by running the following command in your terminal:

```
composer require developermarius/sporteins-public-api
```

Usage
-----

[](#usage)

### Initialization

[](#initialization)

First, you need to import the `SporteinsClient` class and create a new instance of it.

```
use developermarius\sporteins\publicapi\SporteinsClient;

$client = new SporteinsClient();
```

### Listing Seasons

[](#listing-seasons)

To search for products, you can use the `search` method. This method accepts an optional `EventimSearchQuery` object. If no query object is provided, a default one will be used.

```
use developermarius\eventim\publicapi\models\EventimSearchQuery;
use developermarius\sporteins\publicapi\models\SporteinsSportIdentifier;
use developermarius\sporteins\publicapi\models\SporteinsCompetitionType;

$seasons_response = $client->getSeasons(SporteinsSportIdentifier::SOCCER, SporteinsCompetitionType::SOCCER_FIRST_BUNDESLIGA);
```

The `getSeasons` method returns an `SporteinsSeasonsResponse` object, which contains all seasons for the competition for the given sport.

### List Game plans

[](#list-game-plans)

To list game plans for a specific season, you can use the `getGamePlans` method. This method accepts the sport identifier, competition type, and season id.

```
$game_plans_response = $client->getGamePlans(SporteinsSportIdentifier::SOCCER, SporteinsCompetitionType::SOCCER_FIRST_BUNDESLIGA, $seasons_response->getSeasons()[0]->getId());
```

The `getGamePlans` method returns an `SporteinsGameplansResponse` object, which contains all game plans for the given season.

### List Matches for a specific game plan

[](#list-matches-for-a-specific-game-plan)

To list matches for a specific game plan, you can use the `getMatches` method. This method accepts the sport identifier, competition type, season id, and game plan object.

```
$matches_response = $client->getMatches(SporteinsSportIdentifier::SOCCER, SporteinsCompetitionType::SOCCER_FIRST_BUNDESLIGA, $seasons_response->getSeasons()[0]->getId(), $game_plans_response->getGameplan()[0]);
```

The `getMatches` method returns an `SporteinsMatchesResponse` object, which contains all matches for the given game plan.

### Get Match Details

[](#get-match-details)

Warning: This function is very unstable because not every game has and endpoint detailed information and the endpoints in general differ from sport to sport and from competition to competition.

To get details for a specific match, you can use the `getMatch` method. This method accepts the sport identifier and the match id.

```
$match_details_response = $client->getMatch(SporteinsSportIdentifier::SOCCER, $matches->getMatches()[0]->getId());
```

The `getMatch` method returns an `SporteinsMatch` or `SporteinsTickerResponse` object, which contains all details for the given match.

TODO
----

[](#todo)

- Add more sports and competitions
- Add more match details / live ticker endpoints
- Add more endpoints in general :)

Contributing
------------

[](#contributing)

Contributions are welcome! Please feel free to submit a pull request.

License
-------

[](#license)

This library is open-sourced software licensed under the [MIT license](http://opensource.org/licenses/MIT).

###  Health Score

15

—

LowBetter than 3% of packages

Maintenance29

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity17

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/4967d56d82cd73c6266e20ddd3c3e29756e04dcd0ae6dee00cb8d2cffbb43e4f?d=identicon)[DeveloperMarius](/maintainers/DeveloperMarius)

---

Top Contributors

[![DeveloperMarius](https://avatars.githubusercontent.com/u/19653546?v=4)](https://github.com/DeveloperMarius "DeveloperMarius (9 commits)")

### Embed Badge

![Health badge](/badges/developermarius-sporteins-public-api/health.svg)

```
[![Health](https://phpackages.com/badges/developermarius-sporteins-public-api/health.svg)](https://phpackages.com/packages/developermarius-sporteins-public-api)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)