Получайте подробные публичные данные по сущности «Артист» из Spotify по известному идентификатору для карточек, проверки и обогащения.
Операция «Сведения по ID пользователя» подходит, когда объект уже найден и продукту нужен его актуальный публичный контекст.
Сначала оцените результат и сценарии применения, затем переходите к параметрам и рабочему примеру запроса.
Ответ содержит доступные поля объекта «Артист» в нормализованной V2 или исходной V1 структуре.
Операция «Сведения по ID пользователя» подходит, когда объект уже найден и продукту нужен его актуальный публичный контекст.
Добавляйте публичные поля Spotify к уже известным объектам продукта.
Сверяйте идентификаторы и актуальный публичный контекст перед дальнейшей обработкой.
Используйте детали объекта как основу для отчётов, скоринга и связанных запросов.
Обе версии решают одну и ту же задачу и принимают одинаковые параметры. Переключатель нужен, чтобы сравнить структуру ответа и выбрать версию, которую ожидает ваш клиент.
Переключайте версии на этой странице, чтобы сравнивать структуру ответа без смены URL инструкции.
Аутентификация, обязательные параметры и форма запроса одинаковы для V1 и V2. Версия задаётся в пути запроса и определяет структуру ответа.
Главное отличие — envelope ответа. Для новых интеграций лучше использовать V2, а V1 оставлять только для совместимости с уже существующей клиентской интеграцией.
Для обеих версий используется один заголовок API-ключа и одинаковые параметры строки запроса. Ниже сначала показаны общие параметры, затем путь и примеры кода для выбранной версии.
| Параметр | Обязателен | Тип | Пример | Описание |
|---|---|---|---|---|
user_id |
Да | str |
value |
Числовой ID пользователя на выбранной платформе. |
Версию имеет смысл выбирать, когда вы копируете точный путь эндпоинта, пример URL и фрагмент кода. Список параметров выше при этом остается тем же самым.
GET /api/v2/spotify.com/artist/info-by-user-idcurl --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=value'from urllib.parse import urljoin
import requests
BASE_URL = "https://www.scrapestorm.net"
ENDPOINT = "/api/v2/spotify.com/artist/info-by-user-id"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}
params = {
"user_id": "value",
}
with requests.Session() as session:
response = session.request(
method="GET",
url=urljoin(BASE_URL, ENDPOINT),
headers=HEADERS,
params=params,
timeout=30,
)
response.raise_for_status()
payload = response.json()
print(payload)const BASE_URL = "https://www.scrapestorm.net";
const endpoint = "/api/v2/spotify.com/artist/info-by-user-id";
const params = new URLSearchParams({
user_id: "value",
});
const response = await fetch(`${BASE_URL}${endpoint}?${params.toString()}`, {
method: "GET",
headers: {
Accept: "application/json",
"X-API-Key": "00000000-0000-4000-8000-000000000000",
},
});
if (!response.ok) {
throw new Error(`Request failed: ${response.status} ${response.statusText}`);
}
const payload = await response.json();
console.log(payload);import axios from "axios";
const client = axios.create({
baseURL: "https://www.scrapestorm.net",
timeout: 30000,
headers: {
Accept: "application/json",
"X-API-Key": "00000000-0000-4000-8000-000000000000",
},
});
const params = {
user_id: "value",
};
const { data: payload } = await client.request({
method: "GET",
url: endpoint,
params,
});
console.log(payload);<?php
declare(strict_types=1);
use GuzzleHttp\Client;
use GuzzleHttp\Exception\GuzzleException;
$client = new Client([
'base_uri' => "https://www.scrapestorm.net",
'timeout' => 30.0,
'headers' => [
'Accept' => 'application/json',
'X-API-Key' => "00000000-0000-4000-8000-000000000000",
],
]);
$query = [
"user_id" => "value",
];
try {
$response = $client->request("GET", "/api/v2/spotify.com/artist/info-by-user-id", [
'query' => $query,
]);
$payload = json_decode(
(string) $response->getBody(),
true,
512,
JSON_THROW_ON_ERROR
);
var_dump($payload);
} catch (GuzzleException $e) {
throw $e;
}package main
import (
"encoding/json"
"fmt"
"net/http"
"net/url"
"time"
)
func main() {
baseURL := "https://www.scrapestorm.net"
endpoint := "/api/v2/spotify.com/artist/info-by-user-id"
params := url.Values{}
params.Set("user_id", "value")
req, err := http.NewRequest(
"GET",
fmt.Sprintf("%s%s?%s", baseURL, endpoint, params.Encode()),
nil,
)
if err != nil {
panic(err)
}
req.Header.Set("Accept", "application/json")
req.Header.Set("X-API-Key", "00000000-0000-4000-8000-000000000000")
client := &http.Client{Timeout: 30 * time.Second}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
var payload any
if err := json.NewDecoder(resp.Body).Decode(&payload); err != nil {
panic(err)
}
fmt.Printf("%+v\n", payload)
}Версию имеет смысл выбирать, когда вы копируете точный путь эндпоинта, пример URL и фрагмент кода. Список параметров выше при этом остается тем же самым.
GET /api/v1/spotify.com/artist/info-by-user-idcurl --request GET \
--url "https://www.scrapestorm.net/api/v1/spotify.com/artist/info-by-user-id" \
--header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
--get --data-urlencode 'user_id=value'from urllib.parse import urljoin
import requests
BASE_URL = "https://www.scrapestorm.net"
ENDPOINT = "/api/v1/spotify.com/artist/info-by-user-id"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}
params = {
"user_id": "value",
}
with requests.Session() as session:
response = session.request(
method="GET",
url=urljoin(BASE_URL, ENDPOINT),
headers=HEADERS,
params=params,
timeout=30,
)
response.raise_for_status()
payload = response.json()
print(payload)const BASE_URL = "https://www.scrapestorm.net";
const endpoint = "/api/v1/spotify.com/artist/info-by-user-id";
const params = new URLSearchParams({
user_id: "value",
});
const response = await fetch(`${BASE_URL}${endpoint}?${params.toString()}`, {
method: "GET",
headers: {
Accept: "application/json",
"X-API-Key": "00000000-0000-4000-8000-000000000000",
},
});
if (!response.ok) {
throw new Error(`Request failed: ${response.status} ${response.statusText}`);
}
const payload = await response.json();
console.log(payload);import axios from "axios";
const client = axios.create({
baseURL: "https://www.scrapestorm.net",
timeout: 30000,
headers: {
Accept: "application/json",
"X-API-Key": "00000000-0000-4000-8000-000000000000",
},
});
const params = {
user_id: "value",
};
const { data: payload } = await client.request({
method: "GET",
url: endpoint,
params,
});
console.log(payload);<?php
declare(strict_types=1);
use GuzzleHttp\Client;
use GuzzleHttp\Exception\GuzzleException;
$client = new Client([
'base_uri' => "https://www.scrapestorm.net",
'timeout' => 30.0,
'headers' => [
'Accept' => 'application/json',
'X-API-Key' => "00000000-0000-4000-8000-000000000000",
],
]);
$query = [
"user_id" => "value",
];
try {
$response = $client->request("GET", "/api/v1/spotify.com/artist/info-by-user-id", [
'query' => $query,
]);
$payload = json_decode(
(string) $response->getBody(),
true,
512,
JSON_THROW_ON_ERROR
);
var_dump($payload);
} catch (GuzzleException $e) {
throw $e;
}package main
import (
"encoding/json"
"fmt"
"net/http"
"net/url"
"time"
)
func main() {
baseURL := "https://www.scrapestorm.net"
endpoint := "/api/v1/spotify.com/artist/info-by-user-id"
params := url.Values{}
params.Set("user_id", "value")
req, err := http.NewRequest(
"GET",
fmt.Sprintf("%s%s?%s", baseURL, endpoint, params.Encode()),
nil,
)
if err != nil {
panic(err)
}
req.Header.Set("Accept", "application/json")
req.Header.Set("X-API-Key", "00000000-0000-4000-8000-000000000000")
client := &http.Client{Timeout: 30 * time.Second}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
var payload any
if err := json.NewDecoder(resp.Body).Decode(&payload); err != nil {
panic(err)
}
fmt.Printf("%+v\n", payload)
}Пример сокращён до ключевых полей и первых элементов коллекций, чтобы структуру ответа можно было быстро оценить. Переключатель версии меняет формат JSON.
Компактный JSON-пример сформирован из последней успешной проверки версии 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
}
]
}
}
}Компактный JSON-пример сформирован из последней успешной проверки версии V1.
{
"success": true,
"status": "ok",
"search_context": {
"user_id": "06HL4z0CvFAxyc27GXpf02"
},
"data": {
"data": {
"artistUnion": {
"__typename": "Artist",
"discography": {
"albums": {
"items": [
"…",
"…",
{
"_more_items": 8
}
],
"totalCount": 33
},
"compilations": {
"items": [
"…"
],
"totalCount": 1
},
"latest": {
"copyright": {
"items": "…"
},
"coverArt": {
"sources": "…"
},
"date": {
"day": 12,
"month": 6,
"precision": "DAY",
"year": 2026
},
"id": "4Ii9whWXI1O1H01ziECRaG",
"label": "Walt Disney Records / Pixar",
"name": "I Knew It, I Knew You (From \"Toy Story 5\")",
"playability": {
"playable": true,
"reason": "PLAYABLE"
},
"sharingInfo": {
"shareId": "kiTZz2NYTt2yJ4RHZ4emAQ",
"shareUrl": "https://open.spotify.com/album/4Ii9whWXI1O1H01ziECRaG?si=kiTZz2NYTt2yJ4RHZ4emAQ"
},
"tracks": {
"totalCount": 3
},
"type": "SINGLE",
"uri": "spotify:album:4Ii9whWXI1O1H01ziECRaG"
},
"popularReleasesAlbums": {
"items": [
"…",
"…",
{
"_more_items": 8
}
],
"totalCount": 20
},
"singles": {
"items": [
"…",
"…",
{
"_more_items": 8
}
],
"totalCount": 79
},
"topTracks": {
"items": [
"…",
"…",
{
"_more_items": 8
}
]
}
},
"goods": {
"events": {
"concerts": {
"items": "…",
"pagingInfo": "…",
"totalCount": 0
},
"userLocation": {
"name": "New York"
}
},
"merch": {
"items": []
}
},
"id": "06HL4z0CvFAxyc27GXpf02",
"preRelease": null,
"profile": {
"biography": {
"text": "And, baby, that’s show business for you. New album The Life of a Showgirl. Available now ❤️🔥",
"type": "AUTOBIOGRAPHY"
},
"externalLinks": {
"items": [
"…",
"…",
{
"_more_items": 1
}
]
},
"name": "Taylor Swift",
"pinnedItem": {
"backgroundImageV2": null,
"comment": "From Toy Story 5 ",
"itemV2": {
"__typename": "AlbumResponseWrapper",
"data": "…"
},
"subtitle": "Single • New Release",
"thumbnailImage": {
"data": "…"
},
"title": "I Knew It, I Knew You (From \"Toy Story 5\")",
"type": "ALBUM",
"uri": "spotify:album:3ZLIShtR6Fjs4nTWFpBUB6"
},
"playlistsV2": {
"items": [
"…",
"…",
{
"_more_items": 2
}
],
"totalCount": 4
},
"verified": true
},
"relatedContent": {
"appearsOn": {
"items": [
"…",
"…",
{
"_more_items": 18
}
],
"totalCount": 153
},
"discoveredOnV2": {
"items": [
"…",
"…",
{
"_more_items": 18
}
],
"totalCount": 100
},
"featuringV2": {
"items": [
"…",
"…",
{
"_more_items": 6
}
],
"totalCount": 8
},
"relatedArtists": {
"items": [
"…",
"…",
{
"_more_items": 18
}
],
"totalCount": 40
}
},
"relatedVideos": {
"__typename": "RelatedVideoPage",
"items": [],
"totalCount": 0
},
"saved": false,
"sharingInfo": {
"shareId": "1Ji0uWFFSxCOtlpvm9KVIA",
"shareUrl": "https://open.spotify.com/artist/06HL4z0CvFAxyc27GXpf02?si=1Ji0uWFFSxCOtlpvm9KVIA"
},
"stats": {
"followers": 161015282,
"monthlyListeners": 101231490,
"topCities": {
"items": [
"…",
"…",
{
"_more_items": 3
}
]
},
"worldRank": 7
},
"uri": "spotify:artist:06HL4z0CvFAxyc27GXpf02",
"visuals": {
"avatarImage": "https://example.com/image.jpg",
"gallery": {
"items": [
"…",
"…",
{
"_more_items": 16
}
]
},
"headerImage": {
"extractedColors": {
"colorRaw": "…"
},
"sources": [
"…"
]
}
},
"watchFeedEntrypoint": null
}
}
}
}Используйте инструкцию как первую точку принятия решения, а затем переходите к покрытию, стоимости и общим правилам интеграции перед запуском API-метода.
Эти ответы помогают понять, подходит ли API-метод под ваш сценарий, выбор версии и запуск.
Метод выполняет операцию «Сведения по ID пользователя» для сущности «Артист». Точный набор полей показан в компактном примере ответа ниже.
Для новой интеграции выбирайте V2 с нормализованной структурой. V1 нужен только для совместимости с клиентами, которые уже используют исходный формат платформы.
Создайте API-ключ, передайте его в заголовке и заполните обязательные параметры из таблицы. Готовые примеры кода уже содержат правильный путь и структуру запроса.