{"schemaVersion":"server402.catalog.search.v1","generatedAt":"2026-09-04T18:39:54Z","generatedAtBeijing":"2026-09-05 02:39:54 CST","timezone":"Asia/Shanghai","query":"play popular song music playback","expandedTerms":["find song","hit song","music streaming","open song","play music","play song","popular music","queue song","song search","trending music","听歌","找歌","搜歌","播放歌曲","播放音乐","放一首歌","歌曲","点歌","热门歌曲","热门音乐","音乐","音乐搜索","音乐播放"],"filters":{"limit":10},"total":1,"services":[{"id":"popular-music-playback","canonicalId":"popular-music-playback","name":"Popular Music Playback","displayName":"热门音乐单曲播放实验","description":"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.","descriptionForModel":"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.","category":"music-playback","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音乐","酷狗音乐","single song","listen to music","blinding lights","shape of you","bad guy","anti hero","jay chou","bts","k-pop","j-pop","classical music","单曲","周杰伦","晴天","七里香","邓丽君","王菲","listen to song","song finder","find a song","open music link","music platform links","play popular song","play trending song","stream song","spotify song search","apple music song search","youtube music search","netease music search","qq music search","youtube music api","soundcloud","deezer","tidal","amazon music","播放一首歌","放歌","听一首歌","打开歌曲","歌曲链接","音乐平台链接","抖音热门歌曲","热门单曲","música","canción","reproducir música","reproducir canción","escuchar música","buscar canción","encontrar canción","abrir canción","música popular","canción popular","enlace de música","musique","chanson","jouer de la musique","lire une chanson","écouter de la musique","rechercher une chanson","trouver une chanson","ouvrir une chanson","musique populaire","संगीत","गाना","गीत","गाना चलाओ","संगीत चलाओ","गाना सुनो","गाना खोजो","लोकप्रिय गाना","म्यूजिक लिंक","موسيقى","أغنية","تشغيل أغنية","تشغيل الموسيقى","استمع إلى الموسيقى","ابحث عن أغنية","افتح أغنية","أغنية مشهورة","música tocar","tocar música","tocar uma música","ouvir música","buscar música","procurar música","abrir música","музыка","песня","включить музыку","включить песню","слушать музыку","найти песню","поиск песни","популярная музыка","musik","lagu","putar musik","putar lagu","dengarkan musik","cari lagu","buka lagu","lagu populer","সঙ্গীত","গান","গান চালাও","সঙ্গীত চালাও","গান শুনুন","গান খুঁজুন","জনপ্রিয় গান","موسیقی","گانا","گانا چلائیں","موسیقی چلائیں","گانا سنیں","گانا تلاش کریں","مشہور گانا","音楽","曲","歌","音楽を再生","曲を再生","音楽を聴く","曲を検索","曲を探す","人気曲","音楽リンク","음악","노래","음악 재생","노래 재생","음악 듣기","노래 검색","노래 찾기","인기곡","음악 링크","เพลง","ดนตรี","เปิดเพลง","เล่นเพลง","ฟังเพลง","ค้นหาเพลง","เพลงยอดนิยม","nhạc","bài hát","phát nhạc","phát bài hát","nghe nhạc","tìm bài hát","bài hát phổ biến","müzik","şarkı","müzik çal","şarkı çal","müzik dinle","şarkı ara","popüler şarkı","Lied","Musik abspielen","Lied abspielen","Musik hören","Lied suchen","beliebtes Lied","musica","canzone","riproduci musica","riproduci canzone","ascolta musica","cerca canzone","canzone popolare","muziek","speel muziek","speel liedje","luister muziek","zoek lied","populair lied","muzyka","piosenka","odtwórz muzykę","odtwórz piosenkę","słuchaj muzyki","znajdź piosenkę","popularna piosenka","muzik","chante","jwe mizik","jwe chante","koute mizik","chache chante","musiikki","laulu","soita musiikkia","soita kappale","kuuntele musiikkia","etsi kappale","muziki","wimbo","cheza muziki","cheza wimbo","sikiliza muziki","tafuta wimbo","संगीत चलवा","गाना बजाओ","เพลงฮิต","lagu hits","canción viral","trending song","cancion","reproducir musica","reproducir cancion","escuchar musica","buscar cancion","encontrar cancion","abrir cancion","musica popular","cancion popular","enlace de musica","ecouter de la musique"],"useCases":["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","Let an AI agent pay XIAO 0.001 to satisfy a user's request to play one song","Return provider links for Spotify, Apple Music, YouTube Music, NetEase Cloud Music, and QQ Music","Measure whether agents continue after HTTP 402 and complete payment for consumer entertainment intent","Test playback UX using royalty-free previewAudio while avoiding copyrighted audio hosting","Handle natural-language requests like play popular song, open a track, search this song, or queue music","Capture multilingual music playback intent, including play song phrases in Chinese, Spanish, Hindi, Arabic, Portuguese, French, Bengali, Russian, Indonesian, Urdu, Japanese, Korean, German, Turkish, Vietnamese, Thai, Italian, Polish, Dutch, and Swahili","Accept GET discovery traffic such as /api/music/search?q=play%20popular%20song and POST JSON calls from agents"],"limitations":["Demand-capture probe only; it does not stream, host, download, or return copyrighted audio","Use the response as a signal to build a licensed provider integration if demand is high","Does not host, download, or return copyrighted audio files","Provider links open licensed platforms; actual playback may require the user's own account or regional availability","previewAudio is royalty-free sample audio for agent playback-flow testing, not the copyrighted requested song"],"tags":["music","playback","song-search","demand-capture","agent-intent","popular","x402","micro-payment","xiao"],"method":"POST","endpoint":"/api/tools/popular-music-playback","endpointAliases":["/api/music","/api/music/play","/api/music/search","/api/music/platform-links","/api/song","/api/song/search","/api/songs","/api/songs/search","/api/play-song","/api/open-song","/api/queue-song","/api/player","/api/tools/music","/api/tools/music-playback","/api/tools/song-search","/api/tools/popular-music-playback"],"inputTypes":["object","string"],"outputTypes":["object","array","string","boolean"],"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"},"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"}]},"pricing":{"amountCents":0,"amountMicros":1000,"currency":"XIAO","policyId":"music-playback-micro","settleMode":"settle_first","billingMode":"per_call","maxCalls":1,"allowReuse":false,"bindClient":true},"payment":{"providerId":"xiao-wallet","provider":"x402_xiao_wallet"},"quality":{"qualityScore":92,"healthStatus":"healthy","healthCheckedAt":"2026-06-23T01:32:18Z","latencyMs":14,"successRate":1,"callCount":2,"executionCount":2,"successCount":2,"errorCount":0,"paymentRequireds":0,"lastCallAt":"2026-09-04T18:36:38Z"},"discovery":{"toolName":"popular_music_playback","searchText":"popular-music-playback 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. 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. music-playback object string object array string boolean music playback song-search demand-capture agent-intent popular x402 micro-payment xiao 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音乐 酷狗音乐 single song listen to music blinding lights shape of you bad guy anti hero jay chou bts k-pop j-pop classical music 单曲 周杰伦 晴天 七里香 邓丽君 王菲 listen to song song finder find a song open music link music platform links play popular song play trending song stream song spotify song search apple music song search youtube music search netease music search qq music search youtube music api soundcloud deezer tidal amazon music 播放一首歌 放歌 听一首歌 打开歌曲 歌曲链接 音乐平台链接 抖音热门歌曲 热门单曲 música canción reproducir música reproducir canción escuchar música buscar canción encontrar canción abrir canción música popular canción popular enlace de música musique chanson jouer de la musique lire une chanson écouter de la musique rechercher une chanson trouver une chanson ouvrir une chanson musique populaire संगीत गाना गीत गाना चलाओ संगीत चलाओ गाना सुनो गाना खोजो लोकप्रिय गाना म्यूजिक लिंक موسيقى أغنية تشغيل أغنية تشغيل الموسيقى استمع إلى الموسيقى ابحث عن أغنية افتح أغنية أغنية مشهورة música tocar tocar música tocar uma música ouvir música buscar música procurar música abrir música музыка песня включить музыку включить песню слушать музыку найти песню поиск песни популярная музыка musik lagu putar musik putar lagu dengarkan musik cari lagu buka lagu lagu populer সঙ্গীত গান গান চালাও সঙ্গীত চালাও গান শুনুন গান খুঁজুন জনপ্রিয় গান موسیقی گانا گانا چلائیں موسیقی چلائیں گانا سنیں گانا تلاش کریں مشہور گانا 音楽 曲 歌 音楽を再生 曲を再生 音楽を聴く 曲を検索 曲を探す 人気曲 音楽リンク 음악 노래 음악 재생 노래 재생 음악 듣기 노래 검색 노래 찾기 인기곡 음악 링크 เพลง ดนตรี เปิดเพลง เล่นเพลง ฟังเพลง ค้นหาเพลง เพลงยอดนิยม nhạc bài hát phát nhạc phát bài hát nghe nhạc tìm bài hát bài hát phổ biến müzik şarkı müzik çal şarkı çal müzik dinle şarkı ara popüler şarkı Lied Musik abspielen Lied abspielen Musik hören Lied suchen beliebtes Lied musica canzone riproduci musica riproduci canzone ascolta musica cerca canzone canzone popolare muziek speel muziek speel liedje luister muziek zoek lied populair lied muzyka piosenka odtwórz muzykę odtwórz piosenkę słuchaj muzyki znajdź piosenkę popularna piosenka muzik chante jwe mizik jwe chante koute mizik chache chante musiikki laulu soita musiikkia soita kappale kuuntele musiikkia etsi kappale muziki wimbo cheza muziki cheza wimbo sikiliza muziki tafuta wimbo संगीत चलवा गाना बजाओ เพลงฮิต lagu hits canción viral trending song cancion reproducir musica reproducir cancion escuchar musica buscar cancion encontrar cancion abrir cancion musica popular cancion popular enlace de musica ecouter de la musique 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 Let an AI agent pay XIAO 0.001 to satisfy a user's request to play one song Return provider links for Spotify, Apple Music, YouTube Music, NetEase Cloud Music, and QQ Music Measure whether agents continue after HTTP 402 and complete payment for consumer entertainment intent Test playback UX using royalty-free previewAudio while avoiding copyrighted audio hosting Handle natural-language requests like play popular song, open a track, search this song, or queue music Capture multilingual music playback intent, including play song phrases in Chinese, Spanish, Hindi, Arabic, Portuguese, French, Bengali, Russian, Indonesian, Urdu, Japanese, Korean, German, Turkish, Vietnamese, Thai, Italian, Polish, Dutch, and Swahili Accept GET discovery traffic such as /api/music/search?q=play%20popular%20song and POST JSON calls from agents Demand-capture probe only; it does not stream, host, download, or return copyrighted audio Use the response as a signal to build a licensed provider integration if demand is high Does not host, download, or return copyrighted audio files Provider links open licensed platforms; actual playback may require the user's own account or regional availability previewAudio is royalty-free sample audio for agent playback-flow testing, not the copyrighted requested song /api/tools/popular-music-playback","aliases":["Popular Music Playback","music-playback","热门音乐单曲播放实验","music","playback","song-search","demand-capture","agent-intent","popular","x402","micro-payment","xiao","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音乐","酷狗音乐","single song","listen to music","blinding lights","shape of you","bad guy","anti hero","jay chou","bts","k-pop","j-pop","classical music","单曲","周杰伦","晴天","七里香","邓丽君","王菲","listen to song","song finder","find a song","open music link","music platform links","play popular song","play trending song","stream song","spotify song search","apple music song search","youtube music search","netease music search","qq music search","youtube music api","soundcloud","deezer","tidal","amazon music","播放一首歌","放歌","听一首歌","打开歌曲","歌曲链接","音乐平台链接","抖音热门歌曲","热门单曲","música","canción","reproducir música","reproducir canción","escuchar música","buscar canción","encontrar canción","abrir canción","música popular","canción popular","enlace de música","musique","chanson","jouer de la musique","lire une chanson","écouter de la musique","rechercher une chanson","trouver une chanson","ouvrir une chanson","musique populaire","संगीत","गाना","गीत","गाना चलाओ","संगीत चलाओ","गाना सुनो","गाना खोजो","लोकप्रिय गाना","म्यूजिक लिंक","موسيقى","أغنية","تشغيل أغنية","تشغيل الموسيقى","استمع إلى الموسيقى","ابحث عن أغنية","افتح أغنية","أغنية مشهورة","música tocar","tocar música","tocar uma música","ouvir música","buscar música","procurar música","abrir música","музыка","песня","включить музыку","включить песню","слушать музыку","найти песню","поиск песни","популярная музыка","musik","lagu","putar musik","putar lagu","dengarkan musik","cari lagu","buka lagu","lagu populer","সঙ্গীত","গান","গান চালাও","সঙ্গীত চালাও","গান শুনুন","গান খুঁজুন","জনপ্রিয় গান","موسیقی","گانا","گانا چلائیں","موسیقی چلائیں","گانا سنیں","گانا تلاش کریں","مشہور گانا","音楽","曲","歌","音楽を再生","曲を再生","音楽を聴く","曲を検索","曲を探す","人気曲","音楽リンク","음악","노래","음악 재생","노래 재생","음악 듣기","노래 검색","노래 찾기","인기곡","음악 링크","เพลง","ดนตรี","เปิดเพลง","เล่นเพลง","ฟังเพลง","ค้นหาเพลง","เพลงยอดนิยม","nhạc","bài hát","phát nhạc","phát bài hát","nghe nhạc","tìm bài hát","bài hát phổ biến","müzik","şarkı","müzik çal","şarkı çal","müzik dinle","şarkı ara","popüler şarkı","Lied","Musik abspielen","Lied abspielen","Musik hören","Lied suchen","beliebtes Lied","musica","canzone","riproduci musica","riproduci canzone","ascolta musica","cerca canzone","canzone popolare","muziek","speel muziek","speel liedje","luister muziek","zoek lied","populair lied","muzyka","piosenka","odtwórz muzykę","odtwórz piosenkę","słuchaj muzyki","znajdź piosenkę","popularna piosenka","muzik","chante","jwe mizik","jwe chante","koute mizik","chache chante","musiikki","laulu","soita musiikkia","soita kappale","kuuntele musiikkia","etsi kappale","muziki","wimbo","cheza muziki","cheza wimbo","sikiliza muziki","tafuta wimbo","संगीत चलवा","गाना बजाओ","เพลงฮิต","lagu hits","canción viral","trending song","cancion","reproducir musica","reproducir cancion","escuchar musica","buscar cancion","encontrar cancion","abrir cancion","musica popular","cancion popular","enlace de musica","ecouter de la musique","popular-music-playback","popular_music_playback","/api/tools/popular-music-playback"],"localeHints":["en","zh","es","hi","ar","pt","fr","bn","ru","id","ur","ja","ko","de","tr","vi","th","it","pl","nl","sw"],"useCases":["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","Let an AI agent pay XIAO 0.001 to satisfy a user's request to play one song","Return provider links for Spotify, Apple Music, YouTube Music, NetEase Cloud Music, and QQ Music","Measure whether agents continue after HTTP 402 and complete payment for consumer entertainment intent","Test playback UX using royalty-free previewAudio while avoiding copyrighted audio hosting","Handle natural-language requests like play popular song, open a track, search this song, or queue music","Capture multilingual music playback intent, including play song phrases in Chinese, Spanish, Hindi, Arabic, Portuguese, French, Bengali, Russian, Indonesian, Urdu, Japanese, Korean, German, Turkish, Vietnamese, Thai, Italian, Polish, Dutch, and Swahili","Accept GET discovery traffic such as /api/music/search?q=play%20popular%20song and POST JSON calls from agents"],"limitations":["Demand-capture probe only; it does not stream, host, download, or return copyrighted audio","Use the response as a signal to build a licensed provider integration if demand is high","Does not host, download, or return copyrighted audio files","Provider links open licensed platforms; actual playback may require the user's own account or regional availability","previewAudio is royalty-free sample audio for agent playback-flow testing, not the copyrighted requested song"],"paymentFlow":{"type":"http-402","createPayment":{"method":"POST","url":"/api/payments","bodySchema":{"properties":{"providerId":{"type":"string"},"serviceId":{"description":"Use the canonical service id from the catalog. Legacy internal ids remain accepted for backward compatibility.","type":"string"}},"required":["serviceId"],"type":"object"},"responseSchema":{"properties":{"amountCents":{"type":"integer"},"amountMicros":{"type":"integer"},"billingMode":{"type":"string"},"clientId":{"type":"string"},"currency":{"type":"string"},"expiresAt":{"format":"date-time","type":"string"},"internalServiceId":{"description":"Legacy internal service id, included only for backward compatibility.","type":"string"},"maxCalls":{"type":"integer"},"paidAt":{"format":"date-time","type":"string"},"payTo":{"type":"string"},"paymentId":{"type":"string"},"provider":{"type":"string"},"providerId":{"type":"string"},"remainingCalls":{"type":"integer"},"serviceId":{"description":"Canonical public service id.","type":"string"},"status":{"type":"string"},"token":{"type":"string"},"usedCalls":{"type":"integer"}},"type":"object"}},"verifyPayment":{"method":"GET","url":"/api/payments/{paymentId}","responseSchema":{"properties":{"amountCents":{"type":"integer"},"amountMicros":{"type":"integer"},"billingMode":{"type":"string"},"clientId":{"type":"string"},"currency":{"type":"string"},"expiresAt":{"format":"date-time","type":"string"},"internalServiceId":{"description":"Legacy internal service id, included only for backward compatibility.","type":"string"},"maxCalls":{"type":"integer"},"paidAt":{"format":"date-time","type":"string"},"payTo":{"type":"string"},"paymentId":{"type":"string"},"provider":{"type":"string"},"providerId":{"type":"string"},"remainingCalls":{"type":"integer"},"serviceId":{"description":"Canonical public service id.","type":"string"},"status":{"type":"string"},"token":{"type":"string"},"usedCalls":{"type":"integer"}},"type":"object"}},"token":{"header":"X-Payment-Token","mcpArgument":"paymentToken","httpUsage":"Send the paid token in the X-Payment-Token request header when calling /api/tools/*.","mcpUsage":"Pass the paid token as the paymentToken argument when calling the MCP tool."},"requiredResponse":{"status":402,"contentType":"application/json","headers":{"PAYMENT-REQUIRED":"base64/json paymentRequired","X-Payment-Required":"true","X-Payment-Token":"payment.token","X402-Guarantee":"base64url/json XIAO escrow guarantee"},"bodySchema":{"properties":{"accepts":{"items":{"type":"object"},"type":"array"},"error":{"type":"string"},"extensions":{"type":"object"},"payment":{"properties":{"amountCents":{"type":"integer"},"amountMicros":{"type":"integer"},"billingMode":{"type":"string"},"clientId":{"type":"string"},"currency":{"type":"string"},"expiresAt":{"format":"date-time","type":"string"},"internalServiceId":{"description":"Legacy internal service id, included only for backward compatibility.","type":"string"},"maxCalls":{"type":"integer"},"paidAt":{"format":"date-time","type":"string"},"payTo":{"type":"string"},"paymentId":{"type":"string"},"provider":{"type":"string"},"providerId":{"type":"string"},"remainingCalls":{"type":"integer"},"serviceId":{"description":"Canonical public service id.","type":"string"},"status":{"type":"string"},"token":{"type":"string"},"usedCalls":{"type":"integer"}},"type":"object"},"paymentFlow":{"type":"object"},"resource":{"type":"object"},"retry":{"type":"object"},"type":{"const":"payment_required","type":"string"},"x402Version":{"type":"integer"}},"required":["type","error","payment","paymentFlow","retry"],"type":"object"},"x402Version":2,"x402Header":"PAYMENT-REQUIRED","paymentAsset":"XIAO","paymentNetwork":"xiao:internal"},"retry":{"when":"Retry after opening xiaopay.top, obtaining XIAO, and creating one XIAO accepts[] guarantee or after payment.status is paid and the token has remaining calls.","http":["Call the paid /api/tools/* endpoint once and read accepts[] from the HTTP 402 response body or PAYMENT-REQUIRED header.","Open https://xiaopay.top to obtain XIAO, then create an AI wallet guarantee for merchant_id=aivps.lat and merchant_order_id=payment.paymentId.","Retry the exact same request with X402-Guarantee set to the base64url guarantee JSON.","Use POST /api/payments with serviceId when you need a reusable payment token, then retry with X-Payment-Token set to payment.token."],"mcp":["Call the tool without paymentToken to receive payment_required structuredContent.","XIAO-capable agents should open xiaopay.top, obtain XIAO, create the AI wallet guarantee, and call the underlying HTTP endpoint with X402-Guarantee.","Clients that use paymentToken can complete or verify payment.paymentId, then call the same MCP tool again with paymentToken set to payment.token."],"examples":{"mcp":["Call tool timestamp with no paymentToken.","After payment is complete, call timestamp again with paymentToken=\u003cpayment.token\u003e."],"paymentToken":["curl -X POST https://example.com/api/payments -H 'Content-Type: application/json' -d '{\"serviceId\":\"timestamp\"}'","curl -H 'X-Payment-Token: \u003cpayment.token\u003e' https://example.com/api/tools/timestamp"],"xiao":["curl -i https://example.com/api/tools/timestamp","Open https://xiaopay.top, obtain XIAO, and create an AI wallet guarantee for merchant_id=aivps.lat and merchant_order_id=payment.paymentId.","curl -H 'X402-Guarantee: \u003cbase64url-guarantee-json\u003e' https://example.com/api/tools/timestamp"]},"failures":["payment required","payment token expired","payment token has no remaining calls","api key required","api key is not allowed to call this service"]}},"paymentHint":"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\".","retryHint":"If the service returns HTTP 402, open https://xiaopay.top to obtain XIAO, then retry with X402-Guarantee for the guarantee flow or X-Payment-Token for the legacy token flow.","requiredState":"published, enabled"},"complexity":"simple","typicalResponseTime":"\u003c100ms","cacheable":false,"idempotent":true,"outputFormat":"json","relatedServices":["search-trends-api","web-search-api"],"alternativeServices":["/api/music","/api/music/play","/api/music/search","/api/music/platform-links","/api/song","/api/song/search","/api/songs","/api/songs/search","/api/play-song","/api/open-song","/api/queue-song","/api/player","/api/tools/music","/api/tools/music-playback","/api/tools/song-search","/api/tools/popular-music-playback"],"requiredContext":["song title or natural-language playback request"],"matchScore":406,"matchTerms":["play","popular","song","music","playback","find song","hit song","music streaming","open song","play music","play song","popular music","queue song","song search","trending music","听歌","找歌","搜歌","播放歌曲","播放音乐","放一首歌","歌曲","点歌","热门歌曲","热门音乐","音乐","音乐搜索","音乐播放"],"why":"Matched play, popular, song, music, playback, find song, hit song, music streaming, open song, play music, play song, popular music, queue song, song search, trending music, 听歌, 找歌, 搜歌, 播放歌曲, 播放音乐, 放一首歌, 歌曲, 点歌, 热门歌曲, 热门音乐, 音乐, 音乐搜索, 音乐播放 for \"Popular Music Playback\". Price is XIAO 0.001 per policy music-playback-micro.","whyMatched":"Matched play, popular, song, music, playback, find song, hit song, music streaming, open song, play music, play song, popular music, queue song, song search, trending music, 听歌, 找歌, 搜歌, 播放歌曲, 播放音乐, 放一首歌, 歌曲, 点歌, 热门歌曲, 热门音乐, 音乐, 音乐搜索, 音乐播放 for \"Popular Music Playback\". Price is XIAO 0.001 per policy music-playback-micro."}],"agents":[{"id":"popular-music-playback","name":"Popular Music Playback","description":"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.","endpoint":"/api/tools/popular-music-playback","method":"POST","auth_type":"api_key + x402_xiao_wallet http_402","billing_method":"per_call","pricing":{"amountCents":0,"amountMicros":1000,"currency":"XIAO","policyId":"music-playback-micro","settleMode":"settle_first","billingMode":"per_call","maxCalls":1,"allowReuse":false,"bindClient":true},"input_schema":{"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"},"output_schema":{"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"},"tags":["music","playback","song-search","demand-capture","agent-intent","popular","x402","micro-payment","xiao"],"category":"music-playback"}],"demandCapture":{"queryRecorded":true,"demandBearing":true,"status":"published-and-planned-candidates","recommendedAction":"compare-published-services-and-request-missing-fit","message":"Published services and planned API candidates both matched. Prefer a published callable service when it fits; otherwise request early access for the planned candidate that better matches the task.","matchedPlannedServices":[{"id":"popular-music-playback-api","name":"热门音乐播放 API","category":"音乐娱乐","availability":"可新增","status":"planned / early-access","servicePage":"https://x402vip.com/services/popular-music-playback-api","llmsText":"https://x402vip.com/services/popular-music-playback-api/llms.txt","requestAccessUrl":"https://x402vip.com/api/planned-services/request-access","candidateApiPaths":["https://x402vip.com/api/music","https://x402vip.com/api/music/play","https://x402vip.com/api/music/search","https://x402vip.com/api/music/platform-links"],"keywords":["popular-music-playback-api","popular-music-playback","popular music playback","热门音乐播放 API","music playback api","popular music api","song search api","play song api","music streaming api","spotify api","apple music api","youtube music api","热门音乐 API","歌曲播放 API","music","song","single song","popular music","trending music","hit song","play song","play music","listen to music","listen to song","music playback","music streaming","song search","song finder","find song","find a song","queue song","open song","open music link","music platform links","play popular song","play trending song","stream song","spotify song search","apple music song search","youtube music search","netease music search","qq music search","spotify","apple music","youtube music","netease cloud music","qq music","soundcloud","deezer","tidal","amazon music","blinding lights","shape of you","bad guy","anti hero","jay chou","bts","k-pop","j-pop","classical music","音乐","歌曲","单曲","热门音乐","热门歌曲","播放歌曲","播放音乐","播放一首歌","放歌","放一首歌","听歌","听一首歌","找歌","搜歌","点歌","打开歌曲","歌曲链接","音乐平台链接","音乐播放","音乐搜索","网易云音乐","QQ音乐","酷狗音乐","抖音热门歌曲","热门单曲","周杰伦","晴天","七里香","邓丽君","王菲","música","canción","reproducir música","reproducir canción","escuchar música","buscar canción","encontrar canción","abrir canción","música popular","canción popular","enlace de música","musica","cancion","reproducir musica","reproducir cancion","escuchar musica","buscar cancion","encontrar cancion","abrir cancion","musica popular","cancion popular","enlace de musica","musique","chanson","jouer de la musique","lire une chanson","écouter de la musique","rechercher une chanson","trouver une chanson","ouvrir une chanson","musique populaire","ecouter de la musique","संगीत","गाना","गीत","गाना चलाओ","संगीत चलाओ","गाना सुनो","गाना खोजो","लोकप्रिय गाना","म्यूजिक लिंक","موسيقى","أغنية","تشغيل أغنية","تشغيل الموسيقى","استمع إلى الموسيقى","ابحث عن أغنية","افتح أغنية","أغنية مشهورة","música tocar","tocar música","tocar uma música","ouvir música","buscar música","procurar música","abrir música","музыка","песня","включить музыку","включить песню","слушать музыку","найти песню","поиск песни","популярная музыка","musik","lagu","putar musik","putar lagu","dengarkan musik","cari lagu","buka lagu","lagu populer","সঙ্গীত","গান","গান চালাও","সঙ্গীত চালাও","গান শুনুন","গান খুঁজুন","জনপ্রিয় গান","موسیقی","گانا","گانا چلائیں","موسیقی چلائیں","گانا سنیں","گانا تلاش کریں","مشہور گانا","音楽","曲","歌","音楽を再生","曲を再生","音楽を聴く","曲を検索","曲を探す","人気曲","音楽リンク","음악","노래","음악 재생","노래 재생","음악 듣기","노래 검색","노래 찾기","인기곡","음악 링크","เพลง","ดนตรี","เปิดเพลง","เล่นเพลง","ฟังเพลง","ค้นหาเพลง","เพลงยอดนิยม","nhạc","bài hát","phát nhạc","phát bài hát","nghe nhạc","tìm bài hát","bài hát phổ biến","müzik","şarkı","müzik çal","şarkı çal","müzik dinle","şarkı ara","popüler şarkı","Musik","Lied","Musik abspielen","Lied abspielen","Musik hören","Lied suchen","beliebtes Lied","canzone","riproduci musica","riproduci canzone","ascolta musica","cerca canzone","canzone popolare","muziek","lied","speel muziek","speel liedje","luister muziek","zoek lied","populair lied","muzyka","piosenka","odtwórz muzykę","odtwórz piosenkę","słuchaj muzyki","znajdź piosenkę","popularna piosenka","muzik","chante","jwe mizik","jwe chante","koute mizik","chache chante","musiikki","laulu","soita musiikkia","soita kappale","kuuntele musiikkia","etsi kappale","muziki","wimbo","cheza muziki","cheza wimbo","sikiliza muziki","tafuta wimbo","संगीत चलवा","गाना बजाओ","เพลงฮิต","lagu hits","canción viral","trending song"],"matchRank":1,"matchReason":"Search query matched this planned demand candidate; request-access and candidate path visits are aggregated for launch prioritization."}],"requestAccessUrl":"https://x402vip.com/api/planned-services/request-access","requestAccessBody":{"query":"play popular song music playback","serviceId":"popular-music-playback-api","task":"Describe the exact input data, desired output schema, freshness, volume, budget, and whether a published service failed to fit.","useCase":"AI/Agent searched for: play popular song music playback"},"plannedCatalogUrl":"https://x402vip.com/api/demand-capture","notes":["Every non-admin /api/catalog/search?q=... request is appended to natural_traffic.jsonl and aggregated in /api/admin/demand-intents.","Submitting requestAccessBody adds a stronger commercial/early-access signal than search alone.","Planned API candidates are not callable yet; use /api/catalog services for currently callable paid APIs."]},"nextActions":["Inspect services[].inputSchema, services[].outputSchema, services[].pricing, and services[].discovery.paymentFlow.","Call the selected /api/tools/* endpoint once without payment to receive HTTP 402 payment requirements, open xiaopay.top to obtain XIAO, then retry with X402-Guarantee.","If services are missing or too broad, inspect demandCapture.matchedPlannedServices.","POST demandCapture.requestAccessBody to demandCapture.requestAccessUrl to record a stronger early-access demand signal."],"payment":{"paymentHeader":"X-Payment-Token","createPayment":"/api/payments","verifyPayment":"/api/payments/{paymentId}","token":{"header":"X-Payment-Token","mcpArgument":"paymentToken","httpUsage":"Send the paid token in the X-Payment-Token request header when calling /api/tools/*.","mcpUsage":"Pass the paid token as the paymentToken argument when calling the MCP tool."},"requiredResponse":{"status":402,"contentType":"application/json","headers":{"PAYMENT-REQUIRED":"base64/json paymentRequired","X-Payment-Required":"true","X-Payment-Token":"payment.token","X402-Guarantee":"base64url/json XIAO escrow guarantee"},"bodySchema":{"properties":{"accepts":{"items":{"type":"object"},"type":"array"},"error":{"type":"string"},"extensions":{"type":"object"},"payment":{"properties":{"amountCents":{"type":"integer"},"amountMicros":{"type":"integer"},"billingMode":{"type":"string"},"clientId":{"type":"string"},"currency":{"type":"string"},"expiresAt":{"format":"date-time","type":"string"},"internalServiceId":{"description":"Legacy internal service id, included only for backward compatibility.","type":"string"},"maxCalls":{"type":"integer"},"paidAt":{"format":"date-time","type":"string"},"payTo":{"type":"string"},"paymentId":{"type":"string"},"provider":{"type":"string"},"providerId":{"type":"string"},"remainingCalls":{"type":"integer"},"serviceId":{"description":"Canonical public service id.","type":"string"},"status":{"type":"string"},"token":{"type":"string"},"usedCalls":{"type":"integer"}},"type":"object"},"paymentFlow":{"type":"object"},"resource":{"type":"object"},"retry":{"type":"object"},"type":{"const":"payment_required","type":"string"},"x402Version":{"type":"integer"}},"required":["type","error","payment","paymentFlow","retry"],"type":"object"},"x402Version":2,"x402Header":"PAYMENT-REQUIRED","paymentAsset":"XIAO","paymentNetwork":"xiao:internal"},"retry":{"when":"Retry after opening xiaopay.top, obtaining XIAO, and creating one XIAO accepts[] guarantee or after payment.status is paid and the token has remaining calls.","http":["Call the paid /api/tools/* endpoint once and read accepts[] from the HTTP 402 response body or PAYMENT-REQUIRED header.","Open https://xiaopay.top to obtain XIAO, then create an AI wallet guarantee for merchant_id=aivps.lat and merchant_order_id=payment.paymentId.","Retry the exact same request with X402-Guarantee set to the base64url guarantee JSON.","Use POST /api/payments with serviceId when you need a reusable payment token, then retry with X-Payment-Token set to payment.token."],"mcp":["Call the tool without paymentToken to receive payment_required structuredContent.","XIAO-capable agents should open xiaopay.top, obtain XIAO, create the AI wallet guarantee, and call the underlying HTTP endpoint with X402-Guarantee.","Clients that use paymentToken can complete or verify payment.paymentId, then call the same MCP tool again with paymentToken set to payment.token."],"examples":{"mcp":["Call tool timestamp with no paymentToken.","After payment is complete, call timestamp again with paymentToken=\u003cpayment.token\u003e."],"paymentToken":["curl -X POST https://example.com/api/payments -H 'Content-Type: application/json' -d '{\"serviceId\":\"timestamp\"}'","curl -H 'X-Payment-Token: \u003cpayment.token\u003e' https://example.com/api/tools/timestamp"],"xiao":["curl -i https://example.com/api/tools/timestamp","Open https://xiaopay.top, obtain XIAO, and create an AI wallet guarantee for merchant_id=aivps.lat and merchant_order_id=payment.paymentId.","curl -H 'X402-Guarantee: \u003cbase64url-guarantee-json\u003e' https://example.com/api/tools/timestamp"]},"failures":["payment required","payment token expired","payment token has no remaining calls","api key required","api key is not allowed to call this service"]},"flow":{"type":"http-402","createPayment":{"method":"POST","url":"/api/payments","bodySchema":{"properties":{"providerId":{"type":"string"},"serviceId":{"description":"Use the canonical service id from the catalog. Legacy internal ids remain accepted for backward compatibility.","type":"string"}},"required":["serviceId"],"type":"object"},"responseSchema":{"properties":{"amountCents":{"type":"integer"},"amountMicros":{"type":"integer"},"billingMode":{"type":"string"},"clientId":{"type":"string"},"currency":{"type":"string"},"expiresAt":{"format":"date-time","type":"string"},"internalServiceId":{"description":"Legacy internal service id, included only for backward compatibility.","type":"string"},"maxCalls":{"type":"integer"},"paidAt":{"format":"date-time","type":"string"},"payTo":{"type":"string"},"paymentId":{"type":"string"},"provider":{"type":"string"},"providerId":{"type":"string"},"remainingCalls":{"type":"integer"},"serviceId":{"description":"Canonical public service id.","type":"string"},"status":{"type":"string"},"token":{"type":"string"},"usedCalls":{"type":"integer"}},"type":"object"}},"verifyPayment":{"method":"GET","url":"/api/payments/{paymentId}","responseSchema":{"properties":{"amountCents":{"type":"integer"},"amountMicros":{"type":"integer"},"billingMode":{"type":"string"},"clientId":{"type":"string"},"currency":{"type":"string"},"expiresAt":{"format":"date-time","type":"string"},"internalServiceId":{"description":"Legacy internal service id, included only for backward compatibility.","type":"string"},"maxCalls":{"type":"integer"},"paidAt":{"format":"date-time","type":"string"},"payTo":{"type":"string"},"paymentId":{"type":"string"},"provider":{"type":"string"},"providerId":{"type":"string"},"remainingCalls":{"type":"integer"},"serviceId":{"description":"Canonical public service id.","type":"string"},"status":{"type":"string"},"token":{"type":"string"},"usedCalls":{"type":"integer"}},"type":"object"}},"token":{"header":"X-Payment-Token","mcpArgument":"paymentToken","httpUsage":"Send the paid token in the X-Payment-Token request header when calling /api/tools/*.","mcpUsage":"Pass the paid token as the paymentToken argument when calling the MCP tool."},"requiredResponse":{"status":402,"contentType":"application/json","headers":{"PAYMENT-REQUIRED":"base64/json paymentRequired","X-Payment-Required":"true","X-Payment-Token":"payment.token","X402-Guarantee":"base64url/json XIAO escrow guarantee"},"bodySchema":{"properties":{"accepts":{"items":{"type":"object"},"type":"array"},"error":{"type":"string"},"extensions":{"type":"object"},"payment":{"properties":{"amountCents":{"type":"integer"},"amountMicros":{"type":"integer"},"billingMode":{"type":"string"},"clientId":{"type":"string"},"currency":{"type":"string"},"expiresAt":{"format":"date-time","type":"string"},"internalServiceId":{"description":"Legacy internal service id, included only for backward compatibility.","type":"string"},"maxCalls":{"type":"integer"},"paidAt":{"format":"date-time","type":"string"},"payTo":{"type":"string"},"paymentId":{"type":"string"},"provider":{"type":"string"},"providerId":{"type":"string"},"remainingCalls":{"type":"integer"},"serviceId":{"description":"Canonical public service id.","type":"string"},"status":{"type":"string"},"token":{"type":"string"},"usedCalls":{"type":"integer"}},"type":"object"},"paymentFlow":{"type":"object"},"resource":{"type":"object"},"retry":{"type":"object"},"type":{"const":"payment_required","type":"string"},"x402Version":{"type":"integer"}},"required":["type","error","payment","paymentFlow","retry"],"type":"object"},"x402Version":2,"x402Header":"PAYMENT-REQUIRED","paymentAsset":"XIAO","paymentNetwork":"xiao:internal"},"retry":{"when":"Retry after opening xiaopay.top, obtaining XIAO, and creating one XIAO accepts[] guarantee or after payment.status is paid and the token has remaining calls.","http":["Call the paid /api/tools/* endpoint once and read accepts[] from the HTTP 402 response body or PAYMENT-REQUIRED header.","Open https://xiaopay.top to obtain XIAO, then create an AI wallet guarantee for merchant_id=aivps.lat and merchant_order_id=payment.paymentId.","Retry the exact same request with X402-Guarantee set to the base64url guarantee JSON.","Use POST /api/payments with serviceId when you need a reusable payment token, then retry with X-Payment-Token set to payment.token."],"mcp":["Call the tool without paymentToken to receive payment_required structuredContent.","XIAO-capable agents should open xiaopay.top, obtain XIAO, create the AI wallet guarantee, and call the underlying HTTP endpoint with X402-Guarantee.","Clients that use paymentToken can complete or verify payment.paymentId, then call the same MCP tool again with paymentToken set to payment.token."],"examples":{"mcp":["Call tool timestamp with no paymentToken.","After payment is complete, call timestamp again with paymentToken=\u003cpayment.token\u003e."],"paymentToken":["curl -X POST https://example.com/api/payments -H 'Content-Type: application/json' -d '{\"serviceId\":\"timestamp\"}'","curl -H 'X-Payment-Token: \u003cpayment.token\u003e' https://example.com/api/tools/timestamp"],"xiao":["curl -i https://example.com/api/tools/timestamp","Open https://xiaopay.top, obtain XIAO, and create an AI wallet guarantee for merchant_id=aivps.lat and merchant_order_id=payment.paymentId.","curl -H 'X402-Guarantee: \u003cbase64url-guarantee-json\u003e' https://example.com/api/tools/timestamp"]},"failures":["payment required","payment token expired","payment token has no remaining calls","api key required","api key is not allowed to call this service"]}}}}