# Podcast Youtube Details

> 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-podcast-youtube-details.md
> Interactive HTML docs: https://www.podengine.ai/api-docs/get-podcast-youtube-details
> 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/:podcastIdOrSlug/youtube
**Podcast Youtube Details**

Get the youtube data for a podcast

```bash
curl -X GET "http://localhost:4000/api/v1/podcasts/this-week-in-startups/youtube" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

**Path parameters schema:**
```json
{
  "type": "object",
  "properties": {
    "podcastIdOrSlug": {
      "type": "string",
      "description": "Podengine ID, Apple ID, or slug"
    }
  },
  "required": [
    "podcastIdOrSlug"
  ],
  "additionalProperties": false
}
```

**Response schema:**
```json
{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "OK"
      ]
    },
    "data": {
      "type": "object",
      "properties": {
        "podcast": {
          "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
        },
        "youtubeData": {
          "type": "object",
          "properties": {
            "podcastId": {
              "type": "string"
            },
            "youtubeData": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "title": {
                    "type": "string"
                  },
                  "description": {
                    "nullable": true,
                    "type": "string"
                  },
                  "subscriberCount": {
                    "type": "number"
                  },
                  "viewCount": {
                    "type": "number"
                  },
                  "videoCount": {
                    "type": "number"
                  },
                  "publishedAt": {
                    "nullable": true
                  },
                  "thumbnails": {
                    "type": "object",
                    "properties": {
                      "default": {
                        "nullable": true,
                        "type": "string"
                      },
                      "medium": {
                        "nullable": true,
                        "type": "string"
                      },
                      "high": {
                        "nullable": true,
                        "type": "string"
                      }
                    },
                    "required": [
                      "default",
                      "medium",
                      "high"
                    ],
                    "additionalProperties": false
                  },
                  "country": {
                    "nullable": true,
                    "type": "string"
                  },
                  "customUrl": {
                    "nullable": true,
                    "type": "string"
                  },
                  "links": {
                    "nullable": true,
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "isPodcastChannel": {
                    "nullable": true,
                    "type": "boolean"
                  },
                  "discoverInputKeyword": {
                    "nullable": true,
                    "type": "string"
                  },
                  "bannerImageUrl": {
                    "nullable": true,
                    "type": "string"
                  },
                  "videos": {
                    "nullable": true,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "imageUrl": {
                          "type": "string"
                        },
                        "isShort": {
                          "type": "boolean"
                        },
                        "postedAt": {},
                        "postedAtRelative": {
                          "type": "string"
                        },
                        "scrapedAt": {},
                        "title": {
                          "type": "string"
                        },
                        "videoUrl": {
                          "type": "string"
                        },
                        "views": {
                          "type": "number"
                        }
                      },
                      "required": [
                        "imageUrl",
                        "isShort",
                        "postedAt",
                        "postedAtRelative",
                        "scrapedAt",
                        "title",
                        "videoUrl",
                        "views"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "profileImageUrl": {
                    "nullable": true,
                    "type": "string"
                  },
                  "dataLastUpdated": {},
                  "lastVideoUploadDate": {
                    "nullable": true
                  },
                  "lastVideoUploadDateSource": {
                    "nullable": true,
                    "type": "string"
                  },
                  "lastVideoUploadDateCheckedAt": {
                    "nullable": true
                  }
                },
                "required": [
                  "id",
                  "title",
                  "description",
                  "subscriberCount",
                  "viewCount",
                  "videoCount",
                  "publishedAt",
                  "thumbnails",
                  "country",
                  "customUrl",
                  "links",
                  "isPodcastChannel",
                  "discoverInputKeyword",
                  "bannerImageUrl",
                  "videos",
                  "profileImageUrl",
                  "dataLastUpdated",
                  "lastVideoUploadDate",
                  "lastVideoUploadDateSource",
                  "lastVideoUploadDateCheckedAt"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "podcastId",
            "youtubeData"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "podcast",
        "youtubeData"
      ],
      "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