{"api":"SereinApi","description":"A lyrics and synced-lyrics API for Serein with metadata, suggestions, cache, and trending support","endpoints":{"cache_stats":{"description":"Get public cache statistics without file listing","method":"GET","url":"/cache/stats"},"jiosaavn_play":{"description":"Testing helper from the original project; Serein app should keep using its own playback backend","examples":["/api/jiosaavn/play?songLink=<song_link>"],"method":"GET","url":"/api/jiosaavn/play"},"jiosaavn_search":{"description":"Testing helper from the original project; not used as Serein primary search","examples":["/api/jiosaavn/search?q=Imagine"],"method":"GET","url":"/api/jiosaavn/search"},"lyrics":{"description":"Fetch lyrics for a song","examples":["/lyrics/?artist=The Beatles&song=Imagine","/lyrics/?artist=The Beatles&song=Imagine&timestamps=true","/lyrics/?artist=The Beatles&song=Imagine&metadata=true","/lyrics/?artist=The Beatles&song=Imagine&fast=true&timestamps=true&metadata=true"],"method":"GET","url":"/lyrics/"},"metadata_only":{"description":"Get song metadata without lyrics","examples":["/metadata/?artist=The Beatles&song=Imagine"],"method":"GET","url":"/metadata/"},"music_app":{"description":"Access the web-based music application","method":"GET","url":"/app"},"suggestion":{"description":"Search for songs by name and return matching titles with their artist","examples":["/suggestion?q=Imagine","/suggestion?q=Imagine&limit=5"],"method":"GET","url":"/suggestion"},"top_queries":{"description":"Get top user queries globally or by country","examples":["/analytics/top-queries/?limit=20","/analytics/top-queries/?country=US&limit=10","/analytics/top-queries/?country=US&days=7&limit=15"],"method":"GET","url":"/analytics/top-queries/"},"trending":{"description":"Get trending songs by country","examples":["/trending/?country=US&limit=20","/trending/?country=IN","/trending/?countries=US,GB,IN&limit=10"],"method":"GET","url":"/trending/"},"trending_by_country":{"description":"Get top queries for each country","examples":["/analytics/trending-by-country/?limit=10"],"method":"GET","url":"/analytics/trending-by-country/"},"trending_intersection":{"description":"Find queries that match trending songs","examples":["/analytics/trending-intersection/?country=US&limit=10"],"method":"GET","url":"/analytics/trending-intersection/"},"trending_vs_queries":{"description":"Compare trending songs with top user queries","examples":["/analytics/trending-vs-queries/?country=US&limit=10"],"method":"GET","url":"/analytics/trending-vs-queries/"}},"fetchers":{"1":"Genius (requires GENIUS_TOKEN)","2":"LRCLIB","3":"YouTube Music (ytmusicapi / transcript-api / yt-dlp)","4":"NetEase (via syncedlyrics, synced LRC)","5":"Megalobiz (via syncedlyrics, synced LRC)","6":"Musixmatch (via syncedlyrics, optional MUSIXMATCH_TOKEN)","7":"SimpMusic"},"parameters":{"artist":{"description":"Artist name","required":true,"type":"string"},"countries":{"description":"Comma-separated country codes","required":false,"type":"string"},"country":{"description":"Country code (US, GB, IN, BR, JP, DE, FR, CA, AU, MX)","required":false,"type":"string"},"days":{"description":"Time window in days for query analytics","required":false,"type":"integer"},"fast":{"default":false,"description":"Use parallel fetching for faster results","required":false,"type":"boolean"},"limit":{"default":20,"description":"Number of results to return","required":false,"type":"integer"},"metadata":{"default":false,"description":"Include song metadata (cover art, duration, genre, etc.)","required":false,"type":"boolean"},"song":{"description":"Song title","required":true,"type":"string"},"timestamps":{"default":false,"description":"Include synchronized timestamps with lyrics","required":false,"type":"boolean"}},"status":"active","timestamp":"2026-07-05T09:31:48.937261+00:00","version":"1.0.0-serein"}