---
title: "track.lyrics.analysis.search"
method: POST
path: "/ws/1.1/track.lyrics.analysis.search"
tags: ["Track"]
---

# track.lyrics.analysis.search

`POST /ws/1.1/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.

## Query parameters

- `page` integer
- `page_size` integer

## Request body

- object
  - `data` object — Search parameters. At least one must be provided.
    - `meaning` string — Free-text search on lyrics meaning.
    - `themes` string[] — Search by themes (max 20 items).
    - `moods` string[] — Filter by moods (max 20 items).
    - `rating` 'G' | 'PG' | 'PG-13' | 'R' | 'NC-17' — Parental rating filter. Hierarchical: PG-13 includes G and PG content.
    - `religions` string[] — Filter by religion references in lyrics (max 20 items).
    - `exclude_religions` boolean — Exclude tracks with any religious references.
    - `entities` object[] — Structured entity search (max 20 items). Each object must have at least one of name or category. Fields within an object are AND-ed; multiple objects are OR-ed.
      - `name` string — Entity name (fuzzy match).
      - `category` 'People & Groups' | 'Geographical Locations' | 'Events & Periods' | 'Cultural Works' | 'Organizations & Institutions' | 'Products & Brands' | 'Concepts & Ideas' | 'Diseases' — Entity category (exact match).
    - `genre` union — Filter by music genre. Accepts a single string or an array (max 20 items).
      - string
      - string[]
    - `lyrics_language` string — Filter by lyrics language (2-character ISO code).
    - `lyrics_explicit` boolean — Filter by explicit lyrics flag.
    - `has_profanities` boolean — Filter by profanity presence.
    - `first_release_date` string — Minimum release date — tracks released on or after this date (format: YYYYMMDD).
    - `needs_moderation` boolean — Filter by moderation flag.
    - `moderation_categories` string[] — Filter by specific moderation categories (max 20 items).

## Response `200`

200 OK / 400 Bad Request / 401 Unauthorized / 403 Forbidden

- object
  - `message` object
    - `header` object
      - `status_code` number
      - `execute_time` number
      - `available` number — Total hits from the search engine. Note: actual results in track_list may be fewer due to tracks without analysis data or with metadata restrictions being skipped.
    - `body` object
      - `track_list` object[]
        - `track` object — Standard track object (same fields as track.get).
          - `track_id` number
          - `track_name` string
          - `artist_name` string
          - `album_name` string
          - `commontrack_id` number
          - `first_release_date` string
          - `track_share_url` string
        - `analysis` object — Analysis object (same structure as track.lyrics.analysis.get).
          - `meaning` object
            - `explanation` string
            - `description` string
          - `themes` object
            - `main_themes` object[]
              - …
            - `description` string
          - `moods` object
            - `main_moods` string[]
            - `description` string
          - `rating` object
            - `audience` string
            - `descriptor` string
            - `description` string
          - `religion` object
            - `has_references` boolean
            - `referenced_religions` string[]
            - `description` string
          - `entities` object
            - `entity_list` object[]
              - …
            - `description` string
          - `moderation` object
            - `needs_moderation` boolean
            - `categories` object[]
              - …
            - `description` string
          - `explicitness` object
            - `has_profanities` boolean
            - `description` string

---

[API](https://skmtc.net/musixmatch/apis/lyrics-api.md) · [All operations](https://skmtc.net/musixmatch/apis/lyrics-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/musixmatch/lyrics-api/versions/edbc169d5499/schema)