Dokumentation der Spotify-API

Spotify API: Künstler — Informationen nach Nutzer-ID

Rufen Sie detaillierte öffentliche Künstler-Daten von Spotify über eine bekannte Kennung für Objektkarten, Validierung und Anreicherung ab.

Nutzen Sie „Informationen nach Nutzer-ID“, wenn das Objekt bereits bekannt ist und Ihr Produkt seinen aktuellen öffentlichen Kontext benötigt.

Methode GET
Entität Künstler
Versionen 2
Was dieser Endpunkt macht

Was Sie mit dieser API-Methode bauen können

Prüfen Sie zuerst das Ergebnis und die typischen Abläufe und gehen Sie dann zu den Parametern und einem funktionierenden Anfragebeispiel über.

Wobei dieser Endpunkt hilft

Die Antwort liefert die verfügbaren Künstler-Felder im normalisierten V2-Format oder im nativen V1-Format der Plattform.

Wann er sinnvoll ist

Nutzen Sie „Informationen nach Nutzer-ID“, wenn das Objekt bereits bekannt ist und Ihr Produkt seinen aktuellen öffentlichen Kontext benötigt.

Typische Anwendungsfälle

Anreicherung von Datensätzen

Ergänzen Sie bekannte Objekte Ihres Produkts um öffentliche Spotify-Felder.

Datenvalidierung

Prüfen Sie Kennungen und den aktuellen öffentlichen Kontext vor der weiteren Verarbeitung.

Vorbereitung für Analysen

Nutzen Sie die Objektdetails als Eingabe für Berichte, Bewertungen und verwandte Anfragen.

Verfügbare Versionen

Antwortversion

Beide Versionen lösen dieselbe Aufgabe und akzeptieren dieselben Parameter. Vergleichen Sie mit dem Umschalter die Antwortstruktur und wählen Sie die Version, die Ihr Client erwartet.

Antwortversion V2

Wechseln Sie auf dieser Seite die Version, um die Antwortstrukturen unter derselben Dokumentations-URL zu vergleichen.

Was gleich bleibt

Authentifizierung, Pflichtparameter und Anfrageform sind in V1 und V2 identisch. In der Praxis wählen Sie die Version beim Aufbau des Endpunktpfads und bei der Auswertung der Antwort.

Was sich zwischen den Versionen ändert

Der Hauptunterschied liegt in der Antwort-Hülle. Verwenden Sie V2 für neue Integrationen und behalten Sie V1 nur, wenn Sie Kompatibilität mit einem bestehenden Client-Vertrag benötigen.

So verwenden Sie ihn

So rufen Sie die Methode auf

Verwenden Sie in beiden Versionen denselben API-Schlüssel-Header und dieselben Query-Parameter. Diese Dokumentation zeigt zuerst den gemeinsamen Parametersatz und danach die Pfade und Codeausschnitte jeder Version.

Eingabeparameter

Gemeinsame Parameter
Parameter Pflicht Typ Beispiel Beschreibung
user_id Ja str 06HL4z0CvFAxyc27GXpf02 Numerische ID des Nutzers auf der gewählten Plattform.

Anfragepfad nach Version

V2

Wählen Sie eine Version, wenn Sie den genauen Endpunktpfad, die Beispiel-URL und den Codeausschnitt kopieren. Die Parameterliste oben ändert sich nicht.

GET /api/v2/spotify.com/artist/info-by-user-id

Normalisiertes Format

Codebeispiele

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/spotify.com/artist/info-by-user-id" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'user_id=06HL4z0CvFAxyc27GXpf02'
Antwortbeispiel

Live-Antwort nach Version

Die Vorschau enthält die wichtigsten Felder und die ersten Elemente der Sammlung, damit Sie die Form der Antwort schnell prüfen können. Beim Wechsel der Version ändert sich das JSON-Format.

Antwortbeispiel

V2 Antwort-JSON

Verifiziertes Beispiel

Dieses kompakte JSON-Beispiel stammt aus dem letzten erfolgreichen Verifizierungslauf von V2.

{
  "success": true,
  "status": "ok",
  "search_context": {
    "user_id": "06HL4z0CvFAxyc27GXpf02"
  },
  "data": {
    "artist": {
      "url": "https://open.spotify.com/artist/06HL4z0CvFAxyc27GXpf02",
      "artist_id": "06HL4z0CvFAxyc27GXpf02",
      "uri": "spotify:artist:06HL4z0CvFAxyc27GXpf02",
      "display_name": "Taylor Swift",
      "dominant_color_hex": "#50A080",
      "verified": true,
      "description": "And, baby, that’s show business for you. New album The Life of a Showgirl. Available now ❤️‍🔥",
      "emails": [],
      "is_merch": false,
      "follower_count": 161015282,
      "monthly_listener_count": 101231490,
      "world_rank": 7,
      "artist_playlists_count": 4,
      "appears_count": 0,
      "featuring_count": 0,
      "discovered_count": 0,
      "related_artists_count": 40,
      "popular_releases_albums_count": 20,
      "singles_count": 79,
      "albums_count": 33,
      "compilations_count": 1,
      "merch_count": 0,
      "concerts_count": 0,
      "top_cities": [
        {
          "city": "London",
          "country_code": "GB",
          "region": "ENG",
          "listener_count": 1632985
        },
        {
          "city": "Quezon City",
          "country_code": "PH",
          "region": "00",
          "listener_count": 1198992
        },
        {
          "_more_items": 3
        }
      ],
      "_more_fields": "3 more fields"
    },
    "external_links": [
      {
        "url": "https://facebook.com/TaylorSwift",
        "label": "Facebook",
        "link_type": "facebook"
      },
      {
        "url": "https://instagram.com/taylorswift",
        "label": "Instagram",
        "link_type": "instagram"
      },
      {
        "_more_items": 1
      }
    ],
    "pinned_item": {
      "item_type": "ALBUM",
      "title": "I Knew It, I Knew You (From \"Toy Story 5\")",
      "subtitle": "Single • New Release",
      "comment": "From Toy Story 5",
      "uri": "spotify:album:3ZLIShtR6Fjs4nTWFpBUB6",
      "url": "https://open.spotify.com/album/3ZLIShtR6Fjs4nTWFpBUB6",
      "thumbnail_url": "https://example.com/image.jpg"
    },
    "latest_release": {
      "url": "https://open.spotify.com/album/4Ii9whWXI1O1H01ziECRaG",
      "release_id": "4Ii9whWXI1O1H01ziECRaG",
      "uri": "spotify:album:4Ii9whWXI1O1H01ziECRaG",
      "title": "I Knew It, I Knew You (From \"Toy Story 5\")",
      "type": "SINGLE",
      "thumbnail_url": "https://example.com/image.jpg",
      "label": "Walt Disney Records / Pixar",
      "release_date": "2026-06-12",
      "release_date_precision": "DAY",
      "track_count": 3
    },
    "popular_releases": {
      "count": 10,
      "total_count": 20,
      "items": [
        {
          "url": "https://open.spotify.com/album/4a6NzYL1YHRUgx9e3YZI6I",
          "release_id": "4a6NzYL1YHRUgx9e3YZI6I",
          "uri": "spotify:album:4a6NzYL1YHRUgx9e3YZI6I",
          "title": "The Life of a Showgirl",
          "type": "ALBUM",
          "thumbnail_url": "https://example.com/image.jpg",
          "label": "Taylor Swift",
          "release_date": "2025-10-03",
          "release_date_precision": "DAY",
          "track_count": 12
        },
        {
          "url": "https://open.spotify.com/album/1NAmidJlEaVgA3MpcPFYGq",
          "release_id": "1NAmidJlEaVgA3MpcPFYGq",
          "uri": "spotify:album:1NAmidJlEaVgA3MpcPFYGq",
          "title": "Lover",
          "type": "ALBUM",
          "thumbnail_url": "https://example.com/image.jpg",
          "label": "Taylor Swift",
          "release_date": "2019-08-23",
          "release_date_precision": "DAY",
          "track_count": 18
        },
        {
          "_more_items": 8
        }
      ]
    },
    "albums": {
      "count": 10,
      "total_count": 33,
      "items": [
        {
          "url": "https://open.spotify.com/album/6QNMhoV8V0u7cFuhhUBOn7",
          "release_id": "6QNMhoV8V0u7cFuhhUBOn7",
          "uri": "spotify:album:6QNMhoV8V0u7cFuhhUBOn7",
          "title": "The Life of a Showgirl + Acoustic Collection",
          "type": "ALBUM",
          "thumbnail_url": "https://example.com/image.jpg",
          "label": "Taylor Swift",
          "release_date": "2025-11-07",
          "release_date_precision": "DAY",
          "track_count": 19
        },
        {
          "url": "https://open.spotify.com/album/4a6NzYL1YHRUgx9e3YZI6I",
          "release_id": "4a6NzYL1YHRUgx9e3YZI6I",
          "uri": "spotify:album:4a6NzYL1YHRUgx9e3YZI6I",
          "title": "The Life of a Showgirl",
          "type": "ALBUM",
          "thumbnail_url": "https://example.com/image.jpg",
          "label": "Taylor Swift",
          "release_date": "2025-10-03",
          "release_date_precision": "DAY",
          "track_count": 12
        },
        {
          "_more_items": 8
        }
      ]
    },
    "singles": {
      "count": 10,
      "total_count": 79,
      "items": [
        {
          "url": "https://open.spotify.com/album/4Ii9whWXI1O1H01ziECRaG",
          "release_id": "4Ii9whWXI1O1H01ziECRaG",
          "uri": "spotify:album:4Ii9whWXI1O1H01ziECRaG",
          "title": "I Knew It, I Knew You (From \"Toy Story 5\")",
          "type": "SINGLE",
          "thumbnail_url": "https://example.com/image.jpg",
          "label": "Walt Disney Records / Pixar",
          "release_date": "2026-06-12",
          "release_date_precision": "DAY",
          "track_count": 3
        },
        {
          "url": "https://open.spotify.com/album/71GTik4z9bbKKY2EmUvkDI",
          "release_id": "71GTik4z9bbKKY2EmUvkDI",
          "uri": "spotify:album:71GTik4z9bbKKY2EmUvkDI",
          "title": "Elizabeth Taylor",
          "type": "SINGLE",
          "thumbnail_url": "https://example.com/image.jpg",
          "label": "Taylor Swift",
          "release_date": "2026-03-31",
          "release_date_precision": "DAY",
          "track_count": 3
        },
        {
          "_more_items": 8
        }
      ]
    },
    "compilations": {
      "count": 1,
      "total_count": 1,
      "items": [
        {
          "url": "https://open.spotify.com/album/30gDvYhEgyTbGEdCIY8FWV",
          "release_id": "30gDvYhEgyTbGEdCIY8FWV",
          "uri": "spotify:album:30gDvYhEgyTbGEdCIY8FWV",
          "title": "THE TORTURED POETS DEPARTMENT | TS The Eras Tour Setlist",
          "type": "COMPILATION",
          "thumbnail_url": "https://example.com/image.jpg",
          "label": "Taylor Swift",
          "release_date": "2024-10-03",
          "release_date_precision": "DAY",
          "track_count": 7
        }
      ]
    },
    "top_tracks": {
      "count": 10,
      "total_count": null,
      "items": [
        {
          "url": "https://open.spotify.com/track/53iuhJlwXhSER5J2IYYv1W",
          "track_id": "53iuhJlwXhSER5J2IYYv1W",
          "uri": "spotify:track:53iuhJlwXhSER5J2IYYv1W",
          "title": "The Fate of Ophelia",
          "artist_names": [
            "Taylor Swift"
          ],
          "duration_seconds": 226,
          "play_count": 1534362500,
          "explicit": false,
          "album_id": "4a6NzYL1YHRUgx9e3YZI6I",
          "album_uri": "spotify:album:4a6NzYL1YHRUgx9e3YZI6I",
          "album_url": "https://open.spotify.com/album/4a6NzYL1YHRUgx9e3YZI6I",
          "album_thumbnail_url": "https://example.com/image.jpg"
        },
        {
          "url": "https://open.spotify.com/track/5uPaqMMt59KGrdKIitDRqa",
          "track_id": "5uPaqMMt59KGrdKIitDRqa",
          "uri": "spotify:track:5uPaqMMt59KGrdKIitDRqa",
          "title": "I Knew It, I Knew You - From \"Toy Story 5\"",
          "artist_names": [
            "Taylor Swift"
          ],
          "duration_seconds": 178,
          "play_count": 114239294,
          "explicit": false,
          "album_id": "3ZLIShtR6Fjs4nTWFpBUB6",
          "album_uri": "spotify:album:3ZLIShtR6Fjs4nTWFpBUB6",
          "album_url": "https://open.spotify.com/album/3ZLIShtR6Fjs4nTWFpBUB6",
          "album_thumbnail_url": "https://example.com/image.jpg"
        },
        {
          "_more_items": 8
        }
      ]
    },
    "playlists": {
      "count": 4,
      "total_count": 4,
      "items": [
        {
          "url": "https://open.spotify.com/playlist/4GtQVhGjAwcHFz82UKy3Ca",
          "playlist_id": "4GtQVhGjAwcHFz82UKy3Ca",
          "uri": "spotify:playlist:4GtQVhGjAwcHFz82UKy3Ca",
          "title": "Taylor Swift Complete Collection",
          "thumbnail_url": "https://example.com/image.jpg",
          "description": "Everything Taylor Swift Right Here",
          "owner_name": "Taylor Swift"
        },
        {
          "url": "https://open.spotify.com/playlist/65uAjFTt4N8sEJeonhNOBL",
          "playlist_id": "65uAjFTt4N8sEJeonhNOBL",
          "uri": "spotify:playlist:65uAjFTt4N8sEJeonhNOBL",
          "title": "And, baby, that’s show business for you ❤️‍🔥",
          "thumbnail_url": "https://example.com/image.jpg",
          "description": null,
          "owner_name": "Taylor Swift"
        },
        {
          "_more_items": 2
        }
      ]
    },
    "related_artists": {
      "count": 20,
      "total_count": 40,
      "items": [
        {
          "url": "https://open.spotify.com/artist/74KM79TiuVKeVCqs8QtB0B",
          "artist_id": "74KM79TiuVKeVCqs8QtB0B",
          "uri": "spotify:artist:74KM79TiuVKeVCqs8QtB0B",
          "display_name": "Sabrina Carpenter",
          "thumbnail_url": "https://example.com/image.jpg"
        },
        {
          "url": "https://open.spotify.com/artist/66CXWjxzNUsdJxJ2JdwvnR",
          "artist_id": "66CXWjxzNUsdJxJ2JdwvnR",
          "uri": "spotify:artist:66CXWjxzNUsdJxJ2JdwvnR",
          "display_name": "Ariana Grande",
          "thumbnail_url": "https://example.com/image.jpg"
        },
        {
          "_more_items": 18
        }
      ]
    }
  }
}
Nächste Schritte

Setzen Sie die Bewertung fort

Nutzen Sie diese Dokumentation als ersten Entscheidungspunkt und prüfen Sie dann Preise, Plattformabdeckung und Integrationsregeln, bevor Sie den Endpunkt für die wiederkehrende Nutzung anbinden.

Öffnen Sie die Plattformseite Spotify

Vergleichen Sie verwandte Entitäten, Gruppen von API-Methoden und die zugehörige Dokumentation vor der Implementierung.

Plattformseite öffnen

Vergleichen Sie die Preise der API-Methoden

Prüfen Sie, wo diese Methode in der öffentlichen Preistabelle steht, bevor Sie die Nutzung skalieren.

Preise ansehen

Prüfen Sie die Integrationsregeln

Bestätigen Sie mit der Einstiegsdokumentation Authentifizierung, Versionen, Wiederholungen und die Unterschiede zwischen Test und Produktion.

Dokumentation öffnen
Häufige Fragen

Fragen, die Teams vor der Implementierung stellen

Nutzen Sie diese Antworten, um zu entscheiden, ob diese API-Methode zu Ihrem Ablauf, Ihrer Versionswahl und Ihrem Einführungsplan passt.

Welche Daten gibt diese Methode der Spotify-API zurück?

Die Methode führt „Informationen nach Nutzer-ID“ für Künstler aus. Das kompakte Antwortbeispiel unten zeigt die genaue Struktur der Felder.

Soll ich V1 oder V2 wählen?

Wählen Sie V2 für neue Integrationen, da sie eine normalisierte Struktur bietet. Verwenden Sie V1 nur zur Kompatibilität mit Clients, die bereits das native Format der Plattform verarbeiten.

Was brauche ich für die erste Anfrage?

Erstellen Sie einen API-Schlüssel, senden Sie ihn im Header der Anfrage und geben Sie die Pflichtparameter aus der Tabelle an. Die Codebeispiele enthalten bereits den korrekten Pfad und die richtige Anfragestruktur.