PHPackages                             philicevic/faceit-php - 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. philicevic/faceit-php

ActiveLibrary[API Development](/categories/api)

philicevic/faceit-php
=====================

A PHP SDK for FACEITs api.

0.1.3(2mo ago)0136↓90%[1 issues](https://github.com/philicevic/faceit-php/issues)MITPHPPHP ^8.3CI passing

Since Mar 19Pushed 2mo agoCompare

[ Source](https://github.com/philicevic/faceit-php)[ Packagist](https://packagist.org/packages/philicevic/faceit-php)[ RSS](/packages/philicevic-faceit-php/feed)WikiDiscussions main Synced 3w ago

READMEChangelogDependencies (8)Versions (6)Used By (0)

faceit-php
==========

[](#faceit-php)

A PHP SDK for the [FACEIT Data API v4](https://developers.faceit.com/docs/apis/data-api) built on [Saloon](https://docs.saloon.dev/) v3. Returns fully typed, immutable DTOs for every endpoint.

This package is not stable yet. Use at your own risk.

Also, FACEITs API is sometimes inconsistent. This package tries to improve this a bit, but it still has its limitations. For example, the complete tournament endpoint is missing because I could not get reliable results from FACEIT.

Requirements
------------

[](#requirements)

- PHP 8.3+

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

[](#installation)

```
composer require philicevic/faceit-php
```

Getting a FACEIT API token
--------------------------

[](#getting-a-faceit-api-token)

Create a server-side API key in the [FACEIT Developer Portal](https://developers.faceit.com/) and store it in an environment variable such as `FACEIT_API_TOKEN`.

Quick start
-----------

[](#quick-start)

```
use Philicevic\FaceitPhp\Faceit;

$faceit = new Faceit($_ENV['FACEIT_API_TOKEN']);

// Look up a player by nickname
$player = $faceit->player()->lookup(nickname: 's1mple');

echo $player->nickname;
echo $player->country;
echo $player->games['cs2']->faceitElo;

// Get match details
$match = $faceit->match()->get('1-bb13fd78-e183-4d37-8a4b-ceed67da5265');

foreach ($match->teams as $team) {
    echo $team->name;
}
```

Laravel usage
-------------

[](#laravel-usage)

See [docs/laravel.md](docs/laravel.md) for service container binding and injection examples.

Resources
---------

[](#resources)

The client exposes one accessor per resource group. All methods return typed DTOs.

AccessorMethodsDocumentation`$faceit->player()``get`, `lookup`, `getBans`, `getGameStats`, `getMatches`, `getHubs`, `getStats`, `getTeams`, `getTournaments`[docs/players.md](docs/players.md)`$faceit->match()``get`, `getStats`[docs/matches.md](docs/matches.md)`$faceit->championship()``list`, `get`, `getMatches`, `getResults`, `getSubscriptions`[docs/championships.md](docs/championships.md)`$faceit->hub()``get`, `getMatches`, `getMembers`, `getRoles`, `getRules`, `getStats`[docs/hubs.md](docs/hubs.md)`$faceit->team()``get`, `getStats`, `getTournaments`[docs/teams.md](docs/teams.md)`$faceit->organizer()``getByName`, `get`, `getChampionships`, `getGames`, `getHubs`, `getTournaments`[docs/organizers.md](docs/organizers.md)`$faceit->ranking()``getGlobal`, `getPlayer`[docs/rankings.md](docs/rankings.md)`$faceit->leaderboard()``getChampionshipLeaderboards`, `getChampionshipGroupRanking`, `getHubLeaderboards`, `getHubRanking`, `get`[docs/leaderboards.md](docs/leaderboards.md)`$faceit->game()``list`, `get`[docs/games.md](docs/games.md)`$faceit->matchmaking()``get`[docs/matchmakings.md](docs/matchmakings.md)`$faceit->search(...)`cross-entity search[docs/search.md](docs/search.md)Paginated responses
-------------------

[](#paginated-responses)

Methods that return collections wrap items in a `PaginatedResponse`. See [docs/paginated-responses.md](docs/paginated-responses.md).

Strict mode
-----------

[](#strict-mode)

Enable opt-in DTO validation to catch unexpected API changes early. See [docs/strict-mode.md](docs/strict-mode.md).

Error handling
--------------

[](#error-handling)

The client uses Saloon and the `AlwaysThrowOnErrors` plugin, so HTTP errors surface as Saloon exceptions. Catch `\Throwable` or `\Saloon\Exceptions\Request\RequestException` as needed.

Testing
-------

[](#testing)

Built on Saloon's `MockClient` — no real HTTP calls needed in tests. See [docs/testing.md](docs/testing.md).

###  Health Score

39

—

LowBetter than 85% of packages

Maintenance87

Actively maintained with recent releases

Popularity12

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 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 ~9 days

Total

4

Last Release

63d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/22521271?v=4)[Philipp Ehrenberg](/maintainers/philicevic)[@philicevic](https://github.com/philicevic)

---

Top Contributors

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

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/philicevic-faceit-php/health.svg)

```
[![Health](https://phpackages.com/badges/philicevic-faceit-php/health.svg)](https://phpackages.com/packages/philicevic-faceit-php)
```

###  Alternatives

[saloonphp/laravel-plugin

The official Laravel plugin for Saloon

806.6M187](/packages/saloonphp-laravel-plugin)[skagarwal/google-places-api

Google Places Api

1903.2M9](/packages/skagarwal-google-places-api)[saloonphp/rate-limit-plugin

Handle rate limits beautifully in your Saloon API integrations or SDKs

211.6M62](/packages/saloonphp-rate-limit-plugin)[myoutdeskllc/salesforce-php

salesforce library for php8+

1574.8k](/packages/myoutdeskllc-salesforce-php)[codebar-ag/laravel-docuware

DocuWare integration with Laravel

1122.7k](/packages/codebar-ag-laravel-docuware)[codebar-ag/laravel-zammad

Zammad integration with Laravel

106.7k](/packages/codebar-ag-laravel-zammad)

PHPackages © 2026

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