# Podcast Sponsors

> 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-sponsors.md
> Interactive HTML docs: https://www.podengine.ai/api-docs/get-podcast-sponsors
> Full API reference (all endpoints): https://www.podengine.ai/api-docs/llms.txt

**Base URL:** `https://api.podengine.ai`
**Auth:** Requires a Bearer token: `Authorization: Bearer YOUR_API_KEY`

---

#### GET /api/v1/podcasts/:podcastIdOrSlug/sponsors
**Podcast Sponsors**

Get a summary of the sponsors and advertisers on a podcast — by default from its last 10 episodes, or from a time window with sinceDays

```bash
curl -X GET "https://api.podengine.ai/api/v1/podcasts/this-week-in-startups/sponsors?sinceDays=90" \
  -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
}
```

**Query schema:**
```json
{
  "type": "object",
  "properties": {
    "sinceDays": {
      "description": "Summarise episodes published in the last N days (max 365) instead of the default last 10 episodes. Windowed requests are read-only: they only include episodes that have already been analysed, covering at most the 500 most recently published episodes in the window, so shows with sparse analysis coverage may return incomplete windowed summaries.",
      "type": "integer",
      "minimum": 1,
      "maximum": 365
    }
  },
  "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
        },
        "sponsors": {
          "type": "object",
          "properties": {
            "episodesCount": {
              "type": "number"
            },
            "episodesWithSponsorsCount": {
              "type": "number"
            },
            "mostRecentEpisodeDate": {
              "nullable": true
            },
            "oldestEpisodeDate": {
              "nullable": true
            },
            "sponsors": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "imageUrl": {
                    "nullable": true,
                    "type": "string"
                  },
                  "appearancesCount": {
                    "type": "number",
                    "minimum": 1
                  },
                  "mostRecentAppearanceDate": {},
                  "oldestAppearanceDate": {}
                },
                "required": [
                  "name",
                  "imageUrl",
                  "appearancesCount",
                  "mostRecentAppearanceDate",
                  "oldestAppearanceDate"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "episodesCount",
            "episodesWithSponsorsCount",
            "mostRecentEpisodeDate",
            "oldestEpisodeDate",
            "sponsors"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "podcast",
        "sponsors"
      ],
      "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