İçeriğe geç

Podcast

GET/v1/spotify/podcast1 kredi

Bir podcast programını döndürür: ad, yayıncı, açıklama, kapak görseli, puan, konular, içerik türü ve son bölümler.

01Sorgu parametreleri

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

02İstek

curl "https://api.scrapesocial.ai/v1/spotify/podcast?id=4rOoJ6Egrf8K2IrywzwOMk" \
  -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/podcast?id=4rOoJ6Egrf8K2IrywzwOMk

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "id": "4rOoJ6Egrf8K2IrywzwOMk",
  "uri": "spotify:show:4rOoJ6Egrf8K2IrywzwOMk",
  "__typename": "Podcast",
  "accessInfo": null,
  "consumptionOrderV2": "EPISODIC",
  "contentCapabilityTrait": null,
  "contentRatingV2": {
    "labels": [
      "EXPLICIT"
    ]
  },
  "contentType": "CONTENT_TYPE_PODCAST",
  "coverArt": {
    "sources": [
      {
        "height": 64,
        "url": "https://i.scdn.co/image/ab6765630000f68de7c95712f4940a9bf439467e",
        "width": 64
      },
      {
        "height": 300,
        "url": "https://i.scdn.co/image/ab67656300005f1fe7c95712f4940a9bf439467e",
        "width": 300
      }
    ]
  },
  "description": "The official podcast of comedian Joe Rogan.",
  "episodesV2": [
    {
      "entity": {
        "__typename": "EpisodeResponseWrapper",
        "data": {
          "__typename": "Episode",
          "creator": null,
          "uri": "spotify:episode:2rKMiQw2A58GL5ZHH8jfHo"
        }
      }
    }
  ],
  "gatedEntityRelations": [],
  "htmlDescription": "<p>The official podcast of comedian Joe Rogan.</p>",
  "mediaType": "MIXED",
  "musicAndTalk": null,
  "name": "The Joe Rogan Experience",
  "playability": {
    "playable": true,
    "reason": "PLAYABLE",
    "unplayabilityReasons": []
  },
  "publisher": {
    "name": "Joe Rogan"
  },
  "rating": {
    "averageRating": {
      "average": 4.651332357523213,
      "showAverage": true,
      "totalRatings": 955787
    },
    "canRate": true,
    "rating": {
      "rating": 0
    }
  },
  "saved": false,
  "sharingInfo": {
    "shareId": "Z-yk1zpiRgyajQTAX_vVgw",
    "shareUrl": "https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk?si=Z-yk1zpiRgyajQTAX_vVgw"
  },
  "showTypes": [
    "SHOW_TYPE_EXCLUSIVE"
  ],
  "topics": [
    {
      "__typename": "PodcastTopic",
      "title": "Comedy",
      "uri": "spotify:genre:0JQ5DAqbMKFNr6gDrHHVKL"
    }
  ],
  "trailerV2": null,
  "visualIdentity": {
    "sixteenByNineCoverImage": null,
    "squareCoverImage": {
      "__typename": "VisualIdentityImage",
      "extractedColorSet": {
        "encoreBaseSetTextColor": {
          "alpha": 255,
          "blue": 91,
          "green": 166,
          "red": 255
        },
        "highContrast": {
          "backgroundBase": {
            "alpha": 255,
            "blue": 0,
            "green": 58,
            "red": 137
          },
          "backgroundTintedBase": {
            "alpha": 255,
            "blue": 0,
            "green": 23,
            "red": 93
          },
          "textBase": {
            "alpha": 255,
            "blue": 255,
            "green": 255,
            "red": 255
          },
          "textBrightAccent": {
            "alpha": 255,
            "blue": 255,
            "green": 255,
            "red": 255
          },
          "textSubdued": {
            "alpha": 255,
            "blue": 146,
            "green": 192,
            "red": 255
          }
        },
        "higherContrast": {
          "backgroundBase": {
            "alpha": 255,
            "blue": 0,
            "green": 25,
            "red": 96
          },
          "backgroundTintedBase": {
            "alpha": 255,
            "blue": 40,
            "green": 63,
            "red": 137
          },
          "textBase": {
            "alpha": 255,
            "blue": 255,
            "green": 255,
            "red": 255
          },
          "textBrightAccent": {
            "alpha": 255,
            "blue": 96,
            "green": 215,
            "red": 30
          },
          "textSubdued": {
            "alpha": 255,
            "blue": 146,
            "green": 192,
            "red": 255
          }
        },
        "minContrast": {
          "backgroundBase": {
            "alpha": 255,
            "blue": 12,
            "green": 122,
            "red": 233
          },
          "backgroundTintedBase": {
            "alpha": 255,
            "blue": 0,
            "green": 96,
            "red": 204
          },
          "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
          }
        }
      }
    }
  },
  "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

`contentCapabilityTrait`, `musicAndTalk` ve `popularity` her zaman null döner. Bölümlerin tam listesi için podcast bölümleri endpoint'ini kullanın. Bulunamayan bir program ü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.