Podcast Details by Feed URL

GET https://api.podengine.ai/api/v1/podcasts/by-feed-url

Get a podcast, and where it is listed, from its RSS feed URL. http and https, a trailing slash and the case of the host are ignored, and a feed that has moved host still matches the URL we first tracked it under. Returns the same response as Podcast Details, and counts as a podcast lookup in the same way. Returns 404 when we do not track the feed.

Recipe: get podcast listing links from a feed URL

API token required Markdown for LLMs

OpenAPI spec

Example request

Install & configure

curl -X GET "https://api.podengine.ai/api/v1/podcasts/by-feed-url?rssFeedUrl=https%3A%2F%2Fanchor.fm%2Fs%2F7c624c84%2Fpodcast%2Frss" \
  -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/by-feed-url?rssFeedUrl=https%3A%2F%2Fanchor.fm%2Fs%2F7c624c84%2Fpodcast%2Frss", 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/by-feed-url?rssFeedUrl=https%3A%2F%2Fanchor.fm%2Fs%2F7c624c84%2Fpodcast%2Frss", 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/by-feed-url?rssFeedUrl=https%3A%2F%2Fanchor.fm%2Fs%2F7c624c84%2Fpodcast%2Frss");
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/by-feed-url?rssFeedUrl=https%3A%2F%2Fanchor.fm%2Fs%2F7c624c84%2Fpodcast%2Frss", 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.getPodcastByFeedUrl({
  rssFeedUrl: 'https://anchor.fm/s/7c624c84/podcast/rss',
});

console.log(data);

import os

from podengine import PodEngine

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

data = pe.podcasts.get_podcast_by_feed_url(
    rss_feed_url="https://anchor.fm/s/7c624c84/podcast/rss",
)

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",
      "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,
        "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
        }
      },
      "audioRetentionPolicy": "RETAIN_INDEFINITELY",
      "audioRetentionDays": 0
    },
    "platforms": {
      "apple": {
        "id": 0,
        "url": "https://example.com"
      },
      "spotify": {
        "id": "string",
        "url": "https://example.com"
      },
      "youtube": {
        "channelId": "string",
        "url": "https://example.com",
        "tier": "associated"
      }
    }
  }
}

Request

Query parameters

rssFeedUrlstringrequired1 – 2048 characters

The podcast’s RSS feed URL. http and https, a trailing slash and the case of the host are ignored. Also matches the feed URL we first tracked the show under, for feeds that have since moved host.

Response

200 application/json

statusliteral: OKrequired

dataobjectrequired2 fields

podcastobjectrequired37 fields

authorstringrequirednullable

authorityScoreobjectrequirednullable6 fields

calculatedAtdaterequired

authorityScorenumberrequired

This is the weighted total authority score of the podcast, out of 100

qualityScorenumberrequired

This is the quality score of the podcast, out of 100

youtubeScorenumberrequired

This is the YouTube score of the podcast, out of 100

socialScorenumberrequired

This is the social score of the podcast, out of 100

engagementScorenumberrequired

This is the engagement score of the podcast, out of 100

genresarray of stringrequired

idstringrequired

imageUrlstringrequirednullable

languagestringrequired

lastEpisodePublishedAtdaterequired

slugstringrequired

titlestringrequired

titleLateststringrequired

appleIdnumberrequired

blockedobject2 fields

blockedDatedaterequired

blockedReasonstring

descriptionstringrequirednullable

emailsarray of stringrequired

explicitRssbooleanrequirednullable

hostNamesarray of stringrequirednullable

ignorebooleanrequired

ignoreReasonstring

neverTranscribeboolean

neverTranscribeReasonstring

isClaimedbooleanrequired

podcastAffiliationobjectrequirednullable2 fields

affiliateOrganizationNamestringnullable

The name of the affiliate organization

affiliationTypeenumnullable

The type of affiliation from the list: academic, branded, celebrity, government, independent, legacy media, podcast company, new media, not for profit, religious, other, unknown

academicbrandedcelebritygovernmentindependentlegacy mediapodcast companynew medianot for profitreligiousotherunknown

podcastDirectoryLinksobjectrequired45 fields

amazonmusicstringurl

anchorstringurl

antennapodstringurl

anytimeplayerstringurl

apollostringurl

applestringurl

audiblestringurl

breezstringurl

castamaticstringurl

castboxstringurl

castrostringurl

curiocasterstringurl

fountainstringurl

goodpodsstringurl

googlestringurl

gpodderstringurl

iheartradiostringurl

listennotesstringurl

lnbeatsstringurl

moonfmstringurl

overcaststringurl

playerfmstringurl

pocketcastsstringurl

podbeanstringurl

podcastaddictstringurl

podcastgurustringurl

podcastrepublicstringurl

podchaserstringurl

podfriendstringurl

podknifestringurl

podlpstringurl

podnewsstringurl

podscanstringurl

podscribestringurl

podstationstringurl

poduramastringurl

podversestringurl

radiopublicstringurl

rephonicstringurl

sonnetstringurl

spotifystringurl

stenofmstringurl

truefansstringurl

tuneinstringurl

youtubemusicstringurl

podcastHasGuestsbooleanrequirednullable

podcastHasSponsorsbooleanrequirednullable

podcastLocationsarray of stringrequirednullable

primaryContactEmailstringrequirednullable

rssFeedUrlstringrequired

socialMediaLinksarray of objectrequired3 fields

socialMediaTypeenumrequired

Social platform associated with the profile URL.

beehiivbehanceblueskydiscordfacebookgithubinstagramlinkedinlinktreemastodonmediumpatreonpinterestredditsnapchatsoundcloudsubstackthreadstiktoktumblrtwitchtwittervimeowhatsappyoutube

urlstringrequiredurl

Full URL of the social media profile.

sourcesarray of enumrequired

apple-podcastsbright-data-datasetgoogle-searchlinktreepodcast-websitepodchaserrephonicrssyoutube-channel-linksyoutube-episode-searchyoutube-serpyoutube-api-search

spotifyIdstringrequirednullable

statsobjectrequired6 fields

downloadCountnumberrequired

episodeCountnumberrequired

latestPublishedAtdaterequirednullable

firstEpisodePublishedAtdaterequirednullable

transcriptsCountnumberrequired

updateFrequencyenumrequired

How often the show publishes new episodes, based on the typical gap between its recent episodes. daily: about every day. weekly: every 2–10 days. bi-weekly: every 10–20 days. monthly: less often than that. stale: no new episode for over 90 days, or for much longer than its usual gap. very-stale: no new episode for over a year.

dailyweeklybi-weeklymonthlystalevery-stale

titleLatestCleanedstringrequirednullable

transcriptionModeunionrequired

websiteUrlstringrequirednullable

audienceEstimateobject8 fields

audienceDemographicsobjectrequirednullable5 fields

ageRangeenumrequired

The age range of the audience as a string.

Under 1818-2425-3435-4445-5455+

genderSkewenumrequired

How the audience is skewed in terms of gender.

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%

educationLevelenumrequired

The probable education levels of the audience.

No High SchoolHigh SchoolSome CollegeBachelors DegreeMasters DegreeDoctorate

incomeLevelenumrequired

The probable income levels of the audience.

Under $25K$25K-$50K$50K-$75K$75K-$100K$100K-$150K$150K-$200K$200K+

exampleListenerProfilestringrequired

An example profile of the audience. This is a description of the audience that you can use to describe the audience to an advertiser.

estimatedMonthlyListenersnumberrequirednullable

estimatedMonthlyListenersBucketenumnullable

Bucket for the estimated monthly listeners: 0-1K, 1K-10K, 10K-100K, 100K-1M or 1M+. 0-1K means the estimate is under 1,000, even when the rounded figure reads 1,000. Null means no estimate is available.

0-1K1K-10K10K-100K100K-1M1M+

estimatedMonthyListenersCalculatedAtdaterequirednullable

confidenceenumnullable

highmediumlow

isDormantbooleannullable

hasOp3Analyticsboolean

op3Downloadsunion

audioRetentionPolicyenum

RETAIN_INDEFINITELYRETAIN_DAYSRETAIN_UNTIL_TRANSCRIBED

audioRetentionDaysnumbernullable

platformsobject3 fields

Where the podcast is listed: Apple Podcasts, Spotify and YouTube.

appleobjectrequired2 fields

Apple Podcasts. Every podcast we track has one.

idnumberrequired

Apple Podcasts ID

urlstringrequiredurl

Apple Podcasts show page

spotifyobjectrequirednullable2 fields

Spotify, when we have matched the show. Spotify has no lookup by feed, so each match is inferred. Null means we have no match, not that the show is missing from Spotify.

idstringrequired

Spotify show ID

urlstringrequiredurl

Spotify show page, https://open.spotify.com/show/<id>

youtubeobjectrequirednullable3 fields

The show’s main YouTube channel, when we have one.

channelIdstringrequired

YouTube channel ID

urlstringrequiredurl

YouTube channel page

tierenumrequired

`associated`: the channel passed our association checks and is the show’s own channel. `candidate`: the best match we have that has not passed them yet.

associatedcandidate