---
title: "Label search"
method: GET
path: "/v1/labels/search"
tags: ["Labels"]
---

# Label search

`GET /v1/labels/search`

## Request

- Base URL: `https://api.sonovault.now`
- URL: `https://api.sonovault.now/v1/labels/search`
- Auth: API key in header `x-api-key`

Search for record labels by name. Returns labels sorted by relevance and release count.

## Query parameters

- `name` string, required
- `limit` integer
- `cursor` string

## Response `200`

Successful response

- object
  - `results` Label[], required: Matching labels, by relevance then catalog size.
    - `id` integer, required: Label ID.
    - `name` string, required: Label name.
    - `release_count` integer, required: Number of releases on the label.
    - `artist_count` integer: Number of distinct artists with a release on the label. Returned by `GET /v1/labels/:id` only.
  - `next_cursor` string, nullable, required: Pass back as the `cursor` param for the next page. `null` on the last page.

---

[API](https://skmtc.dev/sonovault/apis/sonovault-api.md) · [All operations](https://skmtc.dev/sonovault/apis/sonovault-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sonovault/apis/sonovault-api/revisions/0152fff23f2c?raw)