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

# List podcast shows

> [OpenAPI JSON Spec](/docs/output/v1_other_podcast_shows_get.json)
The curated shows we follow, with how much of each one is held.
`name` is the same value `/podcast/transcripts` accepts as `podcast`,
so this endpoint answers "what can I ask for" before asking.
`episode_count` counts what has been discovered, bounded by the
publication window the ingestion lane runs with (a year by default),
so it is not the show's lifetime output. `transcript_count` is how
many of those have text; the gap is episodes whose publisher shipped
no transcript.
Every filter is optional — the list is curated and a few hundred rows.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/other/podcast/shows
openapi: 3.0.0
info:
  contact: {}
  description: >-
    Welcome to Arrays!


    Arrays is a unified financial data layer for both financial institutions and
    retail users, delivering comprehensive market data across crypto and equity
    markets. Our datasets cover fundamentals, ETFs, options, crypto, and more.


    Visit [arrays.org](https://arrays.org) to request an API key and start your
    free trial. You can explore our full API offerings in the documentation
    below.


    For any questions regarding APIs or pricing, please contact
    support@arrays.org.
  title: Arrays API
  version: '1.0'
servers:
  - url: https://data-tools.prd.arrays.org/api
security: []
paths:
  /v1/other/podcast/shows:
    get:
      tags:
        - Other
      summary: List podcast shows
      description: |-
        [OpenAPI JSON Spec](/docs/output/v1_other_podcast_shows_get.json)
        The curated shows we follow, with how much of each one is held.
        `name` is the same value `/podcast/transcripts` accepts as `podcast`,
        so this endpoint answers "what can I ask for" before asking.
        `episode_count` counts what has been discovered, bounded by the
        publication window the ingestion lane runs with (a year by default),
        so it is not the show's lifetime output. `transcript_count` is how
        many of those have text; the gap is episodes whose publisher shipped
        no transcript.
        Every filter is optional — the list is curated and a few hundred rows.
      parameters:
        - description: Show name, case-insensitive exact match
          in: query
          name: name
          schema:
            type: string
        - description: Only shows eligible for paid transcription
          in: query
          name: monitoring_pool_only
          schema:
            type: boolean
        - description: Max rows, 1-200 (default 10)
          in: query
          name: limit
          schema:
            type: integer
        - description: Rows to skip (default 0)
          in: query
          name: offset
          schema:
            type: integer
      responses:
        '200':
          description: Shows
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/model.APIResponse'
                  - properties:
                      data:
                        items:
                          $ref: '#/components/schemas/model.PodcastShow'
                        type: array
                    type: object
        '400':
          description: Invalid parameters
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/model.APIResponse'
                  - properties:
                      error:
                        $ref: '#/components/schemas/model.APIError'
                    type: object
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/model.APIResponse'
                  - properties:
                      error:
                        $ref: '#/components/schemas/model.APIError'
                    type: object
      security:
        - ApiKeyAuth: []
components:
  schemas:
    model.APIResponse:
      properties:
        data: {}
        error:
          $ref: '#/components/schemas/model.APIError'
        metadata: {}
        pagination: {}
        request_id:
          type: string
        success:
          type: boolean
      type: object
    model.PodcastShow:
      properties:
        episode_count:
          description: >-
            EpisodeCount is what has been discovered, bounded by the publication

            window the lane is configured with — by default the last year, so
            this is

            not the show's lifetime output.
          type: integer
        feed_url:
          type: string
        language:
          type: string
        last_scanned_at:
          description: LastScannedAt is when the feed was last read, empty if never.
          type: string
        latest_episode_date:
          description: >-
            LatestEpisodeDate is YYYY-MM-DD, empty when nothing has been
            discovered.
          type: string
        monitoring_pool:
          description: |-
            MonitoringPool marks a show eligible for paid transcription when the
            publisher ships no transcript of their own.
          type: boolean
        name:
          description: Name is what the transcripts endpoint accepts as `podcast`.
          type: string
        publisher:
          type: string
        tier:
          type: string
        transcript_count:
          description: >-
            TranscriptCount is how many of those have text. The gap between the
            two

            is episodes whose publisher shipped no transcript and which were not

            transcribed.
          type: integer
      type: object
    model.APIError:
      properties:
        code:
          example: RESOURCE_NOT_FOUND
          type: string
        details:
          items:
            $ref: '#/components/schemas/model.APIErrorDetail'
          type: array
        docs_url:
          type: string
        examples:
          items:
            type: string
          type: array
        hint:
          type: string
        message:
          example: The requested resource was not found.
          type: string
        suggestions:
          items:
            type: string
          type: array
      type: object
    model.APIErrorDetail:
      properties:
        field:
          type: string
        got:
          type: string
        reason:
          type: string
      type: object
  securitySchemes:
    ApiKeyAuth:
      description: 'API Key authentication. Example: "your-api-key-here"'
      in: header
      name: X-API-Key
      type: apiKey

````