> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Podcast Shows

> Searches Spotify podcast shows available in a market, returning each show's id, name and cover art

Searches Spotify podcast shows available in a market, returning each show's id, name and cover art. Useful for researching podcast inventory before building podcast campaigns.

|                      |                                  |
| -------------------- | -------------------------------- |
| **App**              | Spotify Ads                      |
| **Operation ID**     | `spotify_ads_list_podcast_shows` |
| **Type**             | Action                           |
| **Connection**       | `spotify_ads` (required)         |
| **Credits per run**  | 1                                |
| **Agent / MCP tool** | Yes                              |

## Inputs

| Field    | Type                       | Required | Default | Description                                                                                                                           |
| -------- | -------------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| `market` | string or SelectableOption | Yes      | -       | Country to look up shows in, as an ISO alpha-2 code such as US or GB. Spotify requires it because podcast availability is per market. |
| `query`  | string                     | No       | -       | Keyword to search show names by, matched case-insensitively. Returns shows available in the market when omitted.                      |
| `ids`    | string or array of string  | No       | -       | Look up specific show ids instead of searching. Accepts a list or a comma-separated string.                                           |
| `limit`  | integer                    | No       | `100`   | Maximum number of shows to return. Default: 100.                                                                                      |

### SelectableOption

| Field   | Type   | Required | Default | Description |
| ------- | ------ | -------- | ------- | ----------- |
| `value` | string | Yes      | -       |             |
| `label` | string | Yes      | -       |             |

## Output

**Type**: `List[Dict]`

Returns matching podcast shows with id, name and images.

**Fields**: dynamic (depend on the inputs)