PHPackages                             danabrey/espn-college-football-stats - 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. danabrey/espn-college-football-stats

ActiveLibrary[API Development](/categories/api)

danabrey/espn-college-football-stats
====================================

PHP package for reading data from ESPN's college football JSON API

2.1(5y ago)31081MITPHPPHP ^7.4|^8.0CI failing

Since Nov 23Pushed 5y ago1 watchersCompare

[ Source](https://github.com/danabrey/espn-college-football-stats)[ Packagist](https://packagist.org/packages/danabrey/espn-college-football-stats)[ RSS](/packages/danabrey-espn-college-football-stats/feed)WikiDiscussions master Synced yesterday

READMEChangelog (5)Dependencies (3)Versions (6)Used By (0)

ESPN College Football Stats
===========================

[](#espn-college-football-stats)

Object-oriented PHP package for reading data from the ESPN JSON API.

[![Build Status](https://camo.githubusercontent.com/9d481548b2b649f5bf5822545b27f48fc726c84d83b38541cf122449aed80bad/68747470733a2f2f7472617669732d63692e636f6d2f64616e61627265792f6573706e2d636f6c6c6567652d666f6f7462616c6c2d73746174732e7376673f6272616e63683d6d6173746572)](https://travis-ci.com/danabrey/espn-college-football-stats)

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

[](#installation)

Via Composer:

`composer require danabrey/espn-college-football-stats`

**Note**: v2.0 removes support for PHP versions below 7.4. If using PHP 7.0-7.3, use the latest version of v1.0 of this package.

Usage
-----

[](#usage)

Scrape a player's stats by passing their ESPN player ID (found in the URL e.g. `https://www.espn.co.uk/college-football/player/stats/_/id/4241463/jerry-jeudy`)

```
$stats = new DanAbrey\ESPNCollegeFootballStats\ESPNCollegeFootballStats();
$playerStats = $stats->getPlayer(4241463);

```

The return from `getPlayer()` will be a `Player` object, which includes their ID and a `seasons` property which is an array of `PlayerSeason` objects, containing the stats for the player that season.

### Team Stats

[](#team-stats)

Fetching stats for teams is similar.

The return from `getTeam()` will be a `Team` object, which includes their ID and a `seasons` property which is an array of `TeamSeason` objects.

```
$stats = new DanAbrey\ESPNCollegeFootballStats\ESPNCollegeFootballStats();
$teamStats = $stats->getTeam(333);
```

By default, it will return the last four seasons' worth of data. You can change this by passing an array of seasons to `$stats->setSeasons()`.

```
$stats = new DanAbrey\ESPNCollegeFootballStats\ESPNCollegeFootballStats();
$stats->setTeamSeasons([2015, 2016]);
$teamStats = $stats->getTeam(333);
```

Disclaimer
----------

[](#disclaimer)

This package is intended as a proof of concept experiment, I highly advise against using the ESPN API (which isn't documented) for anything other than hobby personal use.

Contributing/Contact
--------------------

[](#contributingcontact)

Please feel free to raise issues or open pull requests with suggestions on how to improve this project. For any informal questions, find me on Twitter at [@danabrey](https://www.twiter.com/danabrey).

License
-------

[](#license)

[![License](https://camo.githubusercontent.com/1e1cb7bae9fc55a01fc5443d26e358dc21c129253bcfa9841db85c4f25aa2ecf/687474703a2f2f696d672e736869656c64732e696f2f3a6c6963656e73652d6d69742d626c75652e7376673f7374796c653d666c61742d737175617265)](http://badges.mit-license.org)

- **[MIT license](http://opensource.org/licenses/mit-license.php)**
- Copyright 2019 © Dan Abrey

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity66

Established project with proven stability

 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.

###  Release Activity

Cadence

Every ~107 days

Total

5

Last Release

1932d ago

Major Versions

1.1.1 → 2.02020-05-31

PHP version history (3 changes)1.0.0PHP ^7.1

2.0PHP ^7.4

2.1PHP ^7.4|^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/08ae8b4496ef1041a89cef3664d40778641b613985eaf273902aeebea0a317ed?d=identicon)[danabrey](/maintainers/danabrey)

---

Top Contributors

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

---

Tags

college-footballcollege-football-playersespnphp

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/danabrey-espn-college-football-stats/health.svg)

```
[![Health](https://phpackages.com/badges/danabrey-espn-college-football-stats/health.svg)](https://phpackages.com/packages/danabrey-espn-college-football-stats)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[api-platform/symfony

Symfony API Platform integration

323.2M67](/packages/api-platform-symfony)[api-platform/serializer

API Platform core Serializer

223.4M31](/packages/api-platform-serializer)[fschmtt/keycloak-rest-api-client-php

PHP client to interact with Keycloak's Admin REST API.

4684.7k2](/packages/fschmtt-keycloak-rest-api-client-php)[paddlehq/paddle-php-sdk

Paddle's PHP SDK for Paddle Billing.

53301.7k](/packages/paddlehq-paddle-php-sdk)

PHPackages © 2026

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