https://github.com/slvler/balldontlie-service
balldontlie.io api service
https://github.com/slvler/balldontlie-service
api api-client api-service balldontlie balldontlie-api laravel laravel-package laravel-service
Last synced: over 1 year ago
JSON representation
balldontlie.io api service
- Host: GitHub
- URL: https://github.com/slvler/balldontlie-service
- Owner: slvler
- License: mit
- Created: 2023-06-30T19:27:45.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-10-20T09:26:40.000Z (over 1 year ago)
- Last Synced: 2025-03-18T18:21:34.607Z (over 1 year ago)
- Topics: api, api-client, api-service, balldontlie, balldontlie-api, laravel, laravel-package, laravel-service
- Language: PHP
- Homepage:
- Size: 18.6 KB
- Stars: 10
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
# balldontlie Service
[](https://github.com/slvler/balldontlie-service/actions/workflows/tests.yml)
[](https://packagist.org/packages/slvler/balldontlie-laravel)
[](https://packagist.org/packages/slvler/balldontlie-laravel)
[](https://packagist.org/packages/slvler/balldontlie-laravel)
[](https://packagist.org/packages/slvler/balldontlie-laravel)
This package provides a convenient wrapper to the [Balldontlie API](https://www.balldontlie.io/home.html#introduction) for Laravel applications.
## Requirements
- PHP 8.0+
- Laravel 9.x
## Installation
To install this package tou can use composer:
```bash
composer require slvler/balldontlie-laravel
```
## Usage
#### Find player
```php
Balldontlie::players(237);
```
it returns an json with player:
```json
{
"data":[
{
"id":237,
"first_name":"LeBron",
"last_name":"James",
"position":"F",
"height_feet": 6,
"height_inches": 8,
"weight_pounds": 250,
"team":{
"id":14,
"abbreviation":"LAL",
"city":"Los Angeles",
"conference":"West",
"division":"Pacific",
"full_name":"Los Angeles Lakers",
"name":"Lakers"
}
}
],
"meta": {
"total_pages": 50,
"current_page": 1,
"next_page": 2,
"per_page": 25,
"total_count": 9999
}
}
```
#### Find team
```php
Balldontlie::teams(14);
```
it returns an json with team:
```json
{
"data": [
{
"id":14,
"abbreviation":"LAL",
"city":"Los Angeles",
"conference":"West",
"division":"Pacific",
"full_name":"Los Angeles Lakers",
"name":"Lakers"
}
],
"meta": {
"total_pages": 1,
"current_page": 1,
"next_page": null,
"per_page": 30,
"total_count": 30
}
}
```
#### Find games
```php
Balldontlie::games(1);
```
it returns an json with games:
```json
{
"data": [
{
"id":1,
"date":"2018-10-16T00:00:00.000Z",
"home_team_score":105,
"visitor_team_score":87,
"season":2018,
"period": 4,
"status": "Final",
"time": " ",
"postseason": false,
"home_team":{
"id":2,
"abbreviation":"BOS",
"city":"Boston",
"conference":"East",
"division":"Atlantic",
"full_name":"Boston Celtics",
"name":"Celtics"
},
"visitor_team":{
"id":23,
"abbreviation":"PHI",
"city":"Philadelphia",
"conference":"East",
"division":"Atlantic",
"full_name":"Philadelphia 76ers",
"name":"76ers"
}
}
],
"meta": {
"total_pages": 1877,
"current_page": 1,
"next_page": 2,
"per_page": 25,
"total_count": 46911
}
}
```
#### Find stats
```php
Balldontlie::stats();
```
it returns an json with stats:
```json
{
"data": [
{
"id":29,
"ast":2,
"blk":2,
"dreb":8,
"fg3_pct":0.25,
"fg3a":4,
"fg3m":1,
"fg_pct":0.429,
"fga":21,
"fgm":9,
"ft_pct":0.8,
"fta":5,
"ftm":4,
"game":{
"id":1,
"date":"2018-10-16T00:00:00.000Z",
"home_team_id":2,
"home_team_score":105,
"season":2018,
"visitor_team_id":23,
"visitor_team_score":87
},
"min":"36:49",
"oreb":2,
"pf":3,
"player":{
"id":145,
"first_name":"Joel",
"last_name":"Embiid",
"position":"F-C",
"team_id":23
},
"pts":23,
"reb":10,
"stl":1,
"team":{
"id":23,
"abbreviation":"PHI",
"city":"Philadelphia",
"conference":"East",
"division":"Atlantic",
"full_name":"Philadelphia 76ers",
"name":"76ers"
},
"turnover":5
}
],
"meta": {
"total_pages": 2042,
"current_page": 1,
"next_page": 2,
"per_page": 25,
"total_count": 51045
}
}
```
## Testing
```bash
composer test
```
## Credits
- [slvler](https://github.com/slvler)
## License
The MIT License (MIT). Please see [License File](https://github.com/slvler/balldontlie-service/blob/main/LICENSE.md) for more information.
## Contributing
You're very welcome to contribute.
Please see [CONTRIBUTING](https://github.com/slvler/balldontlie-service/blob/main/CONTRIBUTING.md) for details.