Skip to content
Ads API •References / 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: ids=3zaHNdVeLiqOSXwxdoWcij
  • q
    string

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

    Example: q=query
  • market
    string
    Required

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

    Minimum length: 2Example: market=US

Response

A list of podcasts.

    • id
      string
    • name
      string
      • width
        integer
      • url
        string
      • height
        integer

Response sample

{ "shows": [ { "id": "target-id", "name": "target-name", "images": [ { "width": 6, "url": "https://i.scdn.co/image/ab6765630000ba8a2e0748b75ab4b3bb0638dd74", "height": 2 } ] } ]}