---
title: "Search"
method: POST
path: "/search"
tags: ["Search"]
---

# Search

`POST /search`

## Request

- Base URL: `https://api.luminatedata.com`
- URL: `https://api.luminatedata.com/search`
- Auth: API key in header `x-api-key` and API key in header `authorization`

Search for entity type and query string.

## Headers

- `Accept` 'application/vnd.luminate-data.svc-apibff.v1+json'

## Request body

- SearchRequest
  - `query` string, required: Text search for specified entity.
  - `entity_type` 'song' | 'artist' | 'musical_recording' | 'musical_product' | 'musical_release_group' | 'musical_work', required: Use the entity_type parameter to specify the search category.
  - `from` integer: Offset from first result, used for pagination.
  - `size` integer: Number of results to return, used for pagination.

## Response `200`

OK

- union
  - ArtistSearchResponseByTitle
    - `results` SearchArtist[]
      - `id` string
      - `artist_name` string
    - `from` integer
    - `size` integer
    - `total_results` integer
  - SongSearchResponseByTitle
    - `results` SearchSong[]
      - `id` string
      - `title` string
      - `display_artist_name` string
    - `from` integer
    - `size` integer
    - `total_results` integer
  - MusicalRecordingSearchResponseByTitle
    - `results` SearchMusicalRecording[]
      - `id` string
      - `title` string
      - `display_artist_name` string
    - `from` integer
    - `size` integer
    - `total_results` integer
  - MusicalProductSearchResponseByTitle
    - `results` SearchMusicalProduct[]
      - `id` string
      - `title` string
      - `display_artist_name` string
    - `from` integer
    - `size` integer
    - `total_results` integer
  - MusicalReleaseGroupSearchResponseByTitle
    - `results` SearchMusicalReleaseGroup[]
      - `id` string
      - `title` string
      - `display_artist_name` string
    - `from` integer
    - `size` integer
    - `total_results` integer
  - MusicalWorkSearchResponseByTitle
    - `results` SearchMusicalWork[]
      - `id` string
      - `title` string
    - `from` integer
    - `size` integer
    - `total_results` integer

---

[API](https://skmtc.dev/luminatedata/apis/luminate-music-api.md) - [All operations](https://skmtc.dev/luminatedata/apis/luminate-music-api/llms.txt) - [OpenAPI document](https://skmtc.dev/luminatedata/apis/luminate-music-api/revisions/271d2be26e14?raw)