Paid API service

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.

Invocation

Service ID: popular-music-playback
Method: POST
Endpoint: /api/tools/popular-music-playback
Legacy Endpoint: none
MCP Tool: popular_music_playback
Price: USD 0.05

Payment

Call the endpoint without payment to receive HTTP 402 metadata. After payment is complete, retry with X-Payment-Token, an x402 payment signature, or MCP paymentToken.

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.

Schema And Examples

{
  "exampleRequest": {
    "artist": "The Weeknd",
    "intent": "play",
    "platform": "Spotify",
    "query": "Please play Blinding Lights by The Weeknd",
    "region": "US",
    "song": "Blinding Lights"
  },
  "exampleResponse": {
    "demandIntentId": "popular-music-playback-api",
    "playbackAvailable": false,
    "status": "demand-captured"
  },
  "inputSchema": {
    "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"
  },
  "outputSchema": {
    "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"
  }
}