A music API built with Deno for searching, streaming, and exploring music data from YouTube Music, YouTube, and Last.fm.
--- ## Overview Virome API provides a unified interface to access music data from multiple sources. It includes a built-in web UI for testing endpoints and playing music directly in the browser. ## Features - Search songs, albums, artists, and playlists - Get song lyrics with synced timestamps - Stream audio from YouTube via Piped/Invidious proxies - Generate radio mixes based on a song - Get trending music and top artists by country - Artist and track information from Last.fm - Built-in music player with YouTube IFrame API ## Installation ### Requirements - Deno 1.40 or higher ### Run Locally ```bash cd deno-music-api deno run --allow-net --allow-env --allow-read mod.ts ``` The server starts at `http://localhost:8000` ### Deploy to Deno Deploy 1. Push the code to a GitHub repository 2. Go to https://dash.deno.com 3. Create a new project and link your repository 4. Set the entry point to `mod.ts` ## API Endpoints ### Search | Endpoint | Description | Parameters | |----------|-------------|------------| | GET /api/search | Search YouTube Music | q, filter (songs/albums/artists) | | GET /api/yt_search | Search YouTube | q, filter (videos/channels/playlists) | | GET /api/search/suggestions | Get search suggestions | q | ### Content | Endpoint | Description | Parameters | |----------|-------------|------------| | GET /api/songs/:videoId | Get song details | videoId | | GET /api/albums/:browseId | Get album tracks | browseId | | GET /api/artists/:browseId | Get artist info | browseId | | GET /api/playlists/:playlistId | Get playlist tracks | playlistId | ### Discovery | Endpoint | Description | Parameters | |----------|-------------|------------| | GET /api/related/:videoId | Get related songs | videoId | | GET /api/similar | Find similar tracks | title, artist | | GET /api/trending | Trending music by country | country | | GET /api/radio | Generate radio mix | videoId | | GET /api/top/artists | Top artists by country | country, limit | | GET /api/top/tracks | Top tracks by country | country, limit | ### Info | Endpoint | Description | Parameters | |----------|-------------|------------| | GET /api/lyrics | Get song lyrics | title, artist | | GET /api/artist/info | Artist bio and stats | artist | | GET /api/track/info | Track details | title, artist | ### Streaming | Endpoint | Description | Parameters | |----------|-------------|------------| | GET /api/stream | Get stream URLs | id | | GET /api/watch_playlist | Get watch playlist | videoId or playlistId | | GET /health | Health check | - | ## Usage Examples ### Search for songs ``` GET /api/search?q=Blinding%20Lights&filter=songs ``` ### Get lyrics ``` GET /api/lyrics?title=Blinding%20Lights&artist=The%20Weeknd ``` ### Get stream URLs ``` GET /api/stream?id=4NRXx6U8ABQ ``` ### Get top artists from a country ``` GET /api/top/artists?country=Tunisia&limit=20 ``` ### Generate radio from a song ``` GET /api/radio?videoId=4NRXx6U8ABQ ``` ## Project Structure ``` deno-music-api/ mod.ts - Main server and route handlers lib.ts - API clients (YouTube Music, YouTube, Last.fm) ui.ts - Web UI HTML template deno.json - Deno configuration assets/ Logo.png - Project logo ``` ## Data Sources - YouTube Music API (unofficial) - YouTube Data (via Invidious/Piped) - Last.fm API (artist info, similar tracks) - LRCLib (lyrics) ## License MIT ## Disclaimer This is an unofficial API for educational purposes. It is not affiliated with YouTube, Google, or Last.fm.