Verome API

Music API for YouTube Music, Lyrics & Streaming

Live

---

Features

• Search songs, albums, artists with fallback video IDs
• Synced lyrics (LRC format) via LRCLib
• Audio streaming via Piped/Invidious proxies
• Radio mixes from any song
• Trending music & top artists by country
• Artist/track info from Last.fm
• Built-in web player with YouTube IFrame API
• Auto region detection from IP

Quick Start

deno task start

Server runs at http://localhost:8000

Development

deno task dev

Project Structure

main.ts                    Entry point (Deno.serve)
ui.ts                      Web UI HTML
assets/                    Static assets (logo)
src/
├── helpers/
│   ├── response.ts        JSON/error helpers, CORS
│   ├── region.ts          IP-based region detection
│   └── router.ts          Route pattern matching
├── services/
│   ├── ytmusic.ts         YouTube Music API client
│   ├── ytmusic-parser.ts  YT Music response parsers
│   ├── youtube-search.ts  YouTube Search (web scraping)
│   ├── lastfm.ts          Last.fm API
│   ├── streaming.ts       Piped/Invidious stream fetching
│   ├── lyrics.ts          LRCLib lyrics
│   ├── entities.ts        Combined entity fetchers
│   └── discovery.ts       Trending, radio, top charts
└── routes/
    ├── search.ts          /api/search, /api/yt_search
    ├── content.ts         /api/songs, /api/albums, /api/artists
    ├── discover.ts        /api/charts, /api/trending, /api/radio
    ├── stream.ts          /api/stream, /api/proxy
    ├── info.ts            /api/lyrics, /api/artist/info
    └── feed.ts            /api/feed/*

API Endpoints

Search

Endpoint	Description
/api/search?q=&filter=	Search YouTube Music
/api/yt_search?q=&filter=	Search YouTube
/api/search/suggestions?q=	Autocomplete

Content

Endpoint	Description
/api/songs/:videoId	Song + artist/album links
/api/albums/:browseId	Album + tracks
/api/artists/:browseId	Artist + discography
/api/playlists/:playlistId	Playlist tracks
/api/chain/:videoId	Song → Artist → Albums

Discovery

Endpoint	Description
/api/related/:videoId	Related songs
/api/radio?videoId=	Radio mix
/api/similar?title=&artist=	Similar tracks
/api/charts?country=	Charts
/api/trending?country=	Trending
/api/moods	Mood categories
/api/top/artists?country=	Top artists
/api/top/tracks?country=	Top tracks

Streaming & Lyrics

Endpoint	Description
/api/stream?id=	Audio stream URLs
/api/proxy?url=	Audio proxy (CORS)
/api/lyrics?title=&artist=	Synced lyrics

Info

Endpoint	Description
/api/artist/info?artist=	Artist bio
/api/track/info?title=&artist=	Track info

Deploy

Uses the new Deno Deploy platform (not Deploy Classic).

deno task deploy

This project uses Deno.serve() as required by the new Deno Deploy. Deploy Classic (dash.deno.com) shuts down July 20, 2026.

License

MIT