PHPackages igorlealantunes/sportmonks-soccer-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. [API Development](/categories/api) 4. / 5. igorlealantunes/sportmonks-soccer-api ActiveLibrary[API Development](/categories/api) igorlealantunes/sportmonks-soccer-api ===================================== Simple SportMonks Soccer API Client for PHP 046PHP Since Nov 21Pushed 1y agoCompare [ Source](https://github.com/igorlealantunes/sportmonks-soccer-api)[ Packagist](https://packagist.org/packages/igorlealantunes/sportmonks-soccer-api)[ RSS](/packages/igorlealantunes-sportmonks-soccer-api/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependenciesVersions (2)Used By (0) Sportmonks Soccer API PHP Client ================================ [](#sportmonks-soccer-api-php-client) [![Build Status](https://camo.githubusercontent.com/68194a7be197cd8bae57eef8688dc9b86325253e440abfebffe07a84e376cf55/68747470733a2f2f7472617669732d63692e6f72672f6a6f657361756e646572736f6e2f73706f72746d6f6e6b732d736f636365722e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/joesaunderson/sportmonks-soccer) PHP Library for [Sportmonks](https://sportmonks.com/) Soccer API. Developed by [Joe Saunderson](mailto:joesaunderson@me.com). Prerequisites ------------- [](#prerequisites) PHP >= 7.4 Installation ------------ [](#installation) ``` composer require igorlealantunes/sportmonks-soccer-api ``` Setup ----- [](#setup) The API Client relies on [Environment variables](https://www.php.net/manual/en/reserved.variables.environment.php) for configuration (setting API token & timezone). Install: ``` composer require symfony/dotenv ``` Usage: ``` use Symfony\Component\Dotenv\Dotenv; $dotenv = new Dotenv(); $dotenv->load(__DIR__.'/.env'); ``` An example .env file: ``` # API TOKEN (Required) # https://sportmonks.com/settings#/api SPORTMONKS_API_TOKEN=_YOUR_API_TOKEN_HERE # TIMEZONE (Optional) # https://sportmonks.com/docs/football/2.0/getting-started/a/setting-the-timezone/82 SPORTMONKS_TIMEZONE=Europe/London ``` Usage ----- [](#usage) ``` use Sportmonks\Soccer\SoccerApi; ... // Basic API call for all Bookmakers $response = SoccerApi::bookmakers()->getAll(); ``` Pagination, Filtering, Sorting & Data Enrichment ---------------------------------------------------- [](#pagination-filtering-sorting--data-enrichment) The [Sportmonks API](https://sportmonks.com/docs/football/2.0/getting-started/a/api-filtering-sorting-and-pagination/90)allows for advanced filtering and sorting, as well as adding data via relationships. This client supports the following: ### Includes [](#includes) ``` // API call for Fixtures with includes $response = SoccerApi::fixtures() ->setIncludes(['goals', 'flatOdds:filter(bookmaker_id|2)']) ->getByDate('2019-05-28'); ``` ### Pagination [](#pagination) ``` // API call for Fixtures with page specified $response = SoccerApi::fixtures() ->setPage(3) ->getByDate('2019-05-28'); ``` Note: The pagination meta (`$response['meta']['pagination']`) can be used to loop through pages and build a result set. ### Additional Parameters [](#additional-parameters) Certain endpoints allow for data to be passed as URI query parameters, these are shown below & must be added before the ->get..() call. ``` ->setBookmakers([1, 2]) ->setFixtures([1, 2]) ->setLeagues([1, 2]) ->setMarkets([1, 2]) ``` Note: This client will not validate the usage for the correct endpoints and will not throw an error. Refer to the [Sportmonks docs](https://sportmonks.com/docs/football/2.0) to see which endpoints support the above parameters. Full Endpoint Examples ---------------------- [](#full-endpoint-examples) ### Bookmakers [](#bookmakers) ##### Get All - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/bookmakers/a/get-all-bookmakers/37) [](#get-all---view-sportmonks-docs) ``` $response = SoccerApi::bookmakers()->getAll(); ``` ##### Get By Id - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/bookmakers/a/get-bookmaker-by-id/38) [](#get-by-id---view-sportmonks-docs) ``` $response = SoccerApi::bookmakers()->getById($bookmakerId); ``` ### Coaches [](#coaches) ##### Get By Id - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/coaches/a/get-coach-by-id/43) [](#get-by-id---view-sportmonks-docs-1) ``` $response = SoccerApi::coaches()->getById($coachId); ``` ### Commentaries [](#commentaries) ##### Get By Fixture Id - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/commentaries/a/get-by-fixture-id/17) [](#get-by-fixture-id---view-sportmonks-docs) ``` $response = SoccerApi::commentaries()->getByFixtureId($fixtureId); ``` ### Continents [](#continents) ##### Get All - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/continents/a/get-all-continents/2) [](#get-all---view-sportmonks-docs-1) ``` $response = SoccerApi::continents()->getAll(); ``` ##### Get By Id - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/continents/a/get-by-id/3) [](#get-by-id---view-sportmonks-docs-2) ``` $response = SoccerApi::continents()->getById($continentId); ``` ### Countries [](#countries) ##### Get All - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/countries/a/get-all-countries/4) [](#get-all---view-sportmonks-docs-2) ``` $response = SoccerApi::countries()->getAll(); ``` ##### Get By Id - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/countries/a/get-by-id/5) [](#get-by-id---view-sportmonks-docs-3) ``` $response = SoccerApi::countries()->getById($countryId); ``` ### Fixtures [](#fixtures) ##### Get By Id - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/fixtures/a/get-by-id/10) [](#get-by-id---view-sportmonks-docs-4) ``` $response = SoccerApi::fixtures()->getById($fixtureId); ``` ##### Get By Date - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/fixtures/a/get-by-date/11) [](#get-by-date---view-sportmonks-docs) ``` $response = SoccerApi::fixtures()->getByDate($date); ``` ##### Get By Date Range - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/fixtures/a/get-by-date-range/12) [](#get-by-date-range---view-sportmonks-docs) ``` $response = SoccerApi::fixtures()->getByDateRange($dateFrom, $dateTo); ``` ##### Get By Date Range For Team - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/fixtures/a/get-by-date-range-for-team/13) [](#get-by-date-range-for-team---view-sportmonks-docs) ``` $response = SoccerApi::fixtures()->getByDateRangeForTeam($dateFrom, $dateTo, $teamId); ``` ##### Get By Multiple Ids - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/fixtures/a/get-by-multiple-ids/14) [](#get-by-multiple-ids---view-sportmonks-docs) ``` $response = SoccerApi::fixtures()->getByMultipleIds([$fixtureId1, $fixtureId2...]); ``` ##### Get Last Updated - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/fixtures/a/get-last-updated/218) [](#get-last-updated---view-sportmonks-docs) ``` $response = SoccerApi::fixtures()->getLastUpdated(); ``` ### Head2Head [](#head2head) ##### Get By Team Ids - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/head2head/a/get-by-team-ids/19) [](#get-by-team-ids---view-sportmonks-docs) ``` $response = SoccerApi::head2head()->getByTeamIds($team1Id, $team2Id); ``` ### Leagues [](#leagues) ##### Get All - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/leagues/a/get-all-leagues/6) [](#get-all---view-sportmonks-docs-3) ``` $response = SoccerApi::leagues()->getAll(); ``` ##### Get By Id - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/leagues/a/get-by-id/7) [](#get-by-id---view-sportmonks-docs-5) ``` $response = SoccerApi::leagues()->getById($legueId); ``` ### Live Scores [](#live-scores) ##### Get All - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/livescores/a/get-all-for-today/15) [](#get-all---view-sportmonks-docs-4) ``` $response = SoccerApi::liveScores()->getAll(); ``` ##### Get All Inplay - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/livescores/a/get-all-inplay-fixtures/16) [](#get-all-inplay---view-sportmonks-docs) ``` $response = SoccerApi::liveScores()->getAllInPlay(); ``` ### Markets [](#markets) ##### Get All - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/markets/a/get-all-markets/39) [](#get-all---view-sportmonks-docs-5) ``` $response = SoccerApi::markets()->getAll(); ``` ##### Get By Id - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/markets/a/get-market-by-id/40) [](#get-by-id---view-sportmonks-docs-6) ``` $response = SoccerApi::markets()->getById($marketId); ``` ### Odds [](#odds) ##### Get By Fixture & Bookmaker - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/odds/a/get-prematch-odds-by-fixture-and-bookmaker/30) [](#get-by-fixture--bookmaker---view-sportmonks-docs) ``` $response = SoccerApi::odds()->getByFixtureAndBookmaker($fixtureId, $bookmakerId); ``` ##### Get By Fixture & Market - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/odds/a/get-prematch-odds-by-fixture-and-market/31) [](#get-by-fixture--market---view-sportmonks-docs) ``` $response = SoccerApi::odds()->getByFixtureAndMarket($fixtureId, $marketId); ``` ##### Get By Fixture Id - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/odds/a/get-prematch-odds-by-fixture-id/36) [](#get-by-fixture-id---view-sportmonks-docs-1) ``` $response = SoccerApi::odds()->getByFixtureId($fixtureId); ``` ##### Get Inplay Odds By Fixture Id - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/odds/a/get-inplay-odds-by-fixture-id/32) [](#get-inplay-odds-by-fixture-id---view-sportmonks-docs) ``` $response = SoccerApi::odds()->getInPlayByFixtureId($fixtureId); ``` ### Players [](#players) ##### Get By Id - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/players/a/get-player-by-id/41) [](#get-by-id---view-sportmonks-docs-7) ``` $response = SoccerApi::players()->getById($playerId); ``` ### Predictions [](#predictions) ##### Get Leagues [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/prediction-api/a/leagues-performance/211) [](#get-leagues-view-sportmonks-docs) ``` $response = SoccerApi::predictions()->getLeagues() ``` ##### Get Probabilities [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/prediction-api/a/probabilities/212) [](#get-probabilities-view-sportmonks-docs) ``` $response = SoccerApi::predictions()->getProbabilities() ``` ##### Get Probabilities By Fixture Id [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/prediction-api/a/probability-by-fixture-id/214) [](#get-probabilities-by-fixture-id-view-sportmonks-docs) ``` $response = SoccerApi::predictions()->getProbabilitiesByFixtureId($fixtureId) ``` ##### Get Value Bets [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/prediction-api/a/value-bets/213) [](#get-value-bets-view-sportmonks-docs) ``` $response = SoccerApi::predictions()->getValueBets() ``` ##### Get Value Bets By Fixture Id [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/prediction-api/a/value-bet-by-fixture-id/215) [](#get-value-bets-by-fixture-id-view-sportmonks-docs) ``` $response = SoccerApi::predictions()->getValueBetsByFixtureId($fixtureId) ``` ### Rounds [](#rounds) ##### Get By Id - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/rounds/a/get-round-by-id/28) [](#get-by-id---view-sportmonks-docs-8) ``` $response = SoccerApi::rounds()->getById($roundId); ``` ##### Get By Season Id - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/rounds/a/get-rounds-by-season-id/29) [](#get-by-season-id---view-sportmonks-docs) ``` $response = SoccerApi::rounds()->getBySeasonId($seasonId); ``` ### Seasons [](#seasons) ##### Get All - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/seasons/a/get-all-seasons/8) [](#get-all---view-sportmonks-docs-6) ``` $response = SoccerApi::seasons()->getAll(); ``` ##### Get By Id - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/seasons/a/get-by-id/9) [](#get-by-id---view-sportmonks-docs-9) ``` $response = SoccerApi::seasons()->getById($seasonId); ``` ### Stages [](#stages) ##### Get By Id - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/stages/a/get-stage-by-id/34) [](#get-by-id---view-sportmonks-docs-10) ``` $response = SoccerApi::stages()->getById($stageId); ``` ##### Get By Season Id - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/stages/a/get-stages-by-season-id/35) [](#get-by-season-id---view-sportmonks-docs-1) ``` $response = SoccerApi::stages()->getBySeasonId($seasonId); ``` ### Standings [](#standings) ##### Get By Season Id - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/standings/a/get-standings-by-season-id/20) [](#get-by-season-id---view-sportmonks-docs-2) ``` $response = SoccerApi::standings()->getBySeasonId($seasonId); ``` ##### Get Live Standings - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/standings/a/get-live-standings-by-season-id/21) [](#get-live-standings---view-sportmonks-docs) ``` $response = SoccerApi::standings()->getLiveStandingsBySeasonId($seasonId); ``` ### Teams [](#teams) ##### Get By Id - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/teams/a/get-team-by-id/22) [](#get-by-id---view-sportmonks-docs-11) ``` $response = SoccerApi::teams()->getById($teamId); ``` ##### Get By Season - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/teams/a/get-teams-played-in-season/23) [](#get-by-season---view-sportmonks-docs) ``` $response = SoccerApi::teams()->getBySeasonId($seasonId); ``` ### Team Squads [](#team-squads) ##### Get By Team & Season - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/team-squads/a/get-squad-by-team-and-season/42) [](#get-by-team--season---view-sportmonks-docs) ``` $response = SoccerApi::teamSquads()->getByTeamAndSeason($teamId, $seasonId); ``` ### Top Scorers [](#top-scorers) ##### Get By Season Id - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/topscorers/a/get-topscorers-by-season-id/24) [](#get-by-season-id---view-sportmonks-docs-3) ``` $response = SoccerApi::topScorers()->getBySeasonId($seasonId); ``` ##### Aggregated By Season Id - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/topscorers/a/get-aggregated-topscorers-by-season-id/25) [](#aggregated-by-season-id---view-sportmonks-docs) ``` $response = SoccerApi::topScorers()->getAggregatedBySeasonId($seasonId); ``` ### Tv Stations [](#tv-stations) ##### Get By Fixture Id - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/tv-stations/a/get-tv-stations-by-fixture-id/44) [](#get-by-fixture-id---view-sportmonks-docs-2) ``` $response = SoccerApi::tvStations()->getByFixtureId($fixtureId); ``` ### Venues [](#venues) ##### Get By Id - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/venues/a/get-by-venue-id/26) [](#get-by-id---view-sportmonks-docs-12) ``` $response = SoccerApi::venues()->getById($venueId); ``` ##### Get By Season Id - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/venues/a/get-venues-by-season-id/27) [](#get-by-season-id---view-sportmonks-docs-4) ``` $response = SoccerApi::venues()->getBySeasonId($seasonId); ``` ### Video Highlights [](#video-highlights) ##### Get By Fixture Id - [View Sportmonks Docs](https://sportmonks.com/docs/football/2.0/video-highlights/a/get-video-highlights-by-fixture-id/18) [](#get-by-fixture-id---view-sportmonks-docs-3) ``` $response = SoccerApi::videoHighlights()->getAll(); ``` License ------- [](#license) [MIT](https://tldrlegal.com/license/mit-license) ### Health Score 18 — LowBetter than 8% of packages Maintenance30 Infrequent updates — may be unmaintained Popularity8 Limited adoption so far Community13 Small or concentrated contributor base Maturity22 Early-stage or recently created project Bus Factor1 Top contributor holds 51.9% 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/302496360ea9afd851c1de3f1da7e1ca200375d17c33ad4358ee0b5a0a666b6a?d=identicon)[igorlealantunes](/maintainers/igorlealantunes) --- Top Contributors [![joesaunderson](https://avatars.githubusercontent.com/u/11272509?v=4)](https://github.com/joesaunderson "joesaunderson (14 commits)")[![igorlealantunes](https://avatars.githubusercontent.com/u/8172715?v=4)](https://github.com/igorlealantunes "igorlealantunes (4 commits)")[![dependabot-preview[bot]](https://avatars.githubusercontent.com/in/2141?v=4)](https://github.com/dependabot-preview[bot] "dependabot-preview[bot] (2 commits)")[![kashmiry](https://avatars.githubusercontent.com/u/4423561?v=4)](https://github.com/kashmiry "kashmiry (2 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")[![ts1985](https://avatars.githubusercontent.com/u/37267773?v=4)](https://github.com/ts1985 "ts1985 (1 commits)")[![mirolqd](https://avatars.githubusercontent.com/u/31033879?v=4)](https://github.com/mirolqd "mirolqd (1 commits)")[![prathnachauhan](https://avatars.githubusercontent.com/u/49389621?v=4)](https://github.com/prathnachauhan "prathnachauhan (1 commits)")[![tarlepp](https://avatars.githubusercontent.com/u/595561?v=4)](https://github.com/tarlepp "tarlepp (1 commits)") ### Embed Badge ![Health badge](/badges/igorlealantunes-sportmonks-soccer-api/health.svg) ``` [![Health](https://phpackages.com/badges/igorlealantunes-sportmonks-soccer-api/health.svg)](https://phpackages.com/packages/igorlealantunes-sportmonks-soccer-api) ``` ### Alternatives [stripe/stripe-php Stripe PHP Library 4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk A PHP wrapper for Twilio's API 1.6k92.9M272](/packages/twilio-sdk)[knplabs/github-api GitHub API v3 client 2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk PHP SDK for Facebook Business 90121.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php PHP wrapper for the Meilisearch API 73813.7M114](/packages/meilisearch-meilisearch-php)[google/gax Google API Core for PHP 263103.1M454](/packages/google-gax) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)