> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scraperize.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Artist

> Returns a SoundCloud artist by handle or link: id, display and full name, description, city, country, full-size avatar and banner, verified badge and Pro badges, creator plan, follower and following counts, number of tracks, playlists, likes and comments, and when the profile last changed. Only publicly available data is returned.

> [!NOTE]
>
> **Cost: 1 credit** per successful request. Errors and cache hits (`cache_max_age`) are free.

> [accordion] Copy for AI assistant
>
> Paste this into ChatGPT, Claude or your coding assistant to generate working code for this endpoint (use the copy button).
>
> ```text Prompt
> I want to make an API call to /v1/soundcloud/artist. Here are the details:
>
> Endpoint: GET https://api.scraperize.com/v1/soundcloud/artist
> Description: Returns a SoundCloud artist by handle or link: id, display and full name, description, city, country, full-size avatar and banner, verified badge and Pro badges, creator plan, follower and following counts, number of tracks, playlists, likes and comments, and when the profile last changed. Only publicly available data is returned.
>
> Required Headers:
> - x-api-key: Your API key
>
> Parameters:
> - handle (string): The artist's handle (the name in their link), e.g. `billieeilish`. Required unless `url` is given.
> - url (string): The artist's link, e.g. `https://soundcloud.com/billieeilish`. Required unless `handle` is given.
> - cache_max_age (select): Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh.
>
> Example Response:
> {
>   "data": {
>     "id": "87105617",
>     "urn": "soundcloud:users:87105617",
>     "handle": "billieeilish",
>     "url": "https://soundcloud.com/billieeilish",
>     "name": "Billie Eilish",
>     "fullName": "Billie Eilish",
>     "firstName": "Billie",
>     "lastName": "Eilish",
>     "description": "Check out my very first fans on SoundCloud! - https://bit.ly/4bkp7pP\n\nMANAGEMENT:\nDanny Rukasin and Brandon Goodman\n\nBOOKING:\nTom Windish and Sara Bollwinkel\nBi…",
>     "city": null,
>     "countryCode": null,
>     "avatarUrl": "https://i1.sndcdn.com/avatars-V2fT1gZ1s4eokCrM-RnxA3g-t1080x1080.jpg",
>     "bannerUrl": "https://i1.sndcdn.com/visuals-000087105617-s6Pn4I-original.jpg",
>     "isVerified": true,
>     "badges": {
>       "pro": false,
>       "proUnlimited": true,
>       "creatorMidTier": false,
>       "verified": true
>     },
>     "plan": "creator-pro-unlimited",
>     "followers": 4021038,
>     "following": 58,
>     "tracks": 89,
>     "playlists": 17,
>     "likes": 371,
>     "playlistLikes": 3,
>     "comments": 0,
>     "reposts": null,
>     "createdAt": null,
>     "lastModified": "2025-11-20T16:21:02Z",
>     "stationUrn": "soundcloud:system-playlists:artist-stations:87105617",
>     "fetchedAt": "2026-11-11T09:06:09.636Z"
>   },
>   "meta": {
>     "requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
>     "creditsCharged": 1,
>     "creditsRemaining": 4999,
>     "cached": false
>   }
> }
>
> Please help me write code in my preferred programming language to make this API call and handle the response appropriately. Include error handling and best practices.
> ```


## OpenAPI

````yaml /api-reference/openapi.json get /v1/soundcloud/artist
openapi: 3.0.3
info:
  title: Scraperize API
  version: 1.0.0
  description: >-
    Extract public data from social media platforms as clean JSON. Endpoints are
    split by platform and by what they return, e.g. `GET /v1/twitter/tweet`.


    ## Authentication

    Send your API key in the `x-api-key` header (or `Authorization: Bearer
    <key>`). Create keys in your dashboard.


    ## Credits

    Each successful live scrape costs **1 credit**. Credits are prepaid and
    never expire.


    ## Caching

    Every endpoint accepts an optional `cache_max_age`
    (`1d`|`3d`|`7d`|`14d`|`30d`). A cache hit within that window is returned for
    **0 credits**.


    ## Responses

    Success returns `{ "data": …, "meta": { "requestId", … } }`. Errors return
    `{ "error": { "code", "message", "requestId" } }` with a matching HTTP
    status. `meta` on a scrape carries `creditsCharged`, `creditsRemaining`,
    `cached`, and (on a hit) `cachedAt`.


    ## Rate limits

    Requests are limited per team per minute; over the limit returns `429` with
    a `Retry-After` header.
servers:
  - url: https://api.scraperize.com
    description: Production
security:
  - ApiKeyAuth: []
tags:
  - name: Twitter
    description: Twitter / X scraping endpoints
  - name: Facebook
    description: Facebook scraping endpoints
  - name: Linkme
    description: Linkme (link.me) scraping endpoints
  - name: Amazon
    description: Amazon (creator shop / storefront) scraping endpoints
  - name: Linkbio
    description: Linkbio (lnk.bio) scraping endpoints
  - name: Pillar
    description: Pillar (pillar.io) scraping endpoints
  - name: Komi
    description: Komi (komi.io) scraping endpoints
  - name: Linktree
    description: Linktree (linktr.ee) scraping endpoints
  - name: Kick
    description: Kick (kick.com) scraping endpoints
  - name: Snapchat
    description: Snapchat (snapchat.com) scraping endpoints
  - name: Telegram
    description: Telegram (t.me) scraping endpoints
  - name: LinkedIn
    description: LinkedIn scraping endpoints
  - name: Twitch
    description: Twitch scraping endpoints
  - name: TikTok
    description: TikTok (tiktok.com) scraping endpoints
  - name: Instagram
    description: Instagram scraping endpoints
  - name: Lagos Life
    description: Lagos Life scraping endpoints
  - name: Bluesky
    description: Bluesky (bsky.app) scraping endpoints
  - name: Threads
    description: Threads (threads.com) scraping endpoints
  - name: Reddit
    description: Reddit (reddit.com) scraping endpoints
  - name: Rumble
    description: Rumble (rumble.com) scraping endpoints
  - name: SoundCloud
    description: SoundCloud (soundcloud.com) scraping endpoints
  - name: Kwai
    description: Kwai (kwai.com) scraping endpoints
  - name: Apple Music
    description: Apple Music (music.apple.com) scraping endpoints
  - name: Truth Social
    description: Truth Social (truthsocial.com) scraping endpoints
  - name: YouTube
    description: YouTube (youtube.com) scraping endpoints
paths:
  /v1/soundcloud/artist:
    get:
      tags:
        - SoundCloud
      summary: Artist
      description: >-
        Returns a SoundCloud artist by handle or link: id, display and full
        name, description, city, country, full-size avatar and banner, verified
        badge and Pro badges, creator plan, follower and following counts,
        number of tracks, playlists, likes and comments, and when the profile
        last changed. Only publicly available data is returned.
      parameters:
        - name: handle
          in: query
          required: false
          description: >-
            The artist's handle (the name in their link), e.g. `billieeilish`.
            Required unless `url` is given.
          schema:
            type: string
          example: billieeilish
        - name: url
          in: query
          required: false
          description: >-
            The artist's link, e.g. `https://soundcloud.com/billieeilish`.
            Required unless `handle` is given.
          schema:
            type: string
        - name: cache_max_age
          in: query
          required: false
          description: >-
            Optional. Return a cached result if one this age or newer exists —
            served for **0 credits** with `meta.cached=true` and
            `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and
            refreshes the cache. Omit to always scrape fresh.
          schema:
            type: string
            enum:
              - 1d
              - 3d
              - 7d
              - 14d
              - 30d
          example: 7d
      responses:
        '200':
          description: The artist.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                  meta:
                    type: object
                    description: >-
                      requestId + credit/caching metadata (creditsCharged,
                      creditsRemaining, cached, cachedAt).
                required:
                  - data
                  - meta
              example:
                data:
                  id: '87105617'
                  urn: soundcloud:users:87105617
                  handle: billieeilish
                  url: https://soundcloud.com/billieeilish
                  name: Billie Eilish
                  fullName: Billie Eilish
                  firstName: Billie
                  lastName: Eilish
                  description: >-
                    Check out my very first fans on SoundCloud! -
                    https://bit.ly/4bkp7pP


                    MANAGEMENT:

                    Danny Rukasin and Brandon Goodman


                    BOOKING:

                    Tom Windish and Sara Bollwinkel

                    BillieEilishBooking@paradigmagency.com


                    PUBLICITY:

                    Alex Baker

                    alexandra@highrisepr.com
                  city: null
                  countryCode: null
                  avatarUrl: >-
                    https://i1.sndcdn.com/avatars-V2fT1gZ1s4eokCrM-RnxA3g-t1080x1080.jpg
                  bannerUrl: >-
                    https://i1.sndcdn.com/visuals-000087105617-s6Pn4I-original.jpg
                  isVerified: true
                  badges:
                    pro: false
                    proUnlimited: true
                    creatorMidTier: false
                    verified: true
                  plan: creator-pro-unlimited
                  followers: 4021038
                  following: 58
                  tracks: 89
                  playlists: 17
                  likes: 371
                  playlistLikes: 3
                  comments: 0
                  reposts: null
                  createdAt: null
                  lastModified: '2025-11-20T16:21:02Z'
                  stationUrn: soundcloud:system-playlists:artist-stations:87105617
                  fetchedAt: '2026-11-11T09:06:09.636Z'
                meta:
                  requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
                  creditsCharged: 1
                  creditsRemaining: 4999
                  cached: false
        '401':
          description: Missing, invalid, or revoked API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error:
                  code: UNAUTHORIZED
                  message: API key required — pass it in the `x-api-key` header.
                  requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
        '402':
          description: Not enough credits for this request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error:
                  code: INSUFFICIENT_CREDITS
                  message: >-
                    This request costs 1 credit, but your balance is 0. Top up
                    to continue.
                  requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
        '404':
          description: No SoundCloud account with that handle.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error:
                  code: NOT_FOUND
                  message: >-
                    The requested content was not found (it may not exist, be
                    deleted, or be private).
                  requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
        '422':
          description: Invalid query parameters (`handle` or `url` is required).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error:
                  code: VALIDATION_ERROR
                  message: Request validation failed
                  requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
                  details:
                    - path: url
                      message: url is required
        '429':
          description: Over the per-minute rate limit — honour `Retry-After`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error:
                  code: RATE_LIMITED
                  message: >-
                    Rate limit exceeded — max 100 requests per 60s. Retry in
                    ~30s.
                  requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
        '503':
          description: >-
            Temporarily unavailable — retry after `Retry-After`. `error.code`
            tells you why: `UPSTREAM_BLOCKED` (the source blocked this request),
            `EXTRACTION_FAILED` (the source returned unexpected data),
            `PLATFORM_UNAVAILABLE` (the source is down), or
            `SERVICE_UNAVAILABLE` (we are at capacity).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error:
                  code: UPSTREAM_BLOCKED
                  message: >-
                    The source is temporarily unavailable. Please try again
                    shortly.
                  requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              example: NOT_FOUND
            message:
              type: string
              example: The requested content was not found.
            requestId:
              type: string
              example: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f
            details:
              type: array
              items:
                type: object
              description: Present on validation errors.
          required:
            - code
            - message
            - requestId
      required:
        - error
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Your API key. Send it in the `x-api-key` header (or `Authorization:
        Bearer <key>`). Create and manage keys from your dashboard.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.