---
title: "Retrieve Spotify artist details"
method: GET
path: "/spotify/artist"
tags: ["Spotify"]
---

# Retrieve Spotify artist details

`GET /spotify/artist`

## Request

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

Returns a Spotify artist's profile by artist URI, `open.spotify.com` URL or id: name, verified flag, follower count, monthly listeners (`monthlyUsers`), biography and images, plus top tracks, selected discography, related artists and artist playlists when Spotify returns them.

## Query parameters

- `uri` string
- `id` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SpotifyArtistResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` SpotifyArtistResponse
    - `biography` string: Artist biography text.
    - `discography` SpotifySearchResultSummary[]: Selection of the artist's albums and releases.
      - `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.
    - `externalUrl` string: Link to the artist on open.spotify.com.
    - `followers` integer: Number of Spotify followers the artist has.
    - `id` string: Spotify ID of the artist.
    - `imageUrl` string: URL of the main artist image.
    - `images` SpotifyImageAsset[]: Images available for the artist, with their sizes.
      - `height` integer: Image height in pixels.
      - `url` string: URL of the image.
      - `width` integer: Image width in pixels.
    - `meta` SpotifyArtistMeta
      - `appVersion` string: Version of the Spotify web player the data was read from.
      - `discographyCount` integer: Number of discography entries 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.
      - `relatedCount` integer: Number of related artists returned.
      - `topTrackCount` integer: Number of top tracks returned.
    - `monthlyUsers` integer: Number of monthly listeners Spotify shows for the artist.
    - `name` string: Artist name as Spotify shows it.
    - `playlists` SpotifySearchResultSummary[]: Playlists featuring the artist.
      - `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.
    - `related` SpotifySearchResultSummary[]: Artists related to this artist.
      - `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.
    - `shareUrl` string: Link to the artist that Spotify offers for sharing.
    - `topTracks` SpotifySearchResultSummary[]: Most popular tracks of the artist.
      - `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.
    - `type` string: Kind of item as Spotify labels it, for example `Artist`.
    - `uri` string: Spotify URI of the artist.
    - `verified` boolean: Whether Spotify shows the artist as verified.
  - `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)