v1
latestOpenAPI 3.0.32026-07-263517334.7 KBTrack
track.lyrics.analysis.search
Search tracks by lyrics analysis criteria — moods, themes, meaning, entities, moderation, rating, and more. Discover music based on what songs are about rather than just metadata like title or artist.
post/ws/1.1/track.lyrics.analysis.search
Query parameters
pageinteger
Example:1
Page number (max 100).
page_sizeinteger
Example:10
Results per page (max 100).
Request body
Example request
{
"data": {
"meaning": "self empowerment and overcoming obstacles",
"themes": [
"existential crisis",
"rebellion"
],
"moods": [
"Angst",
"Despair"
],
"rating": "PG-13",
"entities": [
{
"name": "Paris",
"category": "Geographical Locations"
}
],
"genre": "Pop",
"lyrics_language": "en",
"first_release_date": "20200101",
"moderation_categories": [
"violence",
"sexual"
]
}
}Response
200 OK / 400 Bad Request / 401 Unauthorized / 403 Forbidden
Example response
{
"message": {
"header": {
"status_code": 200,
"execute_time": 0.12,
"available": 1500
},
"body": {
"track_list": [
{
"track": {
"track_id": 12345678,
"track_name": "Bohemian Rhapsody",
"artist_name": "Queen",
"album_name": "A Night at the Opera",
"commontrack_id": 7654321,
"first_release_date": "1975-10-31T00:00:00Z",
"track_share_url": "https://www.musixmatch.com/lyrics/Queen/Bohemian-Rhapsody"
},
"analysis": {
"meaning": {
"explanation": "A song about a young man confessing to murder and facing the consequences of his actions.",
"description": "Generates a simple, short explanation of the lyrics' content."
},
"themes": {
"main_themes": [
{
"theme": "guilt and redemption",
"quotes": [
"Mama, just killed a man",
"Is this the real life? Is this just fantasy?"
]
}
],
"description": "Extracts a list of the main themes covered by the song's lyrics."
},
"moods": {
"main_moods": [
"Angst",
"Despair"
],
"description": "Extracts a list of moods from the lyrics."
},
"rating": {
"audience": "PG-13",
"descriptor": "Thematic elements of violence and death",
"description": "Assigns a parental guide rating to the lyrics."
},
"religion": {
"referenced_religions": [],
"description": "Identifies references to religions within the lyrics."
},
"entities": {
"entity_list": [
{
"entity_name": "Galileo",
"categories": [
"People & Groups"
],
"occurrences": 4
}
],
"description": "Identifies and categorizes specific elements like names, locations, dates."
},
"moderation": {
"categories": [
{
"category": "violence",
"score": 0.15
}
],
"description": "Identifies content categories that may require moderation."
},
"explicitness": {
"description": "Examines a text to find offensive or inappropriate words."
}
}
}
]
}
}
}