此端点可以帮助您
响应以规范化的 V2 格式或平台原生的 V1 格式提供可用的艺人字段。
何时使用
当对象已知、您的产品需要其当前公开上下文时,请使用“按用户 ID 获取信息”。
先查看结果和常见工作流,然后再了解参数和可运行的请求示例。
响应以规范化的 V2 格式或平台原生的 V1 格式提供可用的艺人字段。
当对象已知、您的产品需要其当前公开上下文时,请使用“按用户 ID 获取信息”。
将公开的 Spotify 字段附加到已知的产品对象上。
在后续处理之前验证标识符和当前的公开上下文。
将对象详情用作报告、评分和相关请求的输入。
两个版本完成相同的任务,接受相同的参数。使用切换按钮比较响应结构,并选择您的客户端所需的版本。
在本页面切换版本,即可在同一文档 URL 下比较响应结构。
V1 和 V2 的身份验证、必填参数和请求结构均相同。实际上,您只需在构建端点路径和解析响应时选择版本。
主要区别在于响应结构。新集成请使用 V2;仅在需要兼容现有客户端契约时保留 V1。
两个版本使用相同的 API 密钥请求头和相同的查询参数。本文档先展示共享的参数集合,然后展示各版本特定的端点路径和代码片段。
| 参数 | 必填 | 类型 | 示例 | 说明 |
|---|---|---|---|---|
user_id |
是 | str |
06HL4z0CvFAxyc27GXpf02 |
所选平台上的数字用户 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=06HL4z0CvFAxyc27GXpf02'
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": "06HL4z0CvFAxyc27GXpf02",
}
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: "06HL4z0CvFAxyc27GXpf02",
});
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: "06HL4z0CvFAxyc27GXpf02",
};
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" => "06HL4z0CvFAxyc27GXpf02",
];
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", "06HL4z0CvFAxyc27GXpf02")
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=06HL4z0CvFAxyc27GXpf02'
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": "06HL4z0CvFAxyc27GXpf02",
}
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: "06HL4z0CvFAxyc27GXpf02",
});
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: "06HL4z0CvFAxyc27GXpf02",
};
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" => "06HL4z0CvFAxyc27GXpf02",
];
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", "06HL4z0CvFAxyc27GXpf02")
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 方法是否适合您的工作流、版本选择和上线计划。
该方法针对艺人执行“按用户 ID 获取信息”操作。下方的简明响应示例展示了确切的字段结构。
新集成请选择 V2,因为它提供规范化的结构。仅在兼容已使用平台原生格式的客户端时使用 V1。
创建 API 密钥,在请求头中发送它,并提供表格中的必填参数。代码示例中已包含正确的路径和请求结构。