İçeriğe geç

Albüm

GET/v1/spotify/album1 kredi

Bir albümü döndürür: ad, plak şirketi, çıkış tarihi, telif bilgisi, kapak görseli, sanatçılar, diskler ve şarkı listesinin tamamı; ayrıca sanatçının diğer albümleri.

01Sorgu parametreleri

AdTürAçıklama
idisteğe bağlıstringSpotify albüm kimliği, örneğin `6dVIqQ8qmQ5GBnJ9shOYGE`. `id` ya da `url` parametrelerinden biri zorunludur; ikisi birden verilirse `id` kullanılır.
urlisteğe bağlıstringopen.spotify.com albüm URL'si. `id` ya da `url` parametrelerinden biri zorunludur.

02İstek

curl "https://api.scrapesocial.ai/v1/spotify/album?url=https%3A%2F%2Fopen.spotify.com%2Falbum%2F6dVIqQ8qmQ5GBnJ9shOYGE" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Yanıtlar

API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.

GET /v1/spotify/album?url=https%3A%2F%2Fopen.spotify.com%2Falbum%2F6dVIqQ8qmQ5GBnJ9shOYGE

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "id": "6dVIqQ8qmQ5GBnJ9shOYGE",
  "uri": "spotify:album:6dVIqQ8qmQ5GBnJ9shOYGE",
  "__typename": "Album",
  "copyright": [
    {
      "text": "1997 XL Recordings Ltd",
      "type": "C"
    },
    {
      "text": "1997 XL Recordings Ltd",
      "type": "P"
    }
  ],
  "courtesyLine": "",
  "date": {
    "isoString": "1997-05-28T00:00:00Z",
    "precision": "DAY"
  },
  "isPreRelease": false,
  "label": "XL Recordings",
  "name": "OK Computer",
  "playability": {
    "playable": true,
    "reason": "PLAYABLE"
  },
  "preReleaseEndDateTime": null,
  "saved": false,
  "sharingInfo": {
    "shareId": "wtTg1m3QQHCsP79NfNXlkw",
    "shareUrl": "https://open.spotify.com/album/6dVIqQ8qmQ5GBnJ9shOYGE?si=wtTg1m3QQHCsP79NfNXlkw"
  },
  "tracksV2": [
    {
      "track": {
        "artists": [
          {
            "profile": {
              "name": "Radiohead"
            },
            "uri": "spotify:artist:4Z8W4fKeB5YxbusRsdQVPb"
          }
        ],
        "associationsV3": {
          "audioAssociations": {
            "totalCount": 0
          },
          "videoAssociations": {
            "totalCount": 0
          }
        },
        "contentRating": {
          "label": "NONE"
        },
        "discNumber": 1,
        "duration": {
          "totalMilliseconds": 287880
        },
        "mediaType": "AUDIO",
        "name": "Airbag",
        "playability": {
          "playable": true
        },
        "playcount": 107329916,
        "relinkingInformation": null,
        "saved": false,
        "trackNumber": 1,
        "uri": "spotify:track:7c378mlmubSu7NGkLFa4sN"
      },
      "uid": "a27ee133a088cd918441"
    },
    {
      "track": {
        "artists": [
          {
            "profile": {
              "name": "Radiohead"
            },
            "uri": "spotify:artist:4Z8W4fKeB5YxbusRsdQVPb"
          }
        ],
        "associationsV3": {
          "audioAssociations": {
            "totalCount": 0
          },
          "videoAssociations": {
            "totalCount": 1
          }
        },
        "contentRating": {
          "label": "NONE"
        },
        "discNumber": 1,
        "duration": {
          "totalMilliseconds": 387213
        },
        "mediaType": "AUDIO",
        "name": "Paranoid Android",
        "playability": {
          "playable": true
        },
        "playcount": 327883398,
        "relinkingInformation": null,
        "saved": false,
        "trackNumber": 2,
        "uri": "spotify:track:6LgJvl0Xdtc73RJ1mmpotq"
      },
      "uid": "9568fd544ad24f13dd15"
    }
  ],
  "type": "ALBUM",
  "visualIdentity": {
    "squareCoverImage": {
      "__typename": "VisualIdentityImage",
      "extractedColorSet": {
        "encoreBaseSetTextColor": {
          "alpha": 255,
          "blue": 216,
          "green": 192,
          "red": 152
        },
        "highContrast": {
          "backgroundBase": {
            "alpha": 255,
            "blue": 108,
            "green": 87,
            "red": 50
          },
          "backgroundTintedBase": {
            "alpha": 255,
            "blue": 73,
            "green": 54,
            "red": 15
          },
          "textBase": {
            "alpha": 255,
            "blue": 255,
            "green": 255,
            "red": 255
          },
          "textBrightAccent": {
            "alpha": 255,
            "blue": 255,
            "green": 255,
            "red": 255
          },
          "textSubdued": {
            "alpha": 255,
            "blue": 236,
            "green": 211,
            "red": 170
          }
        },
        "higherContrast": {
          "backgroundBase": {
            "alpha": 255,
            "blue": 76,
            "green": 56,
            "red": 18
          },
          "backgroundTintedBase": {
            "alpha": 255,
            "blue": 111,
            "green": 90,
            "red": 53
          },
          "textBase": {
            "alpha": 255,
            "blue": 255,
            "green": 255,
            "red": 255
          },
          "textBrightAccent": {
            "alpha": 255,
            "blue": 96,
            "green": 215,
            "red": 30
          },
          "textSubdued": {
            "alpha": 255,
            "blue": 236,
            "green": 211,
            "red": 170
          }
        },
        "minContrast": {
          "backgroundBase": {
            "alpha": 255,
            "blue": 181,
            "green": 158,
            "red": 119
          },
          "backgroundTintedBase": {
            "alpha": 255,
            "blue": 156,
            "green": 133,
            "red": 95
          },
          "textBase": {
            "alpha": 255,
            "blue": 255,
            "green": 255,
            "red": 255
          },
          "textBrightAccent": {
            "alpha": 255,
            "blue": 255,
            "green": 255,
            "red": 255
          },
          "textSubdued": {
            "alpha": 255,
            "blue": 255,
            "green": 255,
            "red": 255
          }
        }
      }
    }
  },
  "watchFeedEntrypoint": null,
  "artists": [
    {
      "id": "4Z8W4fKeB5YxbusRsdQVPb",
      "profile": {
        "name": "Radiohead"
      },
      "sharingInfo": {
        "shareUrl": "https://open.spotify.com/artist/4Z8W4fKeB5YxbusRsdQVPb?si=7SJckqW3SUWJgA6UEcHGpg"
      },
      "uri": "spotify:artist:4Z8W4fKeB5YxbusRsdQVPb",
      "visuals": {
        "avatarImage": {
          "sources": [
            {
              "height": 640,
              "url": "https://i.scdn.co/image/ab6761610000e5eb959527d2fabc9c64287e57b9",
              "width": 640
            },
            {
              "height": 160,
              "url": "https://i.scdn.co/image/ab6761610000f178959527d2fabc9c64287e57b9",
              "width": 160
            }
          ]
        }
      }
    }
  ],
  "coverArt": {
    "extractedColors": {
      "colorDark": {
        "hex": "#607B8B"
      },
      "colorLight": {
        "hex": "#90B8D0"
      },
      "colorRaw": {
        "hex": "#90B8D0"
      }
    },
    "sources": [
      {
        "height": 300,
        "url": "https://i.scdn.co/image/ab67616d00001e02c8b444df094279e70d0ed856",
        "width": 300
      },
      {
        "height": 64,
        "url": "https://i.scdn.co/image/ab67616d00004851c8b444df094279e70d0ed856",
        "width": 64
      }
    ]
  },
  "discs": [
    {
      "number": 1,
      "tracks": {
        "totalCount": 12
      }
    }
  ],
  "releases": [],
  "moreAlbumsByArtist": [
    {
      "discography": {
        "popularReleasesAlbums": [
          {
            "coverArt": {
              "sources": [
                {
                  "height": 300,
                  "url": "https://i.scdn.co/image/ab67616d00001e02c8b444df094279e70d0ed856",
                  "width": 300
                },
                {
                  "height": 64,
                  "url": "https://i.scdn.co/image/ab67616d00004851c8b444df094279e70d0ed856",
                  "width": 64
                }
              ]
            },
            "date": {
              "year": 1997
            },
            "id": "6dVIqQ8qmQ5GBnJ9shOYGE",
            "name": "OK Computer",
            "playability": {
              "playable": true,
              "reason": "PLAYABLE"
            },
            "sharingInfo": {
              "shareId": "INb9CG6xQJSH7LNW5IAljg",
              "shareUrl": "https://open.spotify.com/album/6dVIqQ8qmQ5GBnJ9shOYGE?si=INb9CG6xQJSH7LNW5IAljg"
            },
            "type": "ALBUM",
            "uri": "spotify:album:6dVIqQ8qmQ5GBnJ9shOYGE"
          },
          {
            "coverArt": {
              "sources": [
                {
                  "height": 300,
                  "url": "https://i.scdn.co/image/ab67616d00001e02ec548c00d3ac2f10be73366d",
                  "width": 300
                },
                {
                  "height": 64,
                  "url": "https://i.scdn.co/image/ab67616d00004851ec548c00d3ac2f10be73366d",
                  "width": 64
                }
              ]
            },
            "date": {
              "year": 1993
            },
            "id": "3gBVdu4a1MMJVMy6vwPEb8",
            "name": "Pablo Honey",
            "playability": {
              "playable": true,
              "reason": "PLAYABLE"
            },
            "sharingInfo": {
              "shareId": "u3sKr4yPQ9GI8IDYQ3C_wA",
              "shareUrl": "https://open.spotify.com/album/3gBVdu4a1MMJVMy6vwPEb8?si=u3sKr4yPQ9GI8IDYQ3C_wA"
            },
            "type": "ALBUM",
            "uri": "spotify:album:3gBVdu4a1MMJVMy6vwPEb8"
          }
        ]
      }
    }
  ],
  "popularity": null
}

Tüm uç noktalarda ortak

Her rota bunları döndürebilir: eksik ya da hatalı anahtar, biten kredi, yanıt vermeyen platform ya da bizim tarafımızdaki bir hata. Hiçbiri kredi harcamaz.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notlar

Tüm şarkılar (300'e kadar) tek yanıtta `tracksV2` içinde gelir; sayfalama yoktur. `popularity` her zaman null döner. Bulunamayan bir albüm ücretsiz bir 404 döndürür.

05Hatalar ve krediler

Her hatada success: false ve gerçek bir HTTP durum kodu döner; kredi düşmez.

  • 400missing_parameter

    Zorunlu bir parametre eksik veya geçersiz.

  • 403private_account

    Hesap gizli ya da yaş kısıtlamalı.

  • 404not_found

    Böyle bir hesap yok.

  • 503upstream_error

    Platform şu an cevap vermiyor; tekrar deneyin.