Spotify API ドキュメント

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

オブジェクトのカード、検証、エンリッチメントのために、既知の識別子で Spotify の アーティスト の詳細な公開データを取得します。

オブジェクトが既にわかっていて、製品でその現在の公開コンテキストが必要な場合に「ユーザー ID による情報」を使用します。

メソッド GET
エンティティ アーティスト
バージョン 2
このエンドポイントの機能

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

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

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

レスポンスは、利用可能な アーティスト のフィールドを、正規化された V2 形式またはプラットフォーム固有の V1 形式で提供します。

使用に適した場面

オブジェクトが既にわかっていて、製品でその現在の公開コンテキストが必要な場合に「ユーザー ID による情報」を使用します。

主なユースケース

レコードのエンリッチメント

製品の既知のオブジェクトを Spotify の公開フィールドで補完します。

データの検証

後続の処理の前に、識別子と現在の公開コンテキストを確認します。

分析の準備

オブジェクトの詳細をレポート、評価、関連リクエストの入力として使用します。

利用できるバージョン

レスポンスのバージョン

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

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

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

共通する点

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

バージョン間で異なる点

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

使い方

メソッドの呼び出し方

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

入力パラメーター

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

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

V2

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

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

正規化された形式

コード例

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'
レスポンス例

バージョン別のライブレスポンス

プレビューには主要なフィールドとコレクションの最初の要素が含まれているため、レスポンスの形をすばやく確認できます。バージョンを切り替えると 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"
    },
    "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
        }
      ]
    }
  }
}
次のステップ

評価を続ける

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

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

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

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

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

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

料金を見る

連携ルールを確認する

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

ドキュメントを開く
よくある質問

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

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

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

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

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

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

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

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