---
title: "Search Spotify artists"
method: GET
path: "/spotify/artists/search"
tags: ["Spotify"]
---

# Search Spotify artists

`GET /spotify/artists/search`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/spotify/artists/search`
- Auth: API key in header `x-api-key`

Searches Spotify for artists matching a term, with `offset` and `limit` (1-50). Each artist has a title, Spotify URI, external URL and images. Matching artists are returned in both `results` and `artists`.

## Query parameters

- `q` string, required
- `offset` integer
- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SpotifySearchCatalogResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` SpotifySearchResponse
    - `albums` SpotifySearchResultSummary[]: Albums that matched the search term.
      - `description` string: Description text of the result.
      - `externalUrl` string: Link to the result on open.spotify.com.
      - `imageUrl` string: URL of the main image for the result.
      - `images` SpotifyImageAsset[]: Images available for the result, with their sizes.
        - `height` integer: Image height in pixels.
        - `url` string: URL of the image.
        - `width` integer: Image width in pixels.
      - `publisher` string: Publisher or creator name of the result.
      - `subtitle` string: Secondary line shown under the title, such as the artist or creator name.
      - `title` string: Result title as Spotify shows it.
      - `type` string: Kind of result as Spotify labels it, for example `Podcast`.
      - `uri` string: Spotify URI of the result.
    - `artists` SpotifySearchResultSummary[]: Artists that matched the search term.
      - `description` string: Description text of the result.
      - `externalUrl` string: Link to the result on open.spotify.com.
      - `imageUrl` string: URL of the main image for the result.
      - `images` SpotifyImageAsset[]: Images available for the result, with their sizes.
        - `height` integer: Image height in pixels.
        - `url` string: URL of the image.
        - `width` integer: Image width in pixels.
      - `publisher` string: Publisher or creator name of the result.
      - `subtitle` string: Secondary line shown under the title, such as the artist or creator name.
      - `title` string: Result title as Spotify shows it.
      - `type` string: Kind of result as Spotify labels it, for example `Podcast`.
      - `uri` string: Spotify URI of the result.
    - `audiobooks` SpotifySearchResultSummary[]: Audiobooks that matched the search term.
      - `description` string: Description text of the result.
      - `externalUrl` string: Link to the result on open.spotify.com.
      - `imageUrl` string: URL of the main image for the result.
      - `images` SpotifyImageAsset[]: Images available for the result, with their sizes.
        - `height` integer: Image height in pixels.
        - `url` string: URL of the image.
        - `width` integer: Image width in pixels.
      - `publisher` string: Publisher or creator name of the result.
      - `subtitle` string: Secondary line shown under the title, such as the artist or creator name.
      - `title` string: Result title as Spotify shows it.
      - `type` string: Kind of result as Spotify labels it, for example `Podcast`.
      - `uri` string: Spotify URI of the result.
    - `episodes` SpotifySearchResultSummary[]: Podcast episodes that matched the search term.
      - `description` string: Description text of the result.
      - `externalUrl` string: Link to the result on open.spotify.com.
      - `imageUrl` string: URL of the main image for the result.
      - `images` SpotifyImageAsset[]: Images available for the result, with their sizes.
        - `height` integer: Image height in pixels.
        - `url` string: URL of the image.
        - `width` integer: Image width in pixels.
      - `publisher` string: Publisher or creator name of the result.
      - `subtitle` string: Secondary line shown under the title, such as the artist or creator name.
      - `title` string: Result title as Spotify shows it.
      - `type` string: Kind of result as Spotify labels it, for example `Podcast`.
      - `uri` string: Spotify URI of the result.
    - `limit` integer: Maximum number of results requested per section.
    - `meta` SpotifySearchMeta
      - `albumCount` integer: Number of albums returned.
      - `appVersion` string: Version of the Spotify web player the data was read from.
      - `artistCount` integer: Number of artists returned.
      - `audiobookCount` integer: Number of audiobooks returned.
      - `episodeCount` integer: Number of episodes returned.
      - `fetchedAt` string: Time the data was fetched, in UTC (RFC 3339).
      - `operationName` string: Name of the Spotify web player operation that returned the data.
      - `playlistCount` integer: Number of playlists returned.
      - `resultCount` integer: Total number of results returned.
      - `showCount` integer: Number of shows returned.
      - `topCount` integer: Number of top results returned.
      - `trackCount` integer: Number of tracks returned.
      - `userCount` integer: Number of user profiles returned.
    - `offset` integer: Position of the first result returned.
    - `playlists` SpotifySearchResultSummary[]: Playlists that matched the search term.
      - `description` string: Description text of the result.
      - `externalUrl` string: Link to the result on open.spotify.com.
      - `imageUrl` string: URL of the main image for the result.
      - `images` SpotifyImageAsset[]: Images available for the result, with their sizes.
        - `height` integer: Image height in pixels.
        - `url` string: URL of the image.
        - `width` integer: Image width in pixels.
      - `publisher` string: Publisher or creator name of the result.
      - `subtitle` string: Secondary line shown under the title, such as the artist or creator name.
      - `title` string: Result title as Spotify shows it.
      - `type` string: Kind of result as Spotify labels it, for example `Podcast`.
      - `uri` string: Spotify URI of the result.
    - `results` SpotifySearchResultSummary[]: All results found, across every type.
      - `description` string: Description text of the result.
      - `externalUrl` string: Link to the result on open.spotify.com.
      - `imageUrl` string: URL of the main image for the result.
      - `images` SpotifyImageAsset[]: Images available for the result, with their sizes.
        - `height` integer: Image height in pixels.
        - `url` string: URL of the image.
        - `width` integer: Image width in pixels.
      - `publisher` string: Publisher or creator name of the result.
      - `subtitle` string: Secondary line shown under the title, such as the artist or creator name.
      - `title` string: Result title as Spotify shows it.
      - `type` string: Kind of result as Spotify labels it, for example `Podcast`.
      - `uri` string: Spotify URI of the result.
    - `searchTerm` string: Search term that was run.
    - `shows` SpotifySearchResultSummary[]: Podcast shows that matched the search term.
      - `description` string: Description text of the result.
      - `externalUrl` string: Link to the result on open.spotify.com.
      - `imageUrl` string: URL of the main image for the result.
      - `images` SpotifyImageAsset[]: Images available for the result, with their sizes.
        - `height` integer: Image height in pixels.
        - `url` string: URL of the image.
        - `width` integer: Image width in pixels.
      - `publisher` string: Publisher or creator name of the result.
      - `subtitle` string: Secondary line shown under the title, such as the artist or creator name.
      - `title` string: Result title as Spotify shows it.
      - `type` string: Kind of result as Spotify labels it, for example `Podcast`.
      - `uri` string: Spotify URI of the result.
    - `topResults` SpotifySearchResultSummary[]: Best matches across all result types.
      - `description` string: Description text of the result.
      - `externalUrl` string: Link to the result on open.spotify.com.
      - `imageUrl` string: URL of the main image for the result.
      - `images` SpotifyImageAsset[]: Images available for the result, with their sizes.
        - `height` integer: Image height in pixels.
        - `url` string: URL of the image.
        - `width` integer: Image width in pixels.
      - `publisher` string: Publisher or creator name of the result.
      - `subtitle` string: Secondary line shown under the title, such as the artist or creator name.
      - `title` string: Result title as Spotify shows it.
      - `type` string: Kind of result as Spotify labels it, for example `Podcast`.
      - `uri` string: Spotify URI of the result.
    - `tracks` SpotifySearchResultSummary[]: Tracks that matched the search term.
      - `description` string: Description text of the result.
      - `externalUrl` string: Link to the result on open.spotify.com.
      - `imageUrl` string: URL of the main image for the result.
      - `images` SpotifyImageAsset[]: Images available for the result, with their sizes.
        - `height` integer: Image height in pixels.
        - `url` string: URL of the image.
        - `width` integer: Image width in pixels.
      - `publisher` string: Publisher or creator name of the result.
      - `subtitle` string: Secondary line shown under the title, such as the artist or creator name.
      - `title` string: Result title as Spotify shows it.
      - `type` string: Kind of result as Spotify labels it, for example `Podcast`.
      - `uri` string: Spotify URI of the result.
    - `users` SpotifySearchResultSummary[]: User profiles that matched the search term.
      - `description` string: Description text of the result.
      - `externalUrl` string: Link to the result on open.spotify.com.
      - `imageUrl` string: URL of the main image for the result.
      - `images` SpotifyImageAsset[]: Images available for the result, with their sizes.
        - `height` integer: Image height in pixels.
        - `url` string: URL of the image.
        - `width` integer: Image width in pixels.
      - `publisher` string: Publisher or creator name of the result.
      - `subtitle` string: Secondary line shown under the title, such as the artist or creator name.
      - `title` string: Result title as Spotify shows it.
      - `type` string: Kind of result as Spotify labels it, for example `Podcast`.
      - `uri` string: Spotify URI of the result.
  - `msg` unknown

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `503`: Service Unavailable

---

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