Refresh Podcast

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

Refresh podcast metadata and thumbnail from RSS feed. Rate limited to once per minute per podcast.

Example request

curl -X GET "https://api.podengine.ai/api/v1/podcasts/:podcastIdOrSlug/refresh?updatePodcastThumbnail=true" \
  -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/refresh?updatePodcastThumbnail=true", 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/refresh?updatePodcastThumbnail=true", 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/refresh?updatePodcastThumbnail=true");
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/refresh?updatePodcastThumbnail=true", 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.refreshPodcast({
  podcastIdOrSlug: 'this-week-in-startups',
  updatePodcastThumbnail: true,
});

console.log(data);

import os

from podengine import PodEngine

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

data = pe.podcasts.refresh_podcast(
    podcast_id_or_slug="this-week-in-startups",
    update_podcast_thumbnail=True,
)

print(data)

200

Example response

{
  "status": "OK",
  "data": {
    "success": true,
    "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",
      "appleId": 0,
      "blocked": {
        "blockedDate": "2026-01-15T09:30:00.000Z",
        "blockedReason": "string"
      },
      "description": "string",
      "emails": [
        "string"
      ],
      "explicitRss": true,
      "hostNames": [
        "string"
      ],
      "ignore": true,
      "ignoreReason": "string",
      "neverTranscribe": true,
      "neverTranscribeReason": "string",
      "isClaimed": true,
      "podcastAffiliation": {
        "affiliateOrganizationName": "string",
        "affiliationType": "academic"
      },
      "podcastDirectoryLinks": {
        "amazonmusic": "https://example.com",
        "anchor": "https://example.com",
        "antennapod": "https://example.com",
        "anytimeplayer": "https://example.com",
        "apollo": "https://example.com",
        "apple": "https://example.com",
        "audible": "https://example.com",
        "breez": "https://example.com",
        "castamatic": "https://example.com",
        "castbox": "https://example.com",
        "castro": "https://example.com",
        "curiocaster": "https://example.com",
        "fountain": "https://example.com",
        "goodpods": "https://example.com",
        "google": "https://example.com",
        "gpodder": "https://example.com",
        "iheartradio": "https://example.com",
        "listennotes": "https://example.com",
        "lnbeats": "https://example.com",
        "moonfm": "https://example.com",
        "overcast": "https://example.com",
        "playerfm": "https://example.com",
        "pocketcasts": "https://example.com",
        "podbean": "https://example.com",
        "podcastaddict": "https://example.com",
        "podcastguru": "https://example.com",
        "podcastrepublic": "https://example.com",
        "podchaser": "https://example.com",
        "podfriend": "https://example.com",
        "podknife": "https://example.com",
        "podlp": "https://example.com",
        "podnews": "https://example.com",
        "podscan": "https://example.com",
        "podscribe": "https://example.com",
        "podstation": "https://example.com",
        "podurama": "https://example.com",
        "podverse": "https://example.com",
        "radiopublic": "https://example.com",
        "rephonic": "https://example.com",
        "sonnet": "https://example.com",
        "spotify": "https://example.com",
        "stenofm": "https://example.com",
        "truefans": "https://example.com",
        "tunein": "https://example.com",
        "youtubemusic": "https://example.com"
      },
      "podcastHasGuests": true,
      "podcastHasSponsors": true,
      "podcastLocations": [
        "string"
      ],
      "primaryContactEmail": "string",
      "rssFeedUrl": "string",
      "socialMediaLinks": [
        {
          "socialMediaType": "beehiiv",
          "url": "https://example.com",
          "sources": [
            "apple-podcasts"
          ]
        }
      ],
      "spotifyId": "string",
      "stats": {
        "downloadCount": 0,
        "episodeCount": 0,
        "latestPublishedAt": "2026-01-15T09:30:00.000Z",
        "firstEpisodePublishedAt": "2026-01-15T09:30:00.000Z",
        "transcriptsCount": 0,
        "updateFrequency": "daily"
      },
      "titleLatestCleaned": "string",
      "transcriptionMode": {
        "mode": "none",
        "transcribeSince": null
      },
      "websiteUrl": "string",
      "audienceEstimate": {
        "audienceDemographics": {
          "ageRange": "Under 18",
          "genderSkew": "Male 0% Female 100%",
          "educationLevel": "No High School",
          "incomeLevel": "Under $25K",
          "exampleListenerProfile": "string"
        },
        "estimatedMonthlyListeners": 0,
        "estimatedMonthlyListenersBucket": "0-1K",
        "estimatedMonthyListenersCalculatedAt": "2026-01-15T09:30:00.000Z",
        "confidence": "high",
        "isDormant": true,
        "estimatedMonthlyAudioListeners": 0,
        "estimatedMonthlyYoutubeViews": 0,
        "hasOp3Analytics": true,
        "op3Downloads": {
          "unit": "downloads",
          "source": "op3",
          "basis": "trailing_30_days",
          "last_synced_at": "2026-01-15T09:30:00.000Z",
          "source_as_of": "2026-01-15T09:30:00.000Z",
          "measurement_recorded_at": "2026-01-15T09:30:00.000Z",
          "coverage": "unknown",
          "freshness": "fresh",
          "status": "available",
          "value": 0,
          "reason": null
        },
        "hostReported": {
          "downloadsPerEpisode30d": 0,
          "source": "string",
          "sourceDetail": "string",
          "reportedAt": "2026-01-15T09:30:00.000Z"
        }
      },
      "audioRetentionPolicy": "RETAIN_INDEFINITELY",
      "audioRetentionDays": 0
    }
  }
}

Request

Path parameters

podcastIdOrSlugstringrequired

Pod Engine ID or slug, Apple Podcasts ID, Spotify show ID, or podcast:guid

Query parameters

updatePodcastThumbnailboolean

Refresh the stored podcast thumbnail while refreshing the RSS feed; defaults to false.

Response

200 application/json

statusliteral: OKrequired

dataunionrequired