---
title: "SoundCloud Artist API"
method: GET
path: "/v1/soundcloud/artist"
tags: ["SoundCloud"]
---

# SoundCloud Artist API

`GET /v1/soundcloud/artist`

## Request

- Base URL: `https://api.captapi.com`
- URL: `https://api.captapi.com/v1/soundcloud/artist`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

SoundCloud artist — handle + name, subscriptionTier, externalLinks, verified (1 credit).

Pass a SoundCloud artist URL or username and get clean JSON: id, handle (permalink slug — the join key), name, description, avatar, city/countryCode, verified, subscriptionTier (pro-unlimited|pro|mid-tier|free — one field, not badges + creatorSubscription duplicates), followers/followings/trackCount/playlistCount/likesCount, externalLinks[{url,network,title,username}] from SoundCloud web-profiles when published, createdAt when SoundCloud exposes it (often redacted on the public api-v2), and lastModified. Identity is handle + name only. city/countryCode are omitted when unpublished (never nulled). Flat 1 credit. Accepts cache / cacheMaxAge.

Docs: https://captapi.com/apis/soundcloud-artist

## Query parameters

- `url` string, required
- `cache` boolean
- `cacheMaxAge` '1d' | '3d' | '7d' | '14d' | '30d'

## Response `200`

Success. The data object for this endpoint.

- object
  - `success` unknown, required
  - `data` object, required
    - `platform` string: Always "soundcloud" on this endpoint.
    - `id` string: Stable platform ID for the item.
    - `handle` string: Permalink slug in the profile URL (e.g. flume) — the join key.
    - `url` string: Canonical URL of the item.
    - `name` string: Display name: SoundCloud full_name when set, otherwise their display-username value.
    - `description` string: Description text.
    - `avatar` string: Avatar / profile picture URL. Canonical across profile endpoints.
    - `city` string: City. Example: "Sydney".
    - `countryCode` string: ISO-3166 alpha-2 country code (e.g. US, MX).
    - `verified` boolean: Whether the account is verified. Top-level only (not duplicated under badges).
    - `subscriptionTier` string: Canonical plan: "pro-unlimited" | "pro" | "mid-tier" | "free" — replaces badges.proUnlimited + creatorSubscription.product.id.
    - `followers` integer: Follower count.
    - `followings` integer: Number of accounts this artist follows.
    - `trackCount` integer: Public track count.
    - `playlistCount` integer: Public playlist count.
    - `likesCount` integer: Likes count on the profile when SoundCloud exposes it.
    - `lastModified` string: When the SoundCloud profile was last modified (ISO 8601).
    - `externalLinks` object[]
      - `url` string: Canonical URL of the item.
      - `network` string: Network. Example: "personal".
      - `title` string: Title of this external links item.
      - `username` string

## Other responses

- `400`: Bad request: wrong platform URL, unknown endpoint, or an invalid parameter value. Not billed.
- `401`: Missing, invalid or revoked API key. Not billed.
- `402`: Not enough credits for this request. Not billed.
- `404`: The resource does not exist or is not public. Not billed.
- `422`: A required parameter is missing or has the wrong type. Not billed.
- `429`: Rate limit reached. Wait for Retry-After seconds. Not billed.
- `502`: The platform could not be reached or returned nothing usable. Retryable, not billed. 503 and 504 use the same envelope.

---

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