Meting-API User Guide

2026-02-28

Meting_kugouThis site does not provide any services; the following is provided solely as a repository demo.

1. Base Address

Main Address：https://api.kfjie.me/music
Request Method：GET
Uses : Provides a unified data interface for MetingJS, APlayer, and the site’s custom player

2. Common Parameters

The three most commonly used parameters for the interface are as follows:

Parameters	Note
`server`	Platforms, such as `netease`、`tencent`、`kugou`
`type`	Operation types, such as `search`、`song`、`playlist`、`album`
`id`	Resource IDs, keywords, and hashes for the corresponding platform, or Kugou Desktop playlist share shortcodes/links

Common type：

`type`	Function	Back
`search`	Search for Songs	JSON Array
`song`	View Single Details	JSON array
`playlist`	Get the playlist list	JSON array
`album`	Get the songs from the album	JSON array
`artist`	Get the Artist’s Top Songs	JSON array
`url`	Get the playback URL	302 / 404
`pic`	Get the cover URL	302
`lrc`	Get Lyrics	Text

3. What do the return results look like?

search / song / album / artist / playlist Typically returns a JSON array:

[
  {
    "title": "歌曲名称",
    "author": "艺术家1 / 艺术家2",
    "url": "https://api.kfjie.me/music?server=kugou&type=url&id=xxx&auth=xxx",
    "pic": "https://api.kfjie.me/music?server=kugou&type=pic&id=xxx&auth=xxx",
    "lrc": "https://api.kfjie.me/music?server=kugou&type=lrc&id=xxx&auth=xxx"
  }
]

url / pic It will perform a 302 redirect directly to the actual resource;lrc Returns the lyrics text. In actual implementation, there’s generally no need to manually construct these sublinks; the player will consume them directly. song / album Ready-made fields from the return results.

4. Regarding `auth` `key`

url / pic / lrc These types of sensitive resources will be marked with auth. For everyday use, there is usually no need to calculate the link manually; you can simply use the ready-made link returned by the API.

If you hold a server-assigned key, or you can include it in the request key=... Use the KuGou Pro pool directly and continue accessing content within the corresponding minute allowance. url / pic / lrc, In such scenarios, there’s no need to make an extra effort auth。

5. Common Access Methods

Scenario A: Front-End Integration (MetingJS)

Simply point the unified API URL to this site’s API:

<!-- 设定接口主轴引擎 -->
<script>
    var meting_api = 'https://api.kfjie.me/music?server=:server&type=:type&id=:id&auth=:auth&r=:r';
</script>
<!-- 调用指定参数渲染音乐卡片 -->
<meting-js server="netease" type="song" id="29732235"></meting-js>

Scenario B: Quick Test

You can use these items to quickly check if everything is working properly:

Get song details：

curl "https://api.kfjie.me/music?server=kugou&type=song&id=d0ee43db52939cb9feefa4513573ffb4"

Search for content related to a specific artist：

curl "https://api.kfjie.me/music?server=kugou&type=search&id=邓紫棋"

Get KuGou Desktop Playlist Sharing：

curl "https://api.kfjie.me/music?server=kugou&type=playlist&id=7PUvhf0FZV2"

6. Recommendations for Use

When a player is needed, use song / playlist / album Ready-made returns url、pic、lrc
When troubleshooting is needed, start by testing search or song, then check whether the player can properly process the returned result
When sharing playlists on Kugou Desktop, prioritize uploading short codes or t1.kugou.com Use short links; avoid relying directly on long links with signed parameters.
For the KuGou scenario, we recommend using song hashes directly at runtime rather than relying on album expansion.
Currently, Kugou playlists can be shared using the desktop version of KUGOU’s share links, which provide detailed access to all Kugou playlists. We recommend using the standard method. type=playlist, and put id Chuancheng shares short codes or short links, such as 7PUvhf0FZV2 or https://t1.kugou.com/7PUvhf0FZV2。
The mobile version of the share link cannot be parsed at this time.
~~Maybe I could use a KuGou code? But it’s such a hassle—I don’t feel like dealing with it. Does anyone have a ready-made one?~~