Sanatçı
GET/v1/soundcloud/artist1 kredi
Bir SoundCloud sanatçısının herkese açık profilini döndürür: ad, biyografi, şehir ve ülke, avatar ve kapak görseli, doğrulama ve rozetler, takipçi, takip edilen, parça, çalma listesi ve beğeni sayıları.
01Sorgu parametreleri
| Ad | Tür | Açıklama |
|---|---|---|
| handleisteğe bağlı | string | SoundCloud profil adı, örneğin `kehlanimusic`. `handle` veya `url` parametrelerinden biri zorunludur. |
| urlisteğe bağlı | string | SoundCloud profil URL'si, örneğin `https://soundcloud.com/kehlanimusic`. `handle` veya `url` parametrelerinden biri zorunludur. |
02İstek
curl "https://api.scrapesocial.ai/v1/soundcloud/artist?handle=kehlanimusic" \ -H "x-api-key: $SCRAPESOCIAL_KEY"
03Yanıtlar
API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.
GET /v1/soundcloud/artist?handle=kehlanimusic
{
"success": true,
"credits_remaining": 4980,
"credits_charged": 1,
"avatar_url": "https://i1.sndcdn.com/avatars-4pU1zic9ZyyDdF4G-dF6LHA-large.jpg",
"city": "Oakland, CA",
"comments_count": 0,
"country_code": "US",
"created_at": null,
"creator_subscriptions": [
{
"product": {
"id": "free"
}
}
],
"creator_subscription": {
"product": {
"id": "free"
}
},
"description": "\"Folded\" out now!\n\nSinger/Songwriter \nOakland to Los Angeles\n\nMGMT:\[email protected]\[email protected]\n\nBOOKING:\nCaroline Yim\[email protected]",
"followers_count": 850478,
"followings_count": 0,
"first_name": "",
"full_name": "",
"groups_count": 0,
"id": 51562330,
"kind": "user",
"last_modified": "2026-06-13T00:00:02Z",
"last_name": "",
"likes_count": 11,
"playlist_likes_count": 2,
"permalink": "kehlanimusic",
"permalink_url": "https://soundcloud.com/kehlanimusic",
"playlist_count": 27,
"reposts_count": null,
"track_count": 341,
"uri": "https://api.soundcloud.com/users/soundcloud%3Ausers%3A51562330",
"urn": "soundcloud:users:51562330",
"username": "Kehlani",
"verified": true,
"visuals": {
"urn": "soundcloud:users:51562330",
"enabled": true,
"visuals": [
{
"urn": "soundcloud:visuals:243626019",
"entry_time": 0,
"visual_url": "https://i1.sndcdn.com/visuals-000051562330-BFF9AP-original.jpg"
}
],
"tracking": null
},
"badges": {
"pro": false,
"creator_mid_tier": false,
"pro_unlimited": false,
"verified": true
},
"station_urn": "soundcloud:system-playlists:artist-stations:51562330",
"station_permalink": "artist-stations:51562330",
"date_of_birth": 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
Profil alanları yanıtın en üst seviyesinde, zarf alanlarının yanında yer alır. Bilinmeyen bir sanatçı veya profil olmayan bir URL ücretsiz 404 döner; profil adı ya da soundcloud.com URL'si olmayan bir değer ücretsiz 400 döner.
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.