Skip to content
Ads APIReferences / podcast-shows / Get Podcast Shows

Get Podcast Shows

Returns podcast information based on given query parameter.

Request

  • ids
    array of strings

    A list of unique identifiers for podcast shows.

    Example value: ["3zaHNdVeLiqOSXwxdoWcij"]
  • q
    string

    Query to search by keyword via case-insensitive wildcard matching.

    Example value: "queen"
  • market
    string
    Required

    An ISO 3166-1 alpha-2 country code. Only content that is available in that market will be returned.

    Example value: "US"Minimum length: 2

Response

A list of podcasts.

    • id
      string
    • name
      string

Response sample

{  "shows": [    {      "id": "4CfjBMktmGyX0AZYV2O10M",      "name": "anything goes with emma chamberlain",      "images": [        {          "width": 6,          "url": "https://i.scdn.co/image/ab6765630000ba8a2e0748b75ab4b3bb0638dd74",          "height": 2        }      ]    },    {      "id": "4CfjBMktmGyX0AZYV2O10M",      "name": "anything goes with emma chamberlain",      "images": [        {          "width": 6,          "url": "https://i.scdn.co/image/ab6765630000ba8a2e0748b75ab4b3bb0638dd74",          "height": 2        }      ]    }  ]}