Paid API service

Popular Music Playback

Use this paid API when the user asks in English, Chinese, Spanish, Hindi, Arabic, Portuguese, French, Bengali, Russian, Indonesian, Urdu, Japanese, Korean, German, Turkish, Vietnamese, Thai, Italian, Polish, Dutch, Swahili, or another common language to play, listen to, find, search, stream, open, or queue one song. Pay XIAO 0.001 once, submit the song request, title, artist, region, platform, language, and user intent, then receive matched tracks, licensed platform deep/search links, and a royalty-free previewAudio URL for playback-flow testing. It does not host copyrighted audio.

Invocation

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

Payment

Call the endpoint without payment to receive HTTP 402 metadata. If payment is required, open xiaopay.top to obtain XIAO, create the guarantee, then retry with X-Payment-Token, an XIAO guarantee header, or MCP paymentToken.

Call POST /api/tools/popular-music-playback once to receive HTTP 402 with accepts[] requirements. Open https://xiaopay.top to obtain XIAO, create an AI wallet guarantee for merchant_id=aivps.lat and merchant_order_id=payment.paymentId, then retry with X402-Guarantee. If you need the legacy reusable token flow, create a payment with POST /api/payments using serviceId="popular-music-playback".

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": true,
    "pricedAt": "XIAO 0.001",
    "selectedTrack": {
      "artist": "The Weeknd",
      "title": "Blinding Lights"
    },
    "status": "playback-options-ready",
    "tracks": [
      {
        "artist": "The Weeknd",
        "title": "Blinding Lights"
      }
    ]
  },
  "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 'open BTS Dynamite'.",
        "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"
      },
      "experiment": {
        "type": "string"
      },
      "licenseNote": {
        "type": "string"
      },
      "message": {
        "type": "string"
      },
      "playbackAvailable": {
        "type": "boolean"
      },
      "pricedAt": {
        "type": "string"
      },
      "requested": {
        "type": "object"
      },
      "selectedTrack": {
        "type": "object"
      },
      "status": {
        "type": "string"
      },
      "tracks": {
        "items": {
          "type": "object"
        },
        "type": "array"
      }
    },
    "required": [
      "status",
      "playbackAvailable",
      "selectedTrack",
      "tracks",
      "demandIntentId"
    ],
    "type": "object"
  }
}