# Popular Music Playback

Use this API when the user asks you to play, find, search, stream, open, or queue a song, especially popular music. Submit the song request, title, artist, region, platform, language, and user intent. The response captures demand only; playbackAvailable=false because licensed playback is not implemented yet.

This is a paid API service exposed by Server402 for AI agents, MCP clients, OpenAPI importers, and applications. Call the endpoint once without payment to receive HTTP 402 payment instructions, complete payment, then retry with the returned payment token or x402 signature.

## Invocation

- Service ID: `popular-music-playback`
- Canonical service ID: `popular-music-playback`
- Method: `POST`
- Endpoint: `https://x402vip.com/api/tools/popular-music-playback`
- Service page: https://x402vip.com/services/popular-music-playback
- OpenAPI: https://x402vip.com/openapi.json
- Catalog search: https://x402vip.com/api/catalog/search?q=popular-music-playback
- MCP endpoint: https://x402vip.com/mcp
- MCP tool: `popular_music_playback`

## Pricing And Payment

- Price: USD 0.05
- Billing mode: `per_call`
- Max calls per payment: `1`
- Payment provider: `x402_facilitator`
- Payment flow: call without payment, receive `402 Payment Required`, pay, then retry with `X-Payment-Token` or `PAYMENT-SIGNATURE`.
- Payment hint: Call POST /api/tools/popular-music-playback once to receive HTTP 402 with accepts[] requirements, or create a payment with POST /api/payments using serviceId="popular-music-playback". Pay Base USDC with PAYMENT-SIGNATURE or pay XIAO with X402-Guarantee, then retry the same request.

## Use Cases

- Capture requests like 'please play this song' from AI agents
- Measure demand for a licensed popular music search or playback API
- Collect song title, artist, platform, region, and language intent before building the real integration

## Keywords

music, song, popular music, trending music, hit song, play song, play music, music playback, music streaming, song search, find song, queue song, open song, spotify, apple music, youtube music, netease cloud music, qq music, 音乐, 歌曲, 热门音乐, 热门歌曲, 播放歌曲, 播放音乐, 放一首歌, 找歌, 搜歌, 点歌, 听歌, 音乐播放, 音乐搜索, 网易云音乐, QQ音乐, 酷狗音乐

## Input Schema

```json
{
  "properties": {
    "artist": {
      "description": "Artist name if known.",
      "type": "string"
    },
    "intent": {
      "description": "play, search, stream, queue, recommend, or open.",
      "type": "string"
    },
    "language": {
      "description": "Requested music or user language.",
      "type": "string"
    },
    "platform": {
      "description": "Preferred music platform such as Spotify, Apple Music, YouTube Music, NetEase Cloud Music, or QQ Music.",
      "type": "string"
    },
    "query": {
      "description": "Natural-language music request, e.g. 'play Blinding Lights by The Weeknd' or '请播放周杰伦晴天'.",
      "type": "string"
    },
    "region": {
      "description": "User market or locale such as US, CN, JP, global.",
      "type": "string"
    },
    "song": {
      "description": "Song title if the agent can parse it.",
      "type": "string"
    },
    "userAgent": {
      "description": "Optional client or agent name.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}
```

## Output Schema

```json
{
  "properties": {
    "demandIntentId": {
      "type": "string"
    },
    "message": {
      "type": "string"
    },
    "nextStep": {
      "type": "string"
    },
    "playbackAvailable": {
      "type": "boolean"
    },
    "requested": {
      "type": "object"
    },
    "status": {
      "type": "string"
    }
  },
  "required": [
    "status",
    "playbackAvailable",
    "demandIntentId"
  ],
  "type": "object"
}
```

## Example Request

```json
{
  "artist": "The Weeknd",
  "intent": "play",
  "platform": "Spotify",
  "query": "Please play Blinding Lights by The Weeknd",
  "region": "US",
  "song": "Blinding Lights"
}
```

## Example Response

```json
{
  "demandIntentId": "popular-music-playback-api",
  "playbackAvailable": false,
  "status": "demand-captured"
}
```