{"api":"Lyrica","description":"A comprehensive lyrics API with mood analysis, metadata extraction, and trending insights","endpoints":{"cache_stats":{"description":"Get cache statistics","method":"GET","url":"/cache/stats"},"jiosaavn_play":{"description":"Get playable stream URL from JioSaavn","examples":["/api/jiosaavn/play?songLink=<song_link>"],"method":"GET","url":"/api/jiosaavn/play"},"jiosaavn_search":{"description":"Search for songs on JioSaavn","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&mood=true","/lyrics/?artist=The Beatles&song=Imagine&metadata=true","/lyrics/?artist=The Beatles&song=Imagine&fast=true&timestamps=true&mood=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"},"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","2":"LRCLIB","3":"SimpMusic","4":"YouTube Music","5":"Lyrics.ovh","6":"ChartLyrics"},"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"},"mood":{"default":false,"description":"Analyze song mood/sentiment and top words","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-04-14T14:11:56.201313+00:00","version":"1.0-refactor"}