---
title: "Retrieve Spotify public profile followers"
method: GET
path: "/spotify/profile/followers"
tags: ["Spotify"]
---

# Retrieve Spotify public profile followers

`GET /spotify/profile/followers`

## Request

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

Returns public Spotify follower profiles. Spotify exposes this publicly for some profiles; private or restricted profiles may return an upstream error.

## Query parameters

- `username` string
- `uri` string
- `url` string
- `offset` integer
- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SpotifyUserProfileFollowersResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` SpotifyUserProfileFollowersResponse
    - `limit` integer: Maximum number of followers requested.
    - `meta` SpotifyUserProfileMeta
      - `appVersion` string: Version of the Spotify web player the data was read from.
      - `artistCount` integer: Number of recently played artists 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.
      - `profileCount` integer: Number of user profiles returned.
    - `offset` integer: Position of the first follower returned.
    - `profiles` SpotifyUserProfileSummary[]: Follower profiles returned.
      - `color` integer: Accent color of the profile, as a number.
      - `externalUrl` string: Link to the user's profile on open.spotify.com.
      - `followersCount` integer: Number of followers the user has.
      - `imageUrl` string: URL of the user's profile image.
      - `isFollowing` boolean: Whether Spotify marks the user as followed.
      - `name` string: Display name of the user.
      - `uri` string: Spotify URI of the user.
      - `username` string: Spotify username of the user.
    - `total` integer: Total number of followers the user has.
    - `uri` string: Spotify URI of the user.
    - `username` string: Spotify username of the user.
  - `msg` unknown

## Other responses

- `400`: Missing or invalid parameters
- `429`: Rate limit exceeded
- `503`: Spotify upstream request failed

---

[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)