Podcast Guests

GET https://api.podengine.ai/api/v1/podcasts/:podcastIdOrSlug/guests

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

API token required Markdown for LLMs

OpenAPI spec

Example request

Install & configure

curl -X GET "https://api.podengine.ai/api/v1/podcasts/:podcastIdOrSlug/guests?sinceDays=90" \
  -H "Content-Type: application/json" \
  -H "Authorization: YOUR_API_TOKEN"

const options = {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "YOUR_API_TOKEN"
  }
};

fetch("https://api.podengine.ai/api/v1/podcasts/:podcastIdOrSlug/guests?sinceDays=90", options)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

import requests

headers = {
    "Content-Type": "application/json",
    "Authorization": "YOUR_API_TOKEN"
}

response = requests.get("https://api.podengine.ai/api/v1/podcasts/:podcastIdOrSlug/guests?sinceDays=90", headers=headers)
print(response.json())

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "YOUR_API_TOKEN");
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));

var response = await client.GetAsync("https://api.podengine.ai/api/v1/podcasts/:podcastIdOrSlug/guests?sinceDays=90");
var data = await response.Content.ReadAsStringAsync();
Console.WriteLine(data);

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.podengine.ai/api/v1/podcasts/:podcastIdOrSlug/guests?sinceDays=90", nil)
	req.Header.Add("Content-Type", "application/json")
	req.Header.Add("Authorization", "YOUR_API_TOKEN")
	
	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

import { PodEngine } from '@podengine/sdk';

const pe = new PodEngine({ apiKey: process.env.PODENGINE_API_KEY });

const data = await pe.podcasts.getPodcastGuests({
  podcastIdOrSlug: 'this-week-in-startups',
  sinceDays: 90,
});

console.log(data);

import os

from podengine import PodEngine

pe = PodEngine(api_key=os.environ["PODENGINE_API_KEY"])

data = pe.podcasts.get_podcast_guests(
    podcast_id_or_slug="this-week-in-startups",
    since_days=90,
)

print(data)

200

Example response

{
  "status": "OK",
  "data": {
    "podcast": {
      "author": "string",
      "authorityScore": {
        "calculatedAt": "2026-01-15T09:30:00.000Z",
        "authorityScore": 0,
        "qualityScore": 0,
        "youtubeScore": 0,
        "socialScore": 0,
        "engagementScore": 0
      },
      "genres": [
        "string"
      ],
      "id": "string",
      "imageUrl": "string",
      "language": "string",
      "lastEpisodePublishedAt": "2026-01-15T09:30:00.000Z",
      "slug": "string",
      "title": "string",
      "titleLatest": "string"
    },
    "guests": {
      "episodesCount": 0,
      "episodesWithGuestsCount": 0,
      "mostRecentEpisodeDate": "2026-01-15T09:30:00.000Z",
      "oldestEpisodeDate": "2026-01-15T09:30:00.000Z",
      "guests": [
        {
          "name": "string",
          "type": "host",
          "imageUrl": "string",
          "appearancesCount": 1,
          "mostRecentAppearanceDate": "2026-01-15T09:30:00.000Z",
          "oldestAppearanceDate": "2026-01-15T09:30:00.000Z"
        }
      ]
    }
  }
}

Request

Path parameters

podcastIdOrSlugstringrequired

Podengine ID, Apple ID, or slug

Query parameters

sinceDaysnumber1 – 365

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.

roleenum

Only include people with this role. Default: guests, hosts, and mentioned people.

guesthost