---
title: "Perform track search"
method: GET
path: "/api/v1/tracks/search"
tags: ["Search"]
---

# Perform track search

`GET /api/v1/tracks/search`

## Query parameters

- `page` string
- `sort` string
- `q` string
- `genreGroup[]` string
- `genreGroupOperator` string
- `notGenreGroup[]` string
- `genre[]` string
- `genreOperator` string
- `notGenre[]` string
- `mood[]` string
- `notMood[]` string
- `instrument[]` string
- `notInstrument[]` string
- `purpose[]` string
- `notPurpose[]` string
- `variable_tempo` string
- `min_tempo` string
- `max_tempo` string
- `min_duration` string
- `max_duration` string
- `key[]` string
- `per_page` integer

## Headers

- `Authorization` string, required

## Response `200`

Search results

- object
  - `data` object[] — Array of tracks
    - `id` string
    - `type` string
    - `attributes` object
      - `id` integer
      - `title` string
      - `tempo` integer
      - `description` string
      - `stream_url` string — Url for audio stream for preview in player of the main track oversion of this track.
      - `variable_tempo` boolean
      - `instruments` string[]
      - `moods` string[]
      - `genres` string[]
      - `purposes` string[]
      - `composer_id` integer
      - `artist_name` string
      - `composers` string[]
      - `length` integer — Length in seconds for main track version.
      - `publisher` string
      - `isrc` string
      - `cat_id` string
      - `relese_year` string
      - `start_key` string
      - `end_key` string
      - `avatar` string — Url for artist avatar.
      - `track_versions` object[]
        - `id` string
        - `title` string
        - `stream_url` string — Url for audio preview in player for the specific track version.
        - `length` integer — Length in seconds for this specific version.
        - `download_link` string — Download link for the specific track version (if available in the API plan).
  - `meta` object — Metadata
    - `obj_count` integer — Total count of found objects
    - `page_count` integer — Total count of pages

---

[API](https://skmtc.net/melod/apis/melodie-api.md) · [All operations](https://skmtc.net/melod/apis/melodie-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/melod/melodie-api/revisions/06cd6e66c531/schema)