# Podcast All Details > 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-all-details.md > Interactive HTML docs: https://www.podengine.ai/api-docs/get-podcast-all-details > Full API reference (all endpoints): https://www.podengine.ai/api-docs/llms.txt **Base URL:** `http://localhost:4000` **Auth:** Requires a Bearer token: `Authorization: Bearer YOUR_API_KEY` --- #### GET /api/v1/podcasts/:podcastIdOrSlug/all-details **Podcast All Details** This wraps all the other endpoints for a podcast so you can get all the details in a single request. ```bash curl -X GET "http://localhost:4000/api/v1/podcasts/this-week-in-startups/all-details" \ -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 } ``` **Response schema:** ```json { "type": "object", "properties": { "status": { "type": "string", "enum": [ "OK" ] }, "data": { "type": "object", "properties": { "podcast": { "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" ] }, "url": { "type": "string", "format": "uri" }, "sources": { "type": "array", "items": { "type": "string", "enum": [ "apple-podcasts", "bright-data-dataset", "google-search", "linktree", "podcast-website", "podchaser", "rephonic", "rss" ] } } }, "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" ] } }, "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" }, "estimatedMonthyListenersCalculatedAt": { "nullable": true } }, "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 }, "recentEpisodes": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "deepAnalysisRequestedAt": { "nullable": true }, "description": { "nullable": true, "type": "string" }, "durationSeconds": { "nullable": true, "type": "number" }, "enclosureUrl": { "type": "string" }, "episodeId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "episodeGuestsAndHosts": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "type": { "type": "string", "enum": [ "host", "guest", "unknown", "mentioned" ] }, "imageUrl": { "nullable": true, "type": "string" } }, "required": [ "name", "type", "imageUrl" ], "additionalProperties": false } }, "episodeSlug": { "type": "string" }, "episodeShortDescription": { "nullable": true, "type": "string" }, "episodeSponsors": { "nullable": true, "type": "array", "items": { "type": "string" } }, "hasTranscript": { "type": "boolean" }, "imageUrl": { "nullable": true, "type": "string" }, "episodeThumbnailRssUrl": { "nullable": true, "type": "string" }, "podcastId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "podcastSlug": { "type": "string" }, "publishedAt": {}, "title": { "type": "string" }, "transcriptId": { "nullable": true, "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "transcriptionRequestedAt": { "nullable": true }, "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" }, "estimatedMonthyListenersCalculatedAt": { "nullable": true } }, "required": [ "audienceDemographics", "estimatedMonthlyListeners", "estimatedMonthyListenersCalculatedAt" ], "additionalProperties": false }, "youtubeEpisodeDetails": { "nullable": true, "type": "object", "properties": { "youtubeLink": { "type": "string", "format": "uri" }, "youtubeMatchConfidence": { "type": "number" }, "youtubeViewCount": { "nullable": true, "type": "number" }, "youtubeDataFetchedAt": { "nullable": true } }, "required": [ "youtubeLink", "youtubeMatchConfidence", "youtubeViewCount", "youtubeDataFetchedAt" ], "additionalProperties": false }, "applePodcastsUrl": { "nullable": true, "type": "string", "format": "uri" } }, "required": [ "deepAnalysisRequestedAt", "description", "durationSeconds", "enclosureUrl", "episodeId", "episodeGuestsAndHosts", "episodeSlug", "episodeShortDescription", "episodeSponsors", "hasTranscript", "imageUrl", "episodeThumbnailRssUrl", "podcastId", "podcastSlug", "publishedAt", "title", "transcriptId", "transcriptionRequestedAt", "youtubeEpisodeDetails", "applePodcastsUrl" ], "additionalProperties": false } }, "contacts": { "nullable": true, "type": "object", "properties": { "podcastId": { "type": "string" }, "emails": { "type": "array", "items": { "type": "object", "properties": { "email": { "type": "string", "description": "The email address associated with the podcast contact" }, "verifiedAt": { "nullable": true, "description": "The timestamp when the email was last verified, or null if it has not been verified" }, "syntaxValid": { "nullable": true, "description": "Whether the email address has valid syntax (e.g. correctly formatted local and domain parts), or null if not yet checked", "type": "boolean" }, "mxValid": { "nullable": true, "description": "Whether the email's domain has valid MX records indicating it can receive mail, or null if not yet checked", "type": "boolean" }, "deepVerifiedAt": { "nullable": true, "description": "The timestamp when the email was last deep-verified for deliverability, or null if not run" }, "deliverabilityStatus": { "nullable": true, "description": "Deep deliverability status: valid, invalid, catch-all, unknown, spamtrap, abuse, or do_not_mail", "type": "string", "enum": [ "valid", "invalid", "catch-all", "unknown", "spamtrap", "abuse", "do_not_mail" ] }, "deliverabilityReason": { "nullable": true, "description": "Sub-classification providing more detail on the deliverability result", "type": "string" }, "isFreeEmailProvider": { "nullable": true, "description": "Whether the address belongs to a known free-email provider (e.g. gmail, yahoo)", "type": "boolean" }, "suggestedCorrection": { "nullable": true, "description": "Suggested correction for likely typos, e.g. gmial.com -> gmail.com", "type": "string" } }, "required": [ "email", "verifiedAt", "syntaxValid", "mxValid", "deepVerifiedAt", "deliverabilityStatus", "deliverabilityReason", "isFreeEmailProvider", "suggestedCorrection" ], "additionalProperties": false } }, "phoneNumbers": { "type": "array", "items": { "type": "string" } }, "websites": { "type": "array", "items": { "type": "object", "properties": { "url": { "type": "string" }, "verified": { "type": "boolean" }, "contactUrls": { "type": "array", "items": { "type": "string" } } }, "required": [ "url", "verified", "contactUrls" ], "additionalProperties": false } } }, "required": [ "podcastId", "emails", "phoneNumbers", "websites" ], "additionalProperties": false }, "guests": { "nullable": true, "type": "object", "properties": { "episodesCount": { "type": "number" }, "episodesWithGuestsCount": { "type": "number" }, "mostRecentEpisodeDate": {}, "oldestEpisodeDate": {}, "guests": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "type": { "type": "string", "enum": [ "host", "guest", "unknown", "mentioned" ] }, "imageUrl": { "nullable": true, "type": "string" }, "appearancesCount": { "type": "number", "minimum": 1 }, "mostRecentAppearanceDate": {}, "oldestAppearanceDate": {} }, "required": [ "name", "type", "imageUrl", "appearancesCount", "mostRecentAppearanceDate", "oldestAppearanceDate" ], "additionalProperties": false } } }, "required": [ "episodesCount", "episodesWithGuestsCount", "mostRecentEpisodeDate", "oldestEpisodeDate", "guests" ], "additionalProperties": false }, "reviews": { "nullable": true, "type": "object", "properties": { "podcastId": { "type": "string" }, "appleId": { "type": "number" }, "spotifyId": { "nullable": true, "type": "string" }, "applePodcastsReview": { "nullable": true, "type": "object", "properties": { "appleId": { "type": "number" }, "scrapedAt": {}, "country": { "type": "string" }, "reviewsCount": { "type": "number" }, "rating": { "nullable": true, "type": "number" }, "oneStarCount": { "type": "number" }, "twoStarCount": { "type": "number" }, "threeStarCount": { "type": "number" }, "fourStarCount": { "type": "number" }, "fiveStarCount": { "type": "number" } }, "required": [ "appleId", "scrapedAt", "country", "reviewsCount", "rating", "oneStarCount", "twoStarCount", "threeStarCount", "fourStarCount", "fiveStarCount" ], "additionalProperties": false }, "spotifyReview": { "nullable": true, "type": "object", "properties": { "spotifyId": { "type": "string" }, "scrapedAt": {}, "reviewsCount": { "type": "number" }, "rating": { "nullable": true, "type": "number" } }, "required": [ "spotifyId", "scrapedAt", "reviewsCount", "rating" ], "additionalProperties": false }, "castbox": { "nullable": true, "type": "object", "properties": { "scrapedAt": {}, "plays": { "type": "number" }, "subscribers": { "type": "number" } }, "required": [ "scrapedAt", "plays", "subscribers" ], "additionalProperties": false } }, "required": [ "podcastId", "appleId", "spotifyId", "applePodcastsReview", "spotifyReview", "castbox" ], "additionalProperties": false }, "socialMedia": { "nullable": true, "type": "object", "properties": { "podcastId": { "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" ] }, "url": { "type": "string", "format": "uri" }, "sources": { "type": "array", "items": { "type": "string", "enum": [ "apple-podcasts", "bright-data-dataset", "google-search", "linktree", "podcast-website", "podchaser", "rephonic", "rss" ] } } }, "required": [ "socialMediaType", "url", "sources" ], "additionalProperties": false } }, "facebookPageData": { "type": "array", "items": { "type": "object", "properties": { "facebookPageId": { "type": "string" }, "profilePhotoUrl": { "nullable": true, "type": "string" }, "name": { "type": "string" }, "followers": { "type": "number", "minimum": 0 }, "likes": { "type": "number", "minimum": 0 }, "following": { "type": "number", "minimum": 0 }, "talkingAboutCount": { "nullable": true, "type": "number" }, "facebookPageUrl": { "type": "string" }, "scrapedAt": {} }, "required": [ "facebookPageId", "profilePhotoUrl", "name", "followers", "likes", "following", "talkingAboutCount", "facebookPageUrl", "scrapedAt" ], "additionalProperties": false } }, "instagramData": { "type": "array", "items": { "type": "object", "properties": { "profileId": { "type": "number" }, "followers": { "type": "number" }, "following": { "type": "number" }, "posts": { "type": "number" }, "instagramProfileName": { "type": "string" }, "profilePhotoUrl": { "nullable": true, "type": "string" }, "scrapedAt": {} }, "required": [ "profileId", "followers", "following", "posts", "instagramProfileName", "profilePhotoUrl", "scrapedAt" ], "additionalProperties": false } }, "linkedInCompanyData": { "type": "array", "items": { "type": "object", "properties": { "scrapedAt": {}, "linkedInCompanyId": { "type": "string" }, "linkedInUrl": { "type": "string" }, "name": { "type": "string" }, "countryCode": { "nullable": true, "type": "string" }, "followers": { "type": "number" }, "employeesInLinkedin": { "type": "number" }, "about": { "nullable": true, "type": "string" }, "description": { "nullable": true, "type": "string" }, "companySize": { "nullable": true, "type": "string" }, "industries": { "nullable": true, "type": "string" }, "logoImageUrl": { "nullable": true, "type": "string" }, "mostRecentUpdate": { "nullable": true, "type": "object", "properties": { "postId": { "type": "string" }, "likesCount": { "type": "number" }, "commentsCount": { "type": "number" }, "title": { "type": "string" }, "text": { "type": "string" }, "postUrl": { "type": "string" }, "date": {} }, "required": [ "postId", "likesCount", "commentsCount", "title", "text", "postUrl", "date" ], "additionalProperties": false } }, "required": [ "scrapedAt", "linkedInCompanyId", "linkedInUrl", "name", "countryCode", "followers", "employeesInLinkedin", "about", "description", "companySize", "industries", "logoImageUrl", "mostRecentUpdate" ], "additionalProperties": false } }, "linkedInPersonData": { "type": "array", "items": { "type": "object", "properties": { "scrapedAt": {}, "name": { "type": "string" }, "profilePhotoUrl": { "nullable": true, "type": "string" }, "linkedInProfileId": { "type": "string" }, "linkedInNumericId": { "type": "number" }, "avatarUrl": { "nullable": true, "type": "string" }, "city": { "nullable": true, "type": "string" }, "countryCode": { "nullable": true, "type": "string" }, "description": { "nullable": true, "type": "string" }, "about": { "nullable": true, "type": "string" }, "location": { "nullable": true, "type": "string" }, "followerCount": { "type": "number" }, "connectionsCount": { "type": "number" }, "recommendationsCount": { "type": "number" } }, "required": [ "scrapedAt", "name", "profilePhotoUrl", "linkedInProfileId", "linkedInNumericId", "avatarUrl", "city", "countryCode", "description", "about", "location", "followerCount", "connectionsCount", "recommendationsCount" ], "additionalProperties": false } }, "tiktokData": { "type": "array", "items": { "type": "object", "properties": { "accountId": { "type": "string" }, "awgEngagementRate": { "nullable": true, "type": "number" }, "biography": { "nullable": true, "type": "string" }, "commentEngagementRate": { "nullable": true, "type": "number" }, "dateJoined": {}, "followers": { "type": "number" }, "following": { "type": "number" }, "isPrivate": { "type": "boolean" }, "isVerified": { "type": "boolean" }, "likeEngagementRate": { "nullable": true, "type": "number" }, "likes": { "type": "number" }, "nickname": { "type": "string" }, "handle": { "type": "string" }, "profilePicUrl": { "nullable": true, "type": "string", "format": "uri" }, "videosCount": { "type": "number" }, "scrapedAt": {} }, "required": [ "accountId", "awgEngagementRate", "biography", "commentEngagementRate", "dateJoined", "followers", "following", "isPrivate", "isVerified", "likeEngagementRate", "likes", "nickname", "handle", "profilePicUrl", "videosCount", "scrapedAt" ], "additionalProperties": false } }, "twitterData": { "type": "array", "items": { "type": "object", "properties": { "profileId": { "type": "string" }, "profileName": { "type": "string" }, "profileUrl": { "type": "string", "format": "uri" }, "profileImageUrl": { "nullable": true, "type": "string", "format": "uri" }, "biography": { "nullable": true, "type": "string" }, "followingCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "followerCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "postsCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "dateJoined": { "nullable": true }, "scrapedAt": {} }, "required": [ "profileId", "profileName", "profileUrl", "profileImageUrl", "biography", "followingCount", "followerCount", "postsCount", "dateJoined", "scrapedAt" ], "additionalProperties": false } } }, "required": [ "podcastId", "socialMediaLinks", "facebookPageData", "instagramData", "linkedInCompanyData", "linkedInPersonData", "tiktokData", "twitterData" ], "additionalProperties": false }, "sponsors": { "nullable": true, "type": "object", "properties": { "episodesCount": { "type": "number" }, "episodesWithSponsorsCount": { "type": "number" }, "mostRecentEpisodeDate": {}, "oldestEpisodeDate": {}, "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 }, "relatedPodcasts": { "nullable": true, "type": "object", "properties": { "podcastId": { "type": "string" }, "similarPodcasts": { "type": "array", "items": { "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 } } }, "required": [ "podcastId", "similarPodcasts" ], "additionalProperties": false }, "chartPositions": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "chartDate": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "description": "The date of the chart in YYYY-MM-DD format" }, "chartType": { "type": "string", "enum": [ "apple", "spotify" ], "description": "The type of chart, one of apple, spotify" }, "country": { "type": "string", "description": "The country of the chart in ISO 3166-1 alpha-2 format, for example \"us\". Defaults to us." }, "category": { "type": "string", "description": "The chart category defaulting to 'top podcasts'. Apple podcasts supports the following: \"top podcasts\", \"arts\", \"business\", \"comedy\", \"education\", \"fiction\", \"government\", \"health & fitness\", \"history\", \"kids & family\", \"leisure\", \"music\", \"news\", \"religion & spirituality\", \"science\", \"society & culture\", \"sports\", \"technology\", \"true crime\", \"tv & film\"" }, "position": { "type": "number" } }, "required": [ "chartDate", "chartType", "country", "category", "position" ], "additionalProperties": false } }, "youtubeData": { "nullable": true, "type": "object", "properties": { "podcastId": { "type": "string" }, "youtubeData": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "description": { "nullable": true, "type": "string" }, "subscriberCount": { "type": "number" }, "viewCount": { "type": "number" }, "videoCount": { "type": "number" }, "publishedAt": { "nullable": true }, "thumbnails": { "type": "object", "properties": { "default": { "nullable": true, "type": "string" }, "medium": { "nullable": true, "type": "string" }, "high": { "nullable": true, "type": "string" } }, "required": [ "default", "medium", "high" ], "additionalProperties": false }, "country": { "nullable": true, "type": "string" }, "customUrl": { "nullable": true, "type": "string" }, "links": { "nullable": true, "type": "array", "items": { "type": "string" } }, "isPodcastChannel": { "nullable": true, "type": "boolean" }, "discoverInputKeyword": { "nullable": true, "type": "string" }, "bannerImageUrl": { "nullable": true, "type": "string" }, "videos": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "imageUrl": { "type": "string" }, "isShort": { "type": "boolean" }, "postedAt": {}, "postedAtRelative": { "type": "string" }, "scrapedAt": {}, "title": { "type": "string" }, "videoUrl": { "type": "string" }, "views": { "type": "number" } }, "required": [ "imageUrl", "isShort", "postedAt", "postedAtRelative", "scrapedAt", "title", "videoUrl", "views" ], "additionalProperties": false } }, "profileImageUrl": { "nullable": true, "type": "string" }, "dataLastUpdated": {}, "lastVideoUploadDate": { "nullable": true }, "lastVideoUploadDateSource": { "nullable": true, "type": "string" }, "lastVideoUploadDateCheckedAt": { "nullable": true } }, "required": [ "id", "title", "description", "subscriberCount", "viewCount", "videoCount", "publishedAt", "thumbnails", "country", "customUrl", "links", "isPodcastChannel", "discoverInputKeyword", "bannerImageUrl", "videos", "profileImageUrl", "dataLastUpdated", "lastVideoUploadDate", "lastVideoUploadDateSource", "lastVideoUploadDateCheckedAt" ], "additionalProperties": false } } }, "required": [ "podcastId", "youtubeData" ], "additionalProperties": false } }, "required": [ "podcast", "recentEpisodes", "contacts", "guests", "reviews", "socialMedia", "sponsors", "relatedPodcasts", "chartPositions", "youtubeData" ], "additionalProperties": false } }, "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