Catalog / MeowTunes/Vasl.social Public Music

MeowTunes/Vasl.social Public Music API

vasl.social

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.

  • Social & video
  • music
  • playlists
  • audio
  • vasl
  • public-data
5 endpointsDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In 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 key

Sign 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.

Search public music by title and optional artist

Title or music search text.

Optional parameters 2

Optional exact, case-insensitive artist constraint applied to source audioMetadata.artist.

Maximum number of source results to request.

View call pricing
cURL · Search
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.

GETTracks by id/tracks/{trackId}

Retrieve track metadata and file information

Input

trackIdRequiredPath · string

Vasl audio file ID returned by music search or a public playlist.

Example: 69f5c5b68e7d8bc52f8163b1

Response

trackobject
track.id?string | null
track.name?string | null
track.size?integer | null
track.filename?string | null
track.mimeType?string | null
track.uploader?object | null
track.mediaClass?string | null
track.contentHash?string | null
track.originalName?string | null
track.audioMetadata?object | null
request_idstring
source_endpointstring

Fields marked ? are optional.

GETTracks by id play/tracks/{trackId}/play

Resolve the official public browser playback URL for an audio track

Input

trackIdRequiredPath · string

Vasl audio file ID returned by music search or a public playlist.

Example: 69f5c5b68e7d8bc52f8163b1

Response

playableboolean
track_idstring
request_idstring
total_size?integer | null
http_status?integer | null
content_type?string | null
playback_url?string | null
redirect_url?string | null
authorizationstring
content_range?string | null
content_length?integer | null
source_endpointstring

Fields marked ? are optional.

GETPlaylists by owner playlist/playlists/{ownerUserId}/{playlistId}

Retrieve a public playlist and its track records

Input

ownerUserIdRequiredPath · string

Public playlist owner's Vasl user ID.

Example: 9172370

playlistIdRequiredPath · string

Public playlist ID returned by playlist search.

Example: 69f4eeebbcd274f5cccd93e6

Response

playlistobject
playlist.id?string | null
playlist.name?string | null
playlist.songs?object[]
playlist.songs[].id?string | null
playlist.songs[].name?string | null
playlist.songs[].size?integer | null
playlist.songs[].filename?string | null
playlist.songs[].mimeType?string | null
playlist.songs[].uploader?object | null
playlist.songs[].mediaClass?string | null
playlist.songs[].contentHash?string | null
playlist.songs[].originalName?string | null
playlist.songs[].audioMetadata?object | null
playlist.isPublic?boolean | null
playlist.createdAt?string | null
playlist.updatedAt?string | null
playlist.description?string | null
playlist.upvoteCount?integer | null
request_idstring
source_endpointstring

Fields 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.