Analysis
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
Search tracks by lyrics analysis criteria — moods, themes, meaning, entities, moderation, rating, and more. This endpoint enables analysis-driven discovery: find songs about specific topics, with certain moods, mentioning particular entities, or matching content safety criteria. Search parameters are passed in the request body under aDocumentation Index
Fetch the complete documentation index at: https://docs.musixmatch.com/llms.txt
Use this file to discover all available pages before exploring further.
data key, while pagination is controlled via query parameters.
For detailed information about the analysis metadata returned in the response, please refer to the Analysis documentation.
Input Constraints
- Maximum string length: 500 characters (
meaning,themes[],genre[],entities[].name) - Maximum array size: 20 items (
themes,entities,genre,moods,religions,moderation_categories)
Entities
Theentities parameter accepts an array of objects. Each object must have at least one of name or category.
- Fields within an object are AND-ed (e.g. name=Paris AND category=Geographical Locations)
- Multiple objects are OR-ed (e.g. Paris OR London)
Available Moods
Love, Heartbreak, Joy, Empowerment, Angst, Reflection, Inspiration, Nostalgia, Despair, Celebration, Anger, Peace, Solitude, Adventure, Social Commentary, Hope, Spirituality, Freedom, Party, NatureRating Values
| Value | Description |
|---|---|
| G | General audiences |
| PG | Parental guidance suggested |
| PG-13 | Parents strongly cautioned (includes G and PG) |
| R | Restricted (includes G, PG, and PG-13) |
| NC-17 | Adults only (includes all) |
PG-13 returns tracks rated G, PG, and PG-13.
Entity Categories
People & Groups, Geographical Locations, Events & Periods, Cultural Works, Organizations & Institutions, Products & Brands, Concepts & Ideas, DiseasesNotes
- The
availablecount in the response header reflects total search engine hits. Actual items intrack_listmay be fewer, as tracks without analysis data or with metadata restrictions are skipped. - The
analysisobject in the response matches the structure of track.lyrics.analysis.get.
Authorizations
Query Parameters
Page number (max 100).
Required range:
1 <= x <= 100Example:
1
Results per page (max 100).
Required range:
1 <= x <= 100Example:
10
Body
application/json
Search parameters. At least one must be provided.
Response
200 - application/json
200 OK / 400 Bad Request / 401 Unauthorized / 403 Forbidden