MeowTunes/Vasl.social Public Music API
Read-only live access to the public music search, public playlist, track metadata, and ordinary-browser playback surfaces exposed by Vasl.social. Playback returns the same public CDN media URL resolved by the website; private or unauthorized resources are reported as upstream authorization errors and are never bypassed.
Endpoint health
Loading verification…
Connect your agent
Connect through MCP so your agent can find this API, read its docs, and call its endpoints.
Add the server from your terminal.
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcpIn Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.
Then ask your agent to use the MeowTunes/Vasl.social Public Music API for your task.
Call it over HTTP
Get an API keySign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/b0a080c6-5924-4643-b7d0-b097be16f977/search' \
--header "Authorization: Bearer $AGENT_DATA_API_KEY" \
--data-urlencode 'q=F Song'Endpoints
Inputs and response fields for every endpoint in this API.
GETSearch/search
Search public music by title and optional artist
Input
qRequiredQuery · stringTitle or music search text.
Example: F Song
artistOptionalQuery · string | nullOptional exact, case-insensitive artist constraint applied to source audioMetadata.artist.
Example: Strawberry Guy
limitOptionalQuery · integer, min: 1, max: 100, default: 20Maximum number of source results to request.
Example: 20
Response
itemsobject[]items[].id?string | nullitems[].name?string | nullitems[].size?integer | nullitems[].filename?string | nullitems[].mimeType?string | nullitems[].uploader?object | nullitems[].mediaClass?string | nullitems[].contentHash?string | nullitems[].originalName?string | nullitems[].audioMetadata?object | nullrequest_idstringnext_cursor?string | nullsource_endpointstringFields marked ? are optional.
GETPlaylists search/playlists/search
Search public playlists
Input
qRequiredQuery · stringPlaylist name or description search text.
Example: song
limitOptionalQuery · integer, min: 1, max: 100, default: 20Maximum number of public playlists to request.
Example: 20
Response
itemsobject[]items[].id?string | nullitems[].name?string | nullitems[].owner?object | nullitems[].isPublic?boolean | nullitems[].songCount?integer | nullitems[].description?string | nullrequest_idstringnext_cursor?string | nullsource_endpointstringFields marked ? are optional.
GETTracks by id/tracks/{trackId}
Retrieve track metadata and file information
Input
trackIdRequiredPath · stringVasl audio file ID returned by music search or a public playlist.
Example: 69f5c5b68e7d8bc52f8163b1
Response
trackobjecttrack.id?string | nulltrack.name?string | nulltrack.size?integer | nulltrack.filename?string | nulltrack.mimeType?string | nulltrack.uploader?object | nulltrack.mediaClass?string | nulltrack.contentHash?string | nulltrack.originalName?string | nulltrack.audioMetadata?object | nullrequest_idstringsource_endpointstringFields marked ? are optional.
GETTracks by id play/tracks/{trackId}/play
Resolve the official public browser playback URL for an audio track
Input
trackIdRequiredPath · stringVasl audio file ID returned by music search or a public playlist.
Example: 69f5c5b68e7d8bc52f8163b1
Response
playablebooleantrack_idstringrequest_idstringtotal_size?integer | nullhttp_status?integer | nullcontent_type?string | nullplayback_url?string | nullredirect_url?string | nullauthorizationstringcontent_range?string | nullcontent_length?integer | nullsource_endpointstringFields marked ? are optional.
GETPlaylists by owner playlist/playlists/{ownerUserId}/{playlistId}
Retrieve a public playlist and its track records
Input
ownerUserIdRequiredPath · stringPublic playlist owner's Vasl user ID.
Example: 9172370
playlistIdRequiredPath · stringPublic playlist ID returned by playlist search.
Example: 69f4eeebbcd274f5cccd93e6
Response
playlistobjectplaylist.id?string | nullplaylist.name?string | nullplaylist.songs?object[]playlist.songs[].id?string | nullplaylist.songs[].name?string | nullplaylist.songs[].size?integer | nullplaylist.songs[].filename?string | nullplaylist.songs[].mimeType?string | nullplaylist.songs[].uploader?object | nullplaylist.songs[].mediaClass?string | nullplaylist.songs[].contentHash?string | nullplaylist.songs[].originalName?string | nullplaylist.songs[].audioMetadata?object | nullplaylist.isPublic?boolean | nullplaylist.createdAt?string | nullplaylist.updatedAt?string | nullplaylist.description?string | nullplaylist.upvoteCount?integer | nullrequest_idstringsource_endpointstringFields marked ? are optional.
Don’t see the endpoint you need?
Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.
An account is required to submit an extension. Prepare your request, then sign in to build.