Spotify API: アーティスト — ユーザー ID による指標

Q: この Spotify API メソッドはどのようなデータを返しますか？

このメソッドは アーティスト に対して「ユーザー ID による指標」を実行します。以下のコンパクトなレスポンス例で、フィールドの正確な構造を確認できます。

このエンドポイントの機能

この API メソッドで構築できるもの

まず結果と一般的なワークフローを確認し、次にパラメーターと動作するリクエスト例に進んでください。

このエンドポイントが役立つこと

レスポンスは、選択した API 形式で、カウンターと主要な指標を含むすぐに使えるアーティストの概要を提供します。

使用に適した場面

指標のコンパクトなスナップショットが必要なダッシュボード、評価、定期レポートで「ユーザー ID による指標」を使用します。

主なユースケース

製品ダッシュボード

コレクション全体を読み込んで処理することなく、Spotify の主要な指標を表示します。

トレンドの監視

定期的なスナップショットを保存し、指標の推移を比較します。

オブジェクトの評価

集計指標をランキングや社内ルールの入力として使用します。

利用できるバージョン

レスポンスのバージョン

どちらのバージョンも同じタスクを解決し、同じパラメーターを受け付けます。切り替えを使ってレスポンス構造を比較し、クライアントが想定するバージョンを選んでください。

レスポンスのバージョン V2

このページでバージョンを切り替えると、同じドキュメント URL でレスポンス構造を比較できます。

V1 利用できません

共通する点

認証、必須パラメーター、リクエストの形は V1 と V2 で同じです。実際には、エンドポイントのパスを組み立てるときとレスポンスを読み取るときにバージョンを選びます。

バージョン間で異なる点

主な違いはレスポンスのエンベロープです。新しい連携では V2 を使用し、既存のクライアント契約との互換性が必要な場合にのみ V1 を残してください。

使い方

メソッドの呼び出し方

どちらのバージョンでも、同じ API キーのヘッダーと同じクエリパラメーターを使用します。このドキュメントでは、まず共通のパラメーターを示し、次に各バージョンのパスとコードスニペットを示します。

入力パラメーター

共通パラメーター

パラメーター	必須	型	例	説明
`user_id`	はい	`str`	`06HL4z0CvFAxyc27GXpf02`	選択したプラットフォームにおけるユーザーの数値 ID。

バージョン別のリクエストパス

V2

エンドポイントの正確なパス、URL の例、コードスニペットをコピーするときにバージョンを選んでください。上のパラメーター一覧は変わりません。

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

正規化された形式

リクエストのプレビュー

ベース URL https://www.scrapestorm.net

エンドポイント /api/v2/spotify.com/artist/metrics-by-user-id

必須パラメーター

user_id

任意のパラメーター

なし

URL の例

https://www.scrapestorm.net/api/v2/spotify.com/artist/metrics-by-user-id?user_id=06HL4z0CvFAxyc27GXpf02

コード例

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/spotify.com/artist/metrics-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/metrics-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/metrics-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/metrics-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/metrics-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 の形式が変わります。

レスポンス例

V2 レスポンスの 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"
    },
    "analytics": {
      "all_items": {
        "follower_count": 161015282,
        "monthly_listener_count": 101231490,
        "world_rank": 7,
        "is_merch": false,
        "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
          }
        ],
        "analyzed_tracks_count": 10,
        "tracks_with_play_count": 10,
        "total_plays": 18130343261,
        "average_plays_per_track": 1813034326.1,
        "median_plays_per_track": 1892238219.0,
        "min_plays": 114239294,
        "max_plays": 3425792011,
        "total_play_rate": 17909.786037,
        "_more_fields": "2 more fields"
      }
    },
    "feed": {
      "count": 10,
      "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
        }
      ]
    }
  }
}

アーティストで作業を続ける

関連するメソッドでは、同じオブジェクトを別の識別子で解決したり、詳細を開いたり、集計ビューに切り替えたりできます。

次のステップ

評価を続ける

このドキュメントを最初の判断材料とし、継続的な利用のためにエンドポイントを接続する前に、料金、プラットフォームのカバー範囲、連携ルールを確認してください。

Spotify のプラットフォームページを開く

実装の前に、関連するエンティティ、API メソッドのグループ、関連ドキュメントを比較してください。

プラットフォームページを開く

API メソッドの料金を比較する

利用を拡大する前に、公開料金表でこのメソッドの位置付けを確認してください。

料金を見る

連携ルールを確認する

入門ドキュメントで、認証、バージョン、再試行、テストと本番の違いを確認してください。

ドキュメントを開く

よくある質問

チームが実装前に尋ねる質問

これらの回答を参考に、この API メソッドがワークフロー、バージョンの選択、導入計画に合うかどうかを判断してください。

この Spotify API メソッドはどのようなデータを返しますか？

このメソッドはアーティストに対して「ユーザー ID による指標」を実行します。以下のコンパクトなレスポンス例で、フィールドの正確な構造を確認できます。

V1 と V2 のどちらを選ぶべきですか？

新しい連携では、正規化された構造を提供する V2 を選んでください。V1 は、既にプラットフォーム固有の形式を処理しているクライアントとの互換性のためにのみ使用してください。

最初のリクエストには何が必要ですか？

API キーを作成し、リクエストヘッダーで送信し、表の必須パラメーターを指定してください。コード例には、正しいパスとリクエスト構造が既に含まれています。