PHPackages                             krikrixs/php-beatsaver-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. krikrixs/php-beatsaver-api

AbandonedArchivedLibrary[API Development](/categories/api)

krikrixs/php-beatsaver-api
==========================

A Simple PHP library to interact with BeatSaver's API.

2.2.6(4y ago)152MITPHPPHP ~7.4

Since Jul 30Pushed 4y ago1 watchersCompare

[ Source](https://github.com/KriKrixs/PHP-BeatSaver-API)[ Packagist](https://packagist.org/packages/krikrixs/php-beatsaver-api)[ Docs](https://github.com/KriKrixs/PHP-BeatSaver-API)[ RSS](/packages/krikrixs-php-beatsaver-api/feed)WikiDiscussions master Synced 6d ago

READMEChangelog (10)DependenciesVersions (18)Used By (0)

SearchMap function# PHP BeatSaver API

[![Latest Version on Packagist](https://camo.githubusercontent.com/5eba5b0976173b19f6ee8b9dab91ce80fae167a77b326f439b5d873d9016e8f0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6b72696b726978732f7068702d6265617473617665722d6170692e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/krikrixs/php-beatsaver-api)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Quality Score](https://camo.githubusercontent.com/26440a99c518ee95a36812ea8210fc5df0473cbb26c2c97dd865c85762feeb58/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f6b72696b726978732f7068702d6265617473617665722d6170692e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/krikrixs/php-beatsaver-api)[![Total Downloads](https://camo.githubusercontent.com/042e63442fe002ae70debaae9f31ed82207fadcc85f5f4f766245ee92665a8e6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6b72696b726978732f7068702d6265617473617665722d6170692e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/krikrixs/php-beatsaver-api)

A Simple PHP library to interact with BeatSaver's API

Install
-------

[](#install)

Via Composer

```
$ composer require krikrixs/php-beatsaver-api
```

Usage
-----

[](#usage)

```
// [Composer] Create the object
$BeatSaverAPI = new BeatSaverAPI("ApplicationName");

// [Not Composer] Create the object
$BeatSaverAPI = new BeatSaverAPI("ApplicationName", true);

// Functions
$BeatSaverAPI->getMapByID((int) $mapId);
$BeatSaverAPI->getMapByKey((string) $bsrKey);
$BeatSaverAPI->getMapByHash((string) $mapHash);
$BeatSaverAPI->getMapsByIDs((array) $mapsIds);
$BeatSaverAPI->getMapsByKeys((array) $bsrKeys);
$BeatSaverAPI->getMapsByHashes((array) $mapsHashes);
$BeatSaverAPI->getMapsByUploaderID((int) $uploaderID, (int) $limit);
$BeatSaverAPI->getMapsSortedByLatest((bool) $autoMapper);
$BeatSaverAPI->getMapsSortedByPlays((int) $limit);
$BeatSaverAPI->downloadMapByIds((array) $ids, (string) $targetDir);
$BeatSaverAPI->downloadMapByKeys((array) $keys, (string) $targetDir);
$BeatSaverAPI->downloadMapByHashes((array) $hashes, (string) $targetDir);
// $sortOrder possible values: 1 = Latest | 2 = Relevance | 3 = Rating
$BeatSaverAPI->searchMap((int) $limit, (int) $sortOrder = 1, (string) $mapName = null, (DateTime) $startDate = null, (DateTime) $endDate = null, (bool) $ranked = false, (bool) $automapper = false, (bool) $chroma = false, (bool) $noodle = false, (bool) $cinema = false, (bool) $fullSpread = false, (float) $minBpm = null, (float) $maxBpm = null, (float) $minNps = null, (float) $maxNps = null, (float) $minRating = null, (float) $maxRating = null, (int) $minDuration = null, (int) $maxDuration = null): ResponseMaps;
```

Change log
----------

[](#change-log)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Security
--------

[](#security)

If you discover any security related issues, please contact me on discord [OMDN | Krixs#1106](https://discordapp.com/users/220151545486901248) or by email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [Kylian "Krixs" BARUSSEAU](https://github.com/KriKrixs)
- [rui2015](https://github.com/rui2015) - For the inspiration
- [Top-Cat](https://github.com/Top-Cat) - BeatSaver Owner
- [Curze](https://github.com/charliemo25) - Contributor

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity60

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

Recently: every ~23 days

Total

16

Last Release

1634d ago

Major Versions

1.1.0 → 2.0.02021-08-20

### Community

Maintainers

![](https://www.gravatar.com/avatar/5b150df8d33f628d1cbb6145a23e22486e6d65fd1909ee2b3e184c39b91352f4?d=identicon)[KriKrixs](/maintainers/KriKrixs)

---

Top Contributors

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

---

Tags

mapKriKrixsKrixsBeatSaberPHP-BeatSaver-APIBeatSaver

### Embed Badge

![Health badge](/badges/krikrixs-php-beatsaver-api/health.svg)

```
[![Health](https://phpackages.com/badges/krikrixs-php-beatsaver-api/health.svg)](https://phpackages.com/packages/krikrixs-php-beatsaver-api)
```

###  Alternatives

[dantsu/php-osm-static-api

PHP library to easily get static image from OpenStreetMap (OSM), add markers and draw lines.

97141.0k1](/packages/dantsu-php-osm-static-api)[ivory/google-map

Google Map API v3 integration for PHP ^8.1

14363.2k4](/packages/ivory-google-map)

PHPackages © 2026

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