# Podcast Details by Feed URL > 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-details-by-feed-url.md > Interactive HTML docs: https://www.podengine.ai/api-docs/get-podcast-details-by-feed-url > 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/by-feed-url **Podcast Details 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. ```bash 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: Bearer YOUR_API_KEY" ``` **Query schema:** ```json { "type": "object", "properties": { "rssFeedUrl": { "type": "string", "minLength": 1, "maxLength": 2048, "description": "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." } }, "required": [ "rssFeedUrl" ], "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" }, "appleId": { "type": "number" }, "blocked": { "type": "object", "properties": { "blockedDate": {}, "blockedReason": { "type": "string" } }, "required": [ "blockedDate" ], "additionalProperties": false }, "description": { "nullable": true, "type": "string" }, "emails": { "type": "array", "items": { "type": "string" } }, "explicitRss": { "nullable": true, "type": "boolean" }, "hostNames": { "nullable": true, "type": "array", "items": { "type": "string" } }, "ignore": { "type": "boolean" }, "ignoreReason": { "type": "string" }, "neverTranscribe": { "type": "boolean" }, "neverTranscribeReason": { "type": "string" }, "isClaimed": { "type": "boolean" }, "podcastAffiliation": { "nullable": true, "type": "object", "properties": { "affiliateOrganizationName": { "nullable": true, "description": "The name of the affiliate organization", "type": "string" }, "affiliationType": { "nullable": true, "description": "The type of affiliation from the list: academic, branded, celebrity, government, independent, legacy media, podcast company, new media, not for profit, religious, other, unknown", "type": "string", "enum": [ "academic", "branded", "celebrity", "government", "independent", "legacy media", "podcast company", "new media", "not for profit", "religious", "other", "unknown" ] } }, "additionalProperties": false }, "podcastDirectoryLinks": { "type": "object", "properties": { "amazonmusic": { "type": "string", "format": "uri" }, "anchor": { "type": "string", "format": "uri" }, "antennapod": { "type": "string", "format": "uri" }, "anytimeplayer": { "type": "string", "format": "uri" }, "apollo": { "type": "string", "format": "uri" }, "apple": { "type": "string", "format": "uri" }, "audible": { "type": "string", "format": "uri" }, "breez": { "type": "string", "format": "uri" }, "castamatic": { "type": "string", "format": "uri" }, "castbox": { "type": "string", "format": "uri" }, "castro": { "type": "string", "format": "uri" }, "curiocaster": { "type": "string", "format": "uri" }, "fountain": { "type": "string", "format": "uri" }, "goodpods": { "type": "string", "format": "uri" }, "google": { "type": "string", "format": "uri" }, "gpodder": { "type": "string", "format": "uri" }, "iheartradio": { "type": "string", "format": "uri" }, "listennotes": { "type": "string", "format": "uri" }, "lnbeats": { "type": "string", "format": "uri" }, "moonfm": { "type": "string", "format": "uri" }, "overcast": { "type": "string", "format": "uri" }, "playerfm": { "type": "string", "format": "uri" }, "pocketcasts": { "type": "string", "format": "uri" }, "podbean": { "type": "string", "format": "uri" }, "podcastaddict": { "type": "string", "format": "uri" }, "podcastguru": { "type": "string", "format": "uri" }, "podcastrepublic": { "type": "string", "format": "uri" }, "podchaser": { "type": "string", "format": "uri" }, "podfriend": { "type": "string", "format": "uri" }, "podknife": { "type": "string", "format": "uri" }, "podlp": { "type": "string", "format": "uri" }, "podnews": { "type": "string", "format": "uri" }, "podscan": { "type": "string", "format": "uri" }, "podscribe": { "type": "string", "format": "uri" }, "podstation": { "type": "string", "format": "uri" }, "podurama": { "type": "string", "format": "uri" }, "podverse": { "type": "string", "format": "uri" }, "radiopublic": { "type": "string", "format": "uri" }, "rephonic": { "type": "string", "format": "uri" }, "sonnet": { "type": "string", "format": "uri" }, "spotify": { "type": "string", "format": "uri" }, "stenofm": { "type": "string", "format": "uri" }, "truefans": { "type": "string", "format": "uri" }, "tunein": { "type": "string", "format": "uri" }, "youtubemusic": { "type": "string", "format": "uri" } }, "additionalProperties": false }, "podcastHasGuests": { "nullable": true, "type": "boolean" }, "podcastHasSponsors": { "nullable": true, "type": "boolean" }, "podcastLocations": { "nullable": true, "type": "array", "items": { "type": "string" } }, "primaryContactEmail": { "nullable": true, "type": "string" }, "rssFeedUrl": { "type": "string" }, "socialMediaLinks": { "type": "array", "items": { "type": "object", "properties": { "socialMediaType": { "type": "string", "enum": [ "beehiiv", "behance", "bluesky", "discord", "facebook", "github", "instagram", "linkedin", "linktree", "mastodon", "medium", "patreon", "pinterest", "reddit", "snapchat", "soundcloud", "substack", "threads", "tiktok", "tumblr", "twitch", "twitter", "vimeo", "whatsapp", "youtube" ], "description": "Social platform associated with the profile URL." }, "url": { "type": "string", "format": "uri", "description": "Full URL of the social media profile." }, "sources": { "type": "array", "items": { "type": "string", "enum": [ "apple-podcasts", "bright-data-dataset", "google-search", "linktree", "podcast-website", "podchaser", "rephonic", "rss", "youtube-channel-links", "youtube-episode-search", "youtube-serp", "youtube-api-search" ] } } }, "required": [ "socialMediaType", "url", "sources" ], "additionalProperties": false } }, "spotifyId": { "nullable": true, "type": "string" }, "stats": { "type": "object", "properties": { "downloadCount": { "type": "number" }, "episodeCount": { "type": "number" }, "latestPublishedAt": { "nullable": true }, "firstEpisodePublishedAt": { "nullable": true }, "transcriptsCount": { "type": "number" }, "updateFrequency": { "type": "string", "enum": [ "daily", "weekly", "bi-weekly", "monthly", "stale", "very-stale" ], "description": "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." } }, "required": [ "downloadCount", "episodeCount", "latestPublishedAt", "firstEpisodePublishedAt", "transcriptsCount", "updateFrequency" ], "additionalProperties": false }, "titleLatestCleaned": { "nullable": true, "type": "string" }, "transcriptionMode": { "oneOf": [ { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "none" ] }, "transcribeSince": { "not": {} } }, "required": [ "mode" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "all" ] }, "transcribeSince": { "not": {} } }, "required": [ "mode" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "episodes-since" ] }, "transcribeSince": {} }, "required": [ "mode", "transcribeSince" ], "additionalProperties": false } ] }, "websiteUrl": { "nullable": true, "type": "string" }, "audienceEstimate": { "type": "object", "properties": { "audienceDemographics": { "nullable": true, "type": "object", "properties": { "ageRange": { "type": "string", "enum": [ "Under 18", "18-24", "25-34", "35-44", "45-54", "55+" ], "description": "The age range of the audience as a string." }, "genderSkew": { "type": "string", "enum": [ "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%" ], "description": "How the audience is skewed in terms of gender." }, "educationLevel": { "type": "string", "enum": [ "No High School", "High School", "Some College", "Bachelors Degree", "Masters Degree", "Doctorate" ], "description": "The probable education levels of the audience." }, "incomeLevel": { "type": "string", "enum": [ "Under $25K", "$25K-$50K", "$50K-$75K", "$75K-$100K", "$100K-$150K", "$150K-$200K", "$200K+" ], "description": "The probable income levels of the audience." }, "exampleListenerProfile": { "type": "string", "description": "An example profile of the audience. This is a description of the audience that you can use to describe the audience to an advertiser." } }, "required": [ "ageRange", "genderSkew", "educationLevel", "incomeLevel", "exampleListenerProfile" ], "additionalProperties": false }, "estimatedMonthlyListeners": { "nullable": true, "type": "number" }, "estimatedMonthlyListenersBucket": { "nullable": true, "description": "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.", "type": "string", "enum": [ "0-1K", "1K-10K", "10K-100K", "100K-1M", "1M+" ] }, "estimatedMonthyListenersCalculatedAt": { "nullable": true }, "confidence": { "nullable": true, "type": "string", "enum": [ "high", "medium", "low" ] }, "isDormant": { "nullable": true, "type": "boolean" }, "hasOp3Analytics": { "type": "boolean" }, "op3Downloads": { "oneOf": [ { "type": "object", "properties": { "unit": { "type": "string", "enum": [ "downloads" ] }, "source": { "type": "string", "enum": [ "op3" ] }, "basis": { "type": "string", "enum": [ "trailing_30_days" ] }, "last_synced_at": { "nullable": true, "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$" }, "source_as_of": { "nullable": true, "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$" }, "measurement_recorded_at": { "nullable": true, "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$" }, "coverage": { "type": "string", "enum": [ "unknown" ] }, "freshness": { "type": "string", "enum": [ "fresh", "stale", "unknown" ] }, "status": { "type": "string", "enum": [ "available" ] }, "value": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "reason": { "type": "string", "nullable": true, "enum": [ null ] } }, "required": [ "unit", "source", "basis", "last_synced_at", "source_as_of", "measurement_recorded_at", "coverage", "freshness", "status", "value", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "unit": { "type": "string", "enum": [ "downloads" ] }, "source": { "type": "string", "enum": [ "op3" ] }, "basis": { "type": "string", "enum": [ "trailing_30_days" ] }, "last_synced_at": { "nullable": true, "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$" }, "source_as_of": { "nullable": true, "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$" }, "measurement_recorded_at": { "nullable": true, "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$" }, "coverage": { "type": "string", "enum": [ "unknown" ] }, "freshness": { "type": "string", "enum": [ "fresh", "stale", "unknown" ] }, "status": { "type": "string", "enum": [ "unavailable" ] }, "value": { "type": "string", "nullable": true, "enum": [ null ] }, "reason": { "type": "string", "enum": [ "no_measurement", "invalid_measurement", "history_mismatch" ] } }, "required": [ "unit", "source", "basis", "last_synced_at", "source_as_of", "measurement_recorded_at", "coverage", "freshness", "status", "value", "reason" ], "additionalProperties": false } ] } }, "required": [ "audienceDemographics", "estimatedMonthlyListeners", "estimatedMonthyListenersCalculatedAt" ], "additionalProperties": false }, "audioRetentionPolicy": { "type": "string", "enum": [ "RETAIN_INDEFINITELY", "RETAIN_DAYS", "RETAIN_UNTIL_TRANSCRIBED" ] }, "audioRetentionDays": { "nullable": true, "type": "number" } }, "required": [ "author", "authorityScore", "genres", "id", "imageUrl", "language", "lastEpisodePublishedAt", "slug", "title", "titleLatest", "appleId", "description", "emails", "explicitRss", "hostNames", "ignore", "isClaimed", "podcastAffiliation", "podcastDirectoryLinks", "podcastHasGuests", "podcastHasSponsors", "podcastLocations", "primaryContactEmail", "rssFeedUrl", "socialMediaLinks", "spotifyId", "stats", "titleLatestCleaned", "transcriptionMode", "websiteUrl" ], "additionalProperties": false }, "platforms": { "type": "object", "properties": { "apple": { "type": "object", "properties": { "id": { "type": "number", "description": "Apple Podcasts ID" }, "url": { "type": "string", "format": "uri", "description": "Apple Podcasts show page" } }, "required": [ "id", "url" ], "additionalProperties": false, "description": "Apple Podcasts. Every podcast we track has one." }, "spotify": { "nullable": true, "description": "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.", "type": "object", "properties": { "id": { "type": "string", "description": "Spotify show ID" }, "url": { "type": "string", "format": "uri", "description": "Spotify show page, https://open.spotify.com/show/" } }, "required": [ "id", "url" ], "additionalProperties": false }, "youtube": { "nullable": true, "description": "The show’s main YouTube channel, when we have one.", "type": "object", "properties": { "channelId": { "type": "string", "description": "YouTube channel ID" }, "url": { "type": "string", "format": "uri", "description": "YouTube channel page" }, "tier": { "type": "string", "enum": [ "associated", "candidate" ], "description": "`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." } }, "required": [ "channelId", "url", "tier" ], "additionalProperties": false } }, "required": [ "apple", "spotify", "youtube" ], "additionalProperties": false, "description": "Where the podcast is listed: Apple Podcasts, Spotify and YouTube." } }, "required": [ "podcast" ], "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