PHPackages                             itisbean/php-qq-music-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. itisbean/php-qq-music-api

ActiveLibrary[API Development](/categories/api)

itisbean/php-qq-music-api
=========================

qq music's public api for php

1.0.8(5y ago)2213421[1 issues](https://github.com/itisbean/php-qq-music-api/issues)MITPHPPHP >=5.6.0

Since Nov 14Pushed 3y ago2 watchersCompare

[ Source](https://github.com/itisbean/php-qq-music-api)[ Packagist](https://packagist.org/packages/itisbean/php-qq-music-api)[ Docs](https://github.com/itisbean/php-qq-music-api)[ RSS](/packages/itisbean-php-qq-music-api/feed)WikiDiscussions main Synced today

READMEChangelog (9)Dependencies (1)Versions (10)Used By (0)

php-qq-music-api
================

[](#php-qq-music-api)

qq music's private api for php

Composer Install
----------------

[](#composer-install)

```
composer require itisbean/php-qq-music-api
```

Use
---

[](#use)

```
// 引入autoload.php（框架中使用不需要）
include_once __DIR__.'/../vendor/autoload.php';
// 实例化Api类
$api = new \qqMusic\Api();
// 调用
$ret = $api->searchSinger('容祖儿');
```

Function
--------

[](#function)

### Search Singer

[](#search-singer)

```
/**
 * 通过歌手姓名搜索歌手的歌曲列表
 * @param string $name
 * @return array
 */
$api->searchSinger('容祖儿');
```

### Get the singer's songs

[](#get-the-singers-songs)

```
/**
 * 通过歌手Mid获取该歌手的歌曲列表
 * @param string $singerMid
 * @param integer $page 当前页
 * @param integer $pageSize 每页数量（Max 100）
 * @return array
 */
$api->getSonglistBySinger('001uXFgt1kpLyI');
```

### Get the singer's albums

[](#get-the-singers-albums)

```
/**
 * 通过歌手Mid获取该歌手的专辑列表
 * @param string $singerMid
 * @param integer $page 当前页
 * @param integer $pageSize 每页数量（Max 80）
 * @return array
 */
$api->getAlbumlistBySinger('001uXFgt1kpLyI');
```

### Get album songs

[](#get-album-songs)

```
/**
 * 通过QQ音乐专辑MID获取歌曲列表
 * @param string $albumMid
 * @return array
 */
$api->getAlbumSongs('00092YgX3cowE2');
```

### Get the number of song comments

[](#get-the-number-of-song-comments)

```
/**
 * 获取歌曲评论数量
 * @param integer $songId
 * @return array
 */
$api->getSongCommentCount(234276764);
```

### Get the number of album comments

[](#get-the-number-of-album-comments)

```
/**
 * 获取专辑评论数量
 * @param integer $albumId
 * @return array
 */
$api->getAlbumCommentCount(7144823);
```

### Get song popularity data

[](#get-song-popularity-data)

```
/**
 * 通过QQ音乐歌曲MID获取歌曲流行指数
 * @param string|string[] $songMid
 * @return array
 */
$api->getMusicHitInfo('001Eo1rF3gYD09,003Inmwn25vHfD');
```

### Get the number of song collections

[](#get-the-number-of-song-collections)

```
/**
 * 通过QQ音乐歌曲ID获取歌曲收藏数
 * @param integer|integer[] $songId
 * @return void
 */
$ret = $api->getMusicFavNum('280494291,280494264');
```

### Get rank chart data

[](#get-rank-chart-data)

```
/**
 * 获取QQ音乐排行榜数据（日榜：今日；周榜：本周）
 * @param mixed $rankId (see \qqMusic\ChartConfig)
 * @return array
 */
$api->getRankChart(\qqMusic\ChartConfig::BILLBOARD_CHART);
```

### Get ranking data of songs

[](#get-ranking-data-of-songs)

```
/**
 * 获取歌曲的排行榜数据
 * @param mixed $checkSongs songId
 * @param array $rankIds 排行榜ID，为空就用配置中默认的
 * @return array
 */
$api->getSongsRankInfo([280494291,280494264]);
```

### Get ranking data of singers

[](#get-ranking-data-of-singers)

```
/**
 * 获取歌手排行榜数据
 * @param string $singerName 歌手名
 * @param array $rankIds 排行榜ID，为空就用配置中默认的
 * @return array
 */
$api->getSingersRankInfo('容祖儿');
```

### Top gift rank

[](#top-gift-rank)

```
/**
 * 巅峰人气榜
 * @param string $type day|week|year|all
 * @param mixed $checkSingers singerId|singerMid
 * @return array
 */
$api->getHitList('all', '000sVzZ83BIMjq');
```

### Best seller rank

[](#best-seller-rank)

```
/**
 * 专辑热销榜
 * @param string $rankType day|week|year|all
 * @param string $albumType single|ep|album|all
 * @return array
 */
$api->getBestSeller();
```

### Yo rank

[](#yo-rank)

```
/**
 * 由你音乐榜
 * @return array
 */
$api->getYoRank();
```

### Search Lyrics

[](#search-lyrics)

```
/**
 * 搜索歌詞
 * @param string $text
 * @return array
 */
$api->searchLyrics('跑车开走');
```

### Search Songs

[](#search-songs)

```
/**
 * 搜索歌曲
 * @param string $name
 * @return array
 */
$api->searchSong('东京人寿');
```

###  Health Score

30

—

LowBetter than 62% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity23

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity55

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

Recently: every ~26 days

Total

9

Last Release

1950d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b09bb3e4c2760b2cf1ee6ad697aec21185a3b2a4074339892333dfea2c996e36?d=identicon)[dony](/maintainers/dony)

---

Top Contributors

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

---

Tags

apimusicqq music

### Embed Badge

![Health badge](/badges/itisbean-php-qq-music-api/health.svg)

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

###  Alternatives

[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3741.3M47](/packages/tencentcloud-tencentcloud-sdk-php)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

273.0k](/packages/eslazarev-wildberries-sdk)[resend/resend-php

Resend PHP library.

617.2M43](/packages/resend-resend-php)[files.com/files-php-sdk

Files.com PHP SDK

2481.1k](/packages/filescom-files-php-sdk)[checkout/checkout-sdk-php

Checkout.com SDK for PHP

563.6M13](/packages/checkout-checkout-sdk-php)[scriptdevelop/whatsapp-manager

Paquete para manejo de WhatsApp Business API en Laravel

783.8k](/packages/scriptdevelop-whatsapp-manager)

PHPackages © 2026

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