# Multiple Podcasts

> Pod Engine API endpoint reference, optimized for LLM consumption.
> Auto-generated from the source-of-truth endpoint registry.
>
> Category: Podcasts
> Source: https://www.podengine.ai/api-docs/get-multiple-podcasts.md
> Interactive HTML docs: https://www.podengine.ai/api-docs/get-multiple-podcasts
> Full API reference (all endpoints): https://www.podengine.ai/api-docs/llms.txt

**Base URL:** `http://localhost:4000`
**Auth:** Requires a Bearer token: `Authorization: Bearer YOUR_API_KEY`

---

#### GET /api/v1/podcasts/multiple
**Multiple Podcasts**

Get multiple podcasts by their IDs in a single request

```bash
curl -X GET "http://localhost:4000/api/v1/podcasts/multiple?podcastIds=58bb043a-ad45-4844-a6d8-7492d901dc30%2C7b09a744-f2ed-458e-9b04-0c0c48651c2a&details=basic" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

**Query schema:**
```json
{
  "type": "object",
  "properties": {
    "podcastIds": {
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid",
        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
      },
      "description": "Array of podcast IDs to fetch"
    },
    "details": {
      "default": "basic",
      "description": "Level of detail to return for each podcast",
      "type": "string",
      "enum": [
        "basic",
        "full"
      ]
    }
  },
  "required": [
    "podcastIds",
    "details"
  ],
  "additionalProperties": false
}
```

**Response schema:**
```json
{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "OK"
      ]
    },
    "data": {
      "type": "object",
      "properties": {
        "options": {
          "type": "object",
          "properties": {
            "podcastIds": {
              "minItems": 1,
              "maxItems": 50,
              "type": "array",
              "items": {
                "type": "string",
                "format": "uuid",
                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
              },
              "description": "Array of podcast IDs to fetch"
            },
            "details": {
              "default": "basic",
              "description": "Level of detail to return for each podcast",
              "type": "string",
              "enum": [
                "basic",
                "full"
              ]
            }
          },
          "required": [
            "podcastIds",
            "details"
          ],
          "additionalProperties": false
        },
        "totalRequested": {
          "type": "number"
        },
        "totalFound": {
          "type": "number"
        },
        "podcasts": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "author": {
                    "nullable": true,
                    "type": "string"
                  },
                  "authorityScore": {
                    "nullable": true,
                    "type": "object",
                    "properties": {
                      "calculatedAt": {},
                      "authorityScore": {
                        "type": "number",
                        "description": "This is the weighted total authority score of the podcast, out of 100"
                      },
                      "qualityScore": {
                        "type": "number",
                        "description": "This is the quality score of the podcast, out of 100"
                      },
                      "youtubeScore": {
                        "type": "number",
                        "description": "This is the YouTube score of the podcast, out of 100"
                      },
                      "socialScore": {
                        "type": "number",
                        "description": "This is the social score of the podcast, out of 100"
                      },
                      "engagementScore": {
                        "type": "number",
                        "description": "This is the engagement score of the podcast, out of 100"
                      }
                    },
                    "required": [
                      "calculatedAt",
                      "authorityScore",
                      "qualityScore",
                      "youtubeScore",
                      "socialScore",
                      "engagementScore"
                    ],
                    "additionalProperties": false
                  },
                  "genres": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "id": {
                    "type": "string"
                  },
                  "imageUrl": {
                    "nullable": true,
                    "type": "string"
                  },
                  "language": {
                    "type": "string"
                  },
                  "lastEpisodePublishedAt": {},
                  "slug": {
                    "type": "string"
                  },
                  "title": {
                    "type": "string"
                  },
                  "titleLatest": {
                    "type": "string"
                  }
                },
                "required": [
                  "author",
                  "authorityScore",
                  "genres",
                  "id",
                  "imageUrl",
                  "language",
                  "lastEpisodePublishedAt",
                  "slug",
                  "title",
                  "titleLatest"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "author": {
                    "nullable": true,
                    "type": "string"
                  },
                  "authorityScore": {
                    "nullable": true,
                    "type": "object",
                    "properties": {
                      "calculatedAt": {},
                      "authorityScore": {
                        "type": "number",
                        "description": "This is the weighted total authority score of the podcast, out of 100"
                      },
                      "qualityScore": {
                        "type": "number",
                        "description": "This is the quality score of the podcast, out of 100"
                      },
                      "youtubeScore": {
                        "type": "number",
                        "description": "This is the YouTube score of the podcast, out of 100"
                      },
                      "socialScore": {
                        "type": "number",
                        "description": "This is the social score of the podcast, out of 100"
                      },
                      "engagementScore": {
                        "type": "number",
                        "description": "This is the engagement score of the podcast, out of 100"
                      }
                    },
                    "required": [
                      "calculatedAt",
                      "authorityScore",
                      "qualityScore",
                      "youtubeScore",
                      "socialScore",
                      "engagementScore"
                    ],
                    "additionalProperties": false
                  },
                  "genres": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "id": {
                    "type": "string"
                  },
                  "imageUrl": {
                    "nullable": true,
                    "type": "string"
                  },
                  "language": {
                    "type": "string"
                  },
                  "lastEpisodePublishedAt": {},
                  "slug": {
                    "type": "string"
                  },
                  "title": {
                    "type": "string"
                  },
                  "titleLatest": {
                    "type": "string"
                  },
                  "appleId": {
                    "type": "number"
                  },
                  "blocked": {
                    "type": "object",
                    "properties": {
                      "blockedDate": {},
                      "blockedReason": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "blockedDate"
                    ],
                    "additionalProperties": false
                  },
                  "description": {
                    "nullable": true,
                    "type": "string"
                  },
                  "emails": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "explicitRss": {
                    "nullable": true,
                    "type": "boolean"
                  },
                  "hostNames": {
                    "nullable": true,
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "ignore": {
                    "type": "boolean"
                  },
                  "ignoreReason": {
                    "type": "string"
                  },
                  "neverTranscribe": {
                    "type": "boolean"
                  },
                  "neverTranscribeReason": {
                    "type": "string"
                  },
                  "isClaimed": {
                    "type": "boolean"
                  },
                  "podcastAffiliation": {
                    "nullable": true,
                    "type": "object",
                    "properties": {
                      "affiliateOrganizationName": {
                        "nullable": true,
                        "description": "The name of the affiliate organization",
                        "type": "string"
                      },
                      "affiliationType": {
                        "nullable": true,
                        "description": "The type of affiliation from the list: academic, branded, celebrity, government, independent, legacy media, podcast company, new media, not for profit, religious, other, unknown",
                        "type": "string",
                        "enum": [
                          "academic",
                          "branded",
                          "celebrity",
                          "government",
                          "independent",
                          "legacy media",
                          "podcast company",
                          "new media",
                          "not for profit",
                          "religious",
                          "other",
                          "unknown"
                        ]
                      }
                    },
                    "additionalProperties": false
                  },
                  "podcastDirectoryLinks": {
                    "type": "object",
                    "properties": {
                      "amazonmusic": {
                        "type": "string",
                        "format": "uri"
                      },
                      "anchor": {
                        "type": "string",
                        "format": "uri"
                      },
                      "antennapod": {
                        "type": "string",
                        "format": "uri"
                      },
                      "anytimeplayer": {
                        "type": "string",
                        "format": "uri"
                      },
                      "apollo": {
                        "type": "string",
                        "format": "uri"
                      },
                      "apple": {
                        "type": "string",
                        "format": "uri"
                      },
                      "audible": {
                        "type": "string",
                        "format": "uri"
                      },
                      "breez": {
                        "type": "string",
                        "format": "uri"
                      },
                      "castamatic": {
                        "type": "string",
                        "format": "uri"
                      },
                      "castbox": {
                        "type": "string",
                        "format": "uri"
                      },
                      "castro": {
                        "type": "string",
                        "format": "uri"
                      },
                      "curiocaster": {
                        "type": "string",
                        "format": "uri"
                      },
                      "fountain": {
                        "type": "string",
                        "format": "uri"
                      },
                      "goodpods": {
                        "type": "string",
                        "format": "uri"
                      },
                      "google": {
                        "type": "string",
                        "format": "uri"
                      },
                      "gpodder": {
                        "type": "string",
                        "format": "uri"
                      },
                      "iheartradio": {
                        "type": "string",
                        "format": "uri"
                      },
                      "listennotes": {
                        "type": "string",
                        "format": "uri"
                      },
                      "lnbeats": {
                        "type": "string",
                        "format": "uri"
                      },
                      "moonfm": {
                        "type": "string",
                        "format": "uri"
                      },
                      "overcast": {
                        "type": "string",
                        "format": "uri"
                      },
                      "playerfm": {
                        "type": "string",
                        "format": "uri"
                      },
                      "pocketcasts": {
                        "type": "string",
                        "format": "uri"
                      },
                      "podbean": {
                        "type": "string",
                        "format": "uri"
                      },
                      "podcastaddict": {
                        "type": "string",
                        "format": "uri"
                      },
                      "podcastguru": {
                        "type": "string",
                        "format": "uri"
                      },
                      "podcastrepublic": {
                        "type": "string",
                        "format": "uri"
                      },
                      "podchaser": {
                        "type": "string",
                        "format": "uri"
                      },
                      "podfriend": {
                        "type": "string",
                        "format": "uri"
                      },
                      "podknife": {
                        "type": "string",
                        "format": "uri"
                      },
                      "podlp": {
                        "type": "string",
                        "format": "uri"
                      },
                      "podnews": {
                        "type": "string",
                        "format": "uri"
                      },
                      "podscan": {
                        "type": "string",
                        "format": "uri"
                      },
                      "podscribe": {
                        "type": "string",
                        "format": "uri"
                      },
                      "podstation": {
                        "type": "string",
                        "format": "uri"
                      },
                      "podurama": {
                        "type": "string",
                        "format": "uri"
                      },
                      "podverse": {
                        "type": "string",
                        "format": "uri"
                      },
                      "radiopublic": {
                        "type": "string",
                        "format": "uri"
                      },
                      "rephonic": {
                        "type": "string",
                        "format": "uri"
                      },
                      "sonnet": {
                        "type": "string",
                        "format": "uri"
                      },
                      "spotify": {
                        "type": "string",
                        "format": "uri"
                      },
                      "stenofm": {
                        "type": "string",
                        "format": "uri"
                      },
                      "truefans": {
                        "type": "string",
                        "format": "uri"
                      },
                      "tunein": {
                        "type": "string",
                        "format": "uri"
                      },
                      "youtubemusic": {
                        "type": "string",
                        "format": "uri"
                      }
                    },
                    "additionalProperties": false
                  },
                  "podcastHasGuests": {
                    "nullable": true,
                    "type": "boolean"
                  },
                  "podcastHasSponsors": {
                    "nullable": true,
                    "type": "boolean"
                  },
                  "podcastLocations": {
                    "nullable": true,
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "primaryContactEmail": {
                    "nullable": true,
                    "type": "string"
                  },
                  "rssFeedUrl": {
                    "type": "string"
                  },
                  "socialMediaLinks": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "socialMediaType": {
                          "type": "string",
                          "enum": [
                            "beehiiv",
                            "behance",
                            "bluesky",
                            "discord",
                            "facebook",
                            "github",
                            "instagram",
                            "linkedin",
                            "linktree",
                            "mastodon",
                            "medium",
                            "patreon",
                            "pinterest",
                            "reddit",
                            "snapchat",
                            "soundcloud",
                            "substack",
                            "threads",
                            "tiktok",
                            "tumblr",
                            "twitch",
                            "twitter",
                            "vimeo",
                            "whatsapp",
                            "youtube"
                          ]
                        },
                        "url": {
                          "type": "string",
                          "format": "uri"
                        },
                        "sources": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "enum": [
                              "apple-podcasts",
                              "bright-data-dataset",
                              "google-search",
                              "linktree",
                              "podcast-website",
                              "podchaser",
                              "rephonic",
                              "rss"
                            ]
                          }
                        }
                      },
                      "required": [
                        "socialMediaType",
                        "url",
                        "sources"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "spotifyId": {
                    "nullable": true,
                    "type": "string"
                  },
                  "stats": {
                    "type": "object",
                    "properties": {
                      "downloadCount": {
                        "type": "number"
                      },
                      "episodeCount": {
                        "type": "number"
                      },
                      "latestPublishedAt": {
                        "nullable": true
                      },
                      "firstEpisodePublishedAt": {
                        "nullable": true
                      },
                      "transcriptsCount": {
                        "type": "number"
                      },
                      "updateFrequency": {
                        "type": "string",
                        "enum": [
                          "daily",
                          "weekly",
                          "bi-weekly",
                          "monthly",
                          "stale",
                          "very-stale"
                        ]
                      }
                    },
                    "required": [
                      "downloadCount",
                      "episodeCount",
                      "latestPublishedAt",
                      "firstEpisodePublishedAt",
                      "transcriptsCount",
                      "updateFrequency"
                    ],
                    "additionalProperties": false
                  },
                  "titleLatestCleaned": {
                    "nullable": true,
                    "type": "string"
                  },
                  "transcriptionMode": {
                    "oneOf": [
                      {
                        "type": "object",
                        "properties": {
                          "mode": {
                            "type": "string",
                            "enum": [
                              "none"
                            ]
                          },
                          "transcribeSince": {
                            "not": {}
                          }
                        },
                        "required": [
                          "mode"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "mode": {
                            "type": "string",
                            "enum": [
                              "all"
                            ]
                          },
                          "transcribeSince": {
                            "not": {}
                          }
                        },
                        "required": [
                          "mode"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "mode": {
                            "type": "string",
                            "enum": [
                              "episodes-since"
                            ]
                          },
                          "transcribeSince": {}
                        },
                        "required": [
                          "mode",
                          "transcribeSince"
                        ],
                        "additionalProperties": false
                      }
                    ]
                  },
                  "websiteUrl": {
                    "nullable": true,
                    "type": "string"
                  },
                  "audienceEstimate": {
                    "type": "object",
                    "properties": {
                      "audienceDemographics": {
                        "nullable": true,
                        "type": "object",
                        "properties": {
                          "ageRange": {
                            "type": "string",
                            "enum": [
                              "Under 18",
                              "18-24",
                              "25-34",
                              "35-44",
                              "45-54",
                              "55+"
                            ],
                            "description": "The age range of the audience as a string."
                          },
                          "genderSkew": {
                            "type": "string",
                            "enum": [
                              "Male 0% Female 100%",
                              "Male 20% Female 80%",
                              "Male 40% Female 60%",
                              "Male 50% Female 50%",
                              "Male 60% Female 40%",
                              "Male 80% Female 20%",
                              "Male 100% Female 0%"
                            ],
                            "description": "How the audience is skewed in terms of gender."
                          },
                          "educationLevel": {
                            "type": "string",
                            "enum": [
                              "No High School",
                              "High School",
                              "Some College",
                              "Bachelors Degree",
                              "Masters Degree",
                              "Doctorate"
                            ],
                            "description": "The probable education levels of the audience."
                          },
                          "incomeLevel": {
                            "type": "string",
                            "enum": [
                              "Under $25K",
                              "$25K-$50K",
                              "$50K-$75K",
                              "$75K-$100K",
                              "$100K-$150K",
                              "$150K-$200K",
                              "$200K+"
                            ],
                            "description": "The probable income levels of the audience."
                          },
                          "exampleListenerProfile": {
                            "type": "string",
                            "description": "An example profile of the audience. This is a description of the audience that you can use to describe the audience to an advertiser."
                          }
                        },
                        "required": [
                          "ageRange",
                          "genderSkew",
                          "educationLevel",
                          "incomeLevel",
                          "exampleListenerProfile"
                        ],
                        "additionalProperties": false
                      },
                      "estimatedMonthlyListeners": {
                        "nullable": true,
                        "type": "number"
                      },
                      "estimatedMonthyListenersCalculatedAt": {
                        "nullable": true
                      }
                    },
                    "required": [
                      "audienceDemographics",
                      "estimatedMonthlyListeners",
                      "estimatedMonthyListenersCalculatedAt"
                    ],
                    "additionalProperties": false
                  },
                  "audioRetentionPolicy": {
                    "type": "string",
                    "enum": [
                      "RETAIN_INDEFINITELY",
                      "RETAIN_DAYS",
                      "RETAIN_UNTIL_TRANSCRIBED"
                    ]
                  },
                  "audioRetentionDays": {
                    "nullable": true,
                    "type": "number"
                  }
                },
                "required": [
                  "author",
                  "authorityScore",
                  "genres",
                  "id",
                  "imageUrl",
                  "language",
                  "lastEpisodePublishedAt",
                  "slug",
                  "title",
                  "titleLatest",
                  "appleId",
                  "description",
                  "emails",
                  "explicitRss",
                  "hostNames",
                  "ignore",
                  "isClaimed",
                  "podcastAffiliation",
                  "podcastDirectoryLinks",
                  "podcastHasGuests",
                  "podcastHasSponsors",
                  "podcastLocations",
                  "primaryContactEmail",
                  "rssFeedUrl",
                  "socialMediaLinks",
                  "spotifyId",
                  "stats",
                  "titleLatestCleaned",
                  "transcriptionMode",
                  "websiteUrl"
                ],
                "additionalProperties": false
              }
            ]
          }
        }
      },
      "required": [
        "options",
        "totalRequested",
        "totalFound",
        "podcasts"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "status",
    "data"
  ],
  "additionalProperties": false
}
```

---

## See also

- All endpoints in one file: https://www.podengine.ai/api-docs/llms.txt
- Full reference with every schema inlined: https://www.podengine.ai/api-docs/llms-full.txt
- OpenAPI 3.1 spec: https://www.podengine.ai/api-docs/openapi.json
- Get an API key: https://www.podengine.ai/get-started
- Support: support@podengine.ai