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        }      ]    }  ]}