The Lyric Lens analysis by Musixmatch provides detailed insights into song themes, moods, meanings, content ratings, and moderation flags, facilitating scalable song classification and interpretation. With licensed rights from music publishers, Musixmatch uses advanced analysis to create enriched metadata, enhancing the understanding of song lyrics and enabling robust classifications for contextual and thematic insights.

Accessible exclusively through the Lyrics Lens API, this metadata serves as a powerful tool for applications in content discovery, recommendation, and audience engagement. With a straightforward API call, users can retrieve detailed lyrical metadata for any song by its Musixmatch Track ID or ISRC code, unlocking a world of contextual and thematic information to enhance the listening experience and support diverse use cases.

Find below the list of the Lyric Lens metadata you will receive for each song.

​
Lyric Lens metadata overview

​
Meaning

Generates a simple, short explanation of the lyrics’ content.

Sample output:

  • Title: Flowers
  • Artist: Miley Cyrus
  • Explanation:
    The song ‘Flowers’ by Miley Cyrus talks about self-love and empowerment after a breakup. The lyrics convey the message of finding inner strength and happiness within oneself, symbolized by buying flowers, painting nails, and enjoying personal activities, emphasizing the ability to love oneself better than relying on someone else.

​
Moderation

Identifies a set of content categories that may require moderation.

Sample output:

  • Title: Look At Me!
  • Artist: XXXTENTACION
  • Categories:
[{
  "category": "harassment",
  "is_present": true,
  "score": 0.8076742617342823
}, 
{
  "category": "hate",
  "is_present": true,
  "score": 0.6933337275467522
},
{
  "category": "illicit",
  "is_present": false,
  "score": 0.016620672563316466
},
{
  "category": "sexual",
  "is_present": true,
  "score": 0.9281824295472227
},
{
  "category": "violence",
  "is_present": true,
  "score": 0.6850510703048678
},
{
  "category": "harassment/threatening",
  "is_present": false,
  "score": 0.11442913287272342
},
{
   "category": "hate/threatening",
   "is_present": false,
   "score": 0.023609190664637875
},
{
  "category": "illicit/violent",
  "is_present": false,
  "score": 0.0020301693889894067
},
{
  "category": "self-harm/intent",
  "is_present": false,
  “score": 0.0045969851961812705
},
{
  "category": "self-harm/instructions",
  "is_present": false,
  "score": 0.0003475999993060529
},
{
   "category": "self-harm",
   "is_present": false,
   "score": 0.040972273201981844
},
{
   "category": "sexual/minors",
   "is_present": false,
   "score": 0.0005220125693558398
},
{
    "category": "violence/graphic",
    "is_present": false,
    "score": 0.005553221405372517
}]

​
Moods

Extracts a list of an arbitrary number of moods from the lyric corpus to establish a form of lyrics classification through sentiment analysis.

Sample output:

  • Title: Wish You Were Here
  • Artist: Pink Floyd
  • Main moods: Reflection, Heartbreak, Angst, Nostalgia, Love

​
PG Rating

Assigns to the provided song’s lyrics a parental guide rating, much like the ones from the Motion Picture Association film rating system.

Sample output: G, PG, PG-13, R, NC-17

  • Title: Lose Yourself
  • Artist: Eminem
  • Audience: R
  • Description: The lyrics contain strong language and themes of struggle, including references to drug use, violence, and adult situations, which are not suitable for children under 17 without parental guidance.

​
Religions

Identifies references to religions, religious themes or religious groups within a song’s lyrics.

Sample output:

  • Title: Il cantico delle creature
  • Artist: Angelo Branduardi
  • Has references: true
  • Referenced religions: “christianity”

​
Themes

Extracts a list of the main themes covered by the song’s lyrics, referring to the portion of the songs that better convey such messages.

Sample output:

  • Title: Beautiful Things
  • Artist: Benson Boone
  • Main themes:
    • “Gratitude and appreciation”:
      • “I found a girl my parents love”,
      • “I thank God every day”
    • “Fear of loss”:
      • “But there’s no man as terrified”,
      • “Oh, I hope I don’t lose you”,
      • “I just might lose it all”
    • “Personal growth and stability”:
      • “I found my mind, I’m feelin’ sane”,
      • “It’s been a while, but I’m finding my faith”

​
Language Detection

Identifies the language of a given text.

Sample output:

  • Title: Mas Que Nada
  • Artist: Sérgio Mendes
  • Languages:
[{ 
  "is_romanized": false
  "language_iso_code_1": "pt"
  "language_iso_code_3": "por"
  "language_name": "portuguese"
  "percentage": 100.0
}]

​
Entities

Identifies and categorizes specific elements like names, locations, dates, organizations, and more.

Sample output:

“entity_list”: [
    {
        “entity_name”: “Atlanta”,
        “wikidata”: {
            “id”: “Q23556",
            “types”: [
                “county seat”,
                “big city”,
                “city in the United States”,
                “municipality of Georgia”
            ],
            “description”: “capital city of Georgia, United States”,
            “thumbnail”: “https://upload.wikimedia.org/wikipedia/commons/thumb/5/5f/Atlanta_Montage_2.jpg/50px-Atlanta_Montage_2.jpg”,
            “rank”: 537524
        },
        “categories”: [
            “Things”,
            “Geographical Locations”,
            “Urban & Political Locations”,
            “Cities & Towns”
        ],
        “model_metadata”: {
            “type”: “county seat, big city, city in the United States, municipality of Georgia”,
            “description”: “capital city of Georgia, United States”
        },
        “matches”: [
            {
                “matched_text”: “Atlanta”,
                “start_char”: 3242,
                “end_char”: 3249
            },
            {
                “matched_text”: “Atlanta”,
                “start_char”: 3455,
                “end_char”: 3462
            },
            {
                “matched_text”: “Atlanta”,
                “start_char”: 3842,
                “end_char”: 3849
            }
        ],
        “occurrencies”: 3,
        “wikipedia”: [
            {
                “language”: “en”,
                “url”: “https://en.wikipedia.org/wiki/Atlanta”
            }
        ]
    },
    {
        “entity_name”: “Drake”,
        “wikidata”: {
            “id”: “Q33240",
            “types”: [
                “human”
            ],
            “description”: “Canadian rapper, singer and actor (born 1986)“,
            “thumbnail”: “https://upload.wikimedia.org/wikipedia/commons/thumb/2/28/Drake_July_2016.jpg/50px-Drake_July_2016.jpg”,
            “rank”: 536536
        },
        “categories”: [
            “Things”,
            “People & Groups”,
            “Artists”
        ],
        “model_metadata”: {
            “type”: “human”,
            “description”: “Canadian rapper, singer and actor (born 1986)”
        },
        “matches”: [
            {
                “matched_text”: “Drake”,
                “start_char”: 709,
                “end_char”: 714
            },
            {
                “matched_text”: “Drake”,
                “start_char”: 1640,
                “end_char”: 1645
            }
        ],
        “occurrencies”: 2,
        “wikipedia”: [
            {
                “language”: “en”,
                “url”: “https://en.wikipedia.org/wiki/Drake_(musician)”
            }
        ]
    },
    {
        “entity_name”: “Compton”,
        “wikidata”: {
            “id”: “Q487119",
            “types”: [
                “city in the United States”,
                “charter city”
            ],
            “description”: “city in Los Angeles County, California, United States”,
            “thumbnail”: “https://upload.wikimedia.org/wikipedia/commons/thumb/5/5b/Compton_martin_luther_king_monument.jpg/50px-Compton_martin_luther_king_monument.jpg”,
            “rank”: 372427
        },
        “categories”: [
            “Things”,
            “Geographical Locations”,
            “Urban & Political Locations”,
            “Cities & Towns”
        ],
        “model_metadata”: {
            “type”: “city in the United States, charter city”,
            “description”: “city in Los Angeles County, California, United States”
        },
        “matches”: [
            {
                “matched_text”: “Compton”,
                “start_char”: 274,
                “end_char”: 281
            },
            {
                “matched_text”: “Compton”,
                “start_char”: 2053,
                “end_char”: 2060
            }
        ],
        “occurrencies”: 2,
        “wikipedia”: [
            {
                “language”: “en”,
                “url”: “https://en.wikipedia.org/wiki/Compton,_California”
            }
        ]
    },
    {
        “entity_name”: “Tupac Shakur”,
        “wikidata”: {
            “id”: “Q6107",
            “types”: [
                “human”
            ],
            “description”: “American rapper (1971–1996)“,
            “thumbnail”: “https://upload.wikimedia.org/wikipedia/commons/thumb/5/5c/Tupac_Shakur.jpg/50px-Tupac_Shakur.jpg”,
            “rank”: 556934
        },
        “categories”: [
            “Things”,
            “People & Groups”,
            “Artists”
        ],
        “model_metadata”: {
            “type”: “human”,
            “description”: “American rapper (1971–1996)”
        },
        “matches”: [
            {
                “matched_text”: “Pac”,
                “start_char”: 1409,
                “end_char”: 1412
            },
            {
                “matched_text”: “Pac”,
                “start_char”: 2672,
                “end_char”: 2675
            }
        ],
        “occurrencies”: 2,
        “wikipedia”: [
            {
                “language”: “en”,
                “url”: “https://en.wikipedia.org/wiki/Tupac_Shakur”
            }
        ]
    },
    {
        “entity_name”: “John Stockton”,
        “wikidata”: {
            “id”: “Q213346",
            “types”: [
                “human”
            ],
            “description”: “American basketball player”,
            “thumbnail”: “https://upload.wikimedia.org/wikipedia/commons/thumb/c/cf/John_Stockton_2022.jpg/50px-John_Stockton_2022.jpg”,
            “rank”: 349814
        },
        “categories”: [
            “Things”,
            “People & Groups”,
            “Sports Figures”,
            “Athletes”,
            “Basketball Players”
        ],
        “model_metadata”: {
            “type”: “human”,
            “description”: “American basketball player”
        },
        “matches”: [
            {
                “matched_text”: “John Stockton”,
                “start_char”: 429,
                “end_char”: 442
            }
        ],
        “occurrencies”: 1,
        “wikipedia”: [
            {
                “language”: “en”,
                “url”: “https://en.wikipedia.org/wiki/John_Stockton”
            }
        ]
    },
    {
        “entity_name”: “Bible”,
        “wikidata”: {
            “id”: “Q1845",
            “types”: [
                “religious text”,
                “sources of law”,
                “collection of literary works”
            ],
            “description”: “collection of sacred books in Judaism and Christianity”,
            “thumbnail”: “https://upload.wikimedia.org/wikipedia/commons/thumb/b/b6/Gutenberg_Bible,_Lenox_Copy,_New_York_Public_Library,_2009._Pic_01.jpg/50px-Gutenberg_Bible,_Lenox_Copy,_New_York_Public_Library,_2009._Pic_01.jpg”,
            “rank”: 405839
        },
        “categories”: [
            “Things”,
            “Cultural Works”,
            “Books & Literature”,
            “Religious Texts”
        ],
        “model_metadata”: {
            “type”: “religious text, sources of law, collection of literary works”,
            “description”: “collection of sacred books in Judaism and Christianity”
        },
        “matches”: [
            {
                “matched_text”: “Bible”,
                “start_char”: 470,
                “end_char”: 475
            }
        ],
        “occurrencies”: 1,
        “wikipedia”: [
            {
                “language”: “en”,
                “url”: “https://en.wikipedia.org/wiki/Bible”
            }
        ]
    },
    {
        “entity_name”: “Lil Wayne”,
        “wikidata”: {
            “id”: “Q15615”,
            “types”: [
                “human”
            ],
            “description”: “American rapper (born 1982)“,
            “thumbnail”: “https://upload.wikimedia.org/wikipedia/commons/thumb/1/12/Lil_Wayne_Feb._2020.jpg/50px-Lil_Wayne_Feb._2020.jpg”,
            “rank”: 539532
        },
        “categories”: [
            “Things”,
            “People & Groups”,
            “Artists”
        ],
        “model_metadata”: {
            “type”: “human”,
            “description”: “American rapper (born 1982)”
        },
        “matches”: [
            {
                “matched_text”: “Wayne”,
                “start_char”: 2226,
                “end_char”: 2231
            }
        ],
        “occurrencies”: 1,
        “wikipedia”: [
            {
                “language”: “en”,
                “url”: “https://en.wikipedia.org/wiki/Lil_Wayne”
            }
        ]
    },
    {
        “entity_name”: “Serena Williams”,
        “wikidata”: {
            “id”: “Q11459",
            “types”: [
                “human”
            ],
            “description”: “American tennis player”,
            “thumbnail”: “https://upload.wikimedia.org/wikipedia/commons/thumb/4/4b/Serena_Williams_at_2013_US_Open.jpg/50px-Serena_Williams_at_2013_US_Open.jpg”,
            “rank”: 511506
        },
        “categories”: [
            “Things”,
            “People & Groups”,
            “Sports Figures”,
            “Athletes”
        ],
        “model_metadata”: {
            “type”: “human”,
            “description”: “American tennis player”
        },
        “matches”: [
            {
                “matched_text”: “Serena”,
                “start_char”: 2442,
                “end_char”: 2448
            }
        ],
        “occurrencies”: 1,
        “wikipedia”: [
            {
                “language”: “en”,
                “url”: “https://en.wikipedia.org/wiki/Serena_Williams”
            }
        ]
    },
    {
        “entity_name”: “Lil Baby”,
        “wikidata”: {
            “id”: “Q50527563”,
            “types”: [
                “human”
            ],
            “description”: “American rapper (born 1994)“,
            “thumbnail”: “https://upload.wikimedia.org/wikipedia/commons/thumb/e/e7/Lil_Baby_in_2020.png/50px-Lil_Baby_in_2020.png”,
            “rank”: 281921
        },
        “categories”: [
            “Things”,
            “People & Groups”,
            “Artists”
        ],
        “model_metadata”: {
            “type”: “human”,
            “description”: “American rapper (born 1994)”
        },
        “matches”: [
            {
                “matched_text”: “Lil Baby”,
                “start_char”: 3613,
                “end_char”: 3621
            }
        ],
        “occurrencies”: 1,
        “wikipedia”: [
            {
                “language”: “en”,
                “url”: “https://en.wikipedia.org/wiki/Lil_Baby”
            }
        ]
    },
    {
        “entity_name”: “Quavo”,
        “wikidata”: {
            “id”: “Q30072039",
            “types”: [
                “human”
            ],
            “description”: “American rapper (born 1991)“,
            “thumbnail”: “https://upload.wikimedia.org/wikipedia/commons/thumb/8/86/Quavo_in_2019.jpg/50px-Quavo_in_2019.jpg”,
            “rank”: 213710
        },
        “categories”: [
            “Things”,
            “People & Groups”,
            “Artists”
        ],
        “model_metadata”: {
            “type”: “human”,
            “description”: “American rapper (born 1991)”
        },
        “matches”: [
            {
                “matched_text”: “Quavo”,
                “start_char”: 3750,
                “end_char”: 3755
            }
        ],
        “occurrencies”: 1,
        “wikipedia”: [
            {
                “language”: “en”,
                “url”: “https://en.wikipedia.org/wiki/Quavo”
            }
        ]
    },
    {
        “entity_name”: “2 Chainz”,
        “wikidata”: {
            “id”: “Q129668",
            “types”: [
                “human”
            ],
            “description”: “American rapper and songwriter (born 1977)“,
            “thumbnail”: “https://upload.wikimedia.org/wikipedia/commons/thumb/c/c3/2_Chainz_2013.JPG/50px-2_Chainz_2013.JPG”,
            “rank”: 251433
        },
        “categories”: [
            “Things”,
            “People & Groups”,
            “Artists”
        ],
        “model_metadata”: {
            “type”: “human”,
            “description”: “American rapper and songwriter (born 1977)”
        },
        “matches”: [
            {
                “matched_text”: “Chainz”,
                “start_char”: 3797,
                “end_char”: 3803
            }
        ],
        “occurrencies”: 1,
        “wikipedia”: [
            {
                “language”: “en”,
                “url”: “https://en.wikipedia.org/wiki/2_Chainz”
            }
        ]
    }
]
Catalog feedImplementation guidelines