Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 

SportMonks API Client Library

Build Status

API Version support

This API Client supports SportMonks v2.0.

Requirements

  • PHP 5.6 or higher

Installation

composer require hristonev/sportmonks-client-bundle

Configuration

// Bootstrap
require 'vendor/autoload.php';

use SportMonks\API\HTTPClient as SportMonksAPI;
use SportMonks\API\Utilities\Auth;

// Default values. Can be initialized without arguments.
$scheme = 'https';
$hostname = 'sportmonks.com';
$subDomain = 'soccer';
$port = 443;

// Auth.
$token = 'open sesame';

$client = new SportMonksAPI();
// or
//$client = new SportMonksAPI($scheme, $hostname, $subDomain, $port);

// Set auth.
$client->setAuth(Auth::BASIC, [
    'token' => $token
]);

Usage example

Paginated resource

$data = [];
do{
    $data = array_merge($data, $client->countries()->findAll());
}while($client->countries()->nextPage());
print_r($data);

Reference

Include data

$seasonId = 6361;
$teamId = 85;
$client->squad()->getBySeasonAndTeam(
    $seasonId,
    $teamId,
    [
        'query' => [
            'include' => 'player,position'
        ]
    ]
)

Above example, includes player info and player-position info into collection. Check for more query parameters.

Basic methods endpoints

Basic methods find({id}), findAll(), nextPage(). nextPage() is used on paginated response.

  • continents
  • countries
  • leagues
  • seasons
    • find(id, true) Include results.
    • standings(season_id)
    • standingsLive(season_id)
    • topScorers(season_id)
  • fixtures
    • between()->period(from, to, teamId) Params from and to are DateTime objects, teamId is integer. TeamId is optional.
    • date()->day(date) Param is DateTime object.
    • commentaries(fixture_id)
    • videoHighlights(fixture_id)
    • tvStations(fixture_id)
    • odds(fixture_id)
    • oddsByBookmaker(fixture_id, bookmaker_id)
    • oddsByMarket(fixture_id, market_id)
    • oddsInPlay(fixture_id)
    • Fixtures does not support findAll method.
  • teams
    • find(id, true) Include stats.
    • season(id) Get teams by season.
    • Teams does not support findAll method.
  • head2Head
    • get(array) Array must contain 2 elements(team1_id,team2_id).
    • There is no additional mthods.
  • liveScores
    • today()
    • inPlay()
  • highlights
    • Video haighlights does not support find method. Additional method in fixtures is presented.
  • venues
    • Venue does not support findAll method.
  • bookmakers
  • players
    • Players does not support findAll method.
  • squad
    • getBySeasonAndTeam(season_id, team_id) No other methods

About

Easily talk to an SportMonks API in PHP

Resources

License

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages