Pod Engine API v1.0

S3 Integration - Podcasts

Pod Engine can sync podcast data via an S3 file based integration. This is available for our enterprise customers.

How Schema Versioning Works

All documents will always include the following fields:

schema_versionnumberrequired

The numeric version of the schema. Starts at 1, and increments with each new version.

Schema Versions

Version Release Date Description
7 9/13/2026 Populates the audience_estimate_* fields and removes the experimental audience_monthly_consumption breakdown. View Schema
6 9/10/2026 Adds the active English-language monthly audience estimate shared with the website and API. View Schema
5 8/13/2026 Adds audience estimation fields (estimated monthly listeners, confidence) and OP3 measured download fields, published ahead of the audience estimation launch so consumers can prepare ingestion. All new fields are null until the estimation pipeline ships. View Schema
4 9/24/2025 Adds fields for automatic and manual soft deletion of podcasts. View Schema
3 9/30/2025 Clarifies and updates how podcast_rss_title changes are handled. View Schema
2 7/20/2025 Adds the calculated update frequency to the podcast. View Schema
1 6/30/2025 Initial release with basic metadata, basic analysis, authority score, youtube data, chart data, and social data View Schema

Schema Details

Version 7Latest
Released on 9/13/2026

Changelog

  • Removed audience_monthly_consumption
  • audience_estimate_monthly_listeners, audience_estimate_confidence, audience_estimate_is_dormant, audience_estimate_last_calculated and audience_estimate_model_version are now populated
schema_versionnumberrequired

The numeric version of the schema. Starts at 1, and increments with each new version.

apple_idnumberrequired

The unique apple id for the podcast.

apple_podcasts_data_last_updateddaterequired

The date we last scraped the apple podcasts rating.

apple_podcasts_ratingnumberrequirednullable

The rating of the podcast on apple podcasts. Null means there are no ratings

apple_podcasts_ratings_countnumberrequired

The number of ratings the podcast has on apple podcasts.

audience_estimate_confidenceenumrequirednullable

The confidence tier of the audience estimate. Confidence reflects how well each source is measured, weighted by how much of the estimate it supplies. Audio uses the model prediction band (high under x50, medium x50-x200, low x200 and over) or measured OP3 downloads (high). YouTube is high only for measured 30-day view gains on a verified channel covering at least 80% of recent episodes, medium for a verified channel covering at least half, otherwise low. Null means no estimate is available for this podcast.

highmediumlow
audience_estimate_is_dormantbooleanrequirednullable

True means the podcast has not published a new episode in the last 90 days; estimates are only published for active podcasts, so a dormant podcast has a null estimate. Null means we have not evaluated this podcast.

audience_estimate_last_calculateddaterequirednullable

The date the published audience estimate was last calculated. Null means no estimate is available for this podcast.

audience_estimate_model_versionstringrequirednullable

The version of the Pod Engine audience estimation model that produced the audio component of the estimate. Null when the estimate has no modeled audio component or no estimate is available.

audience_estimate_monthly_listenersnumberrequirednullable

Pod Engine's estimated monthly audience for the podcast, rounded to the nearest 1,000: modeled or measured audio downloads plus qualified YouTube views over 30 days. Null means no estimate is available for this podcast.

auto_soft_deletedbooleanrequired

Whether the podcast has automatically been automatically soft deleted by the system. Common reasons for this include a dead podcast with only a few episodes, ai-generated podcasts, spam, etc.

auto_soft_deleted_reasonstringrequirednullable

The reason the podcast was automatically soft deleted.

automatic_transcriptionsbooleanrequired

True means we automatically transcribe all new episodes of this podcast

castbox_data_last_updateddaterequirednullable

The date we last scraped the castbox data. Null means we have not scraped this data yet.

castbox_playsnumberrequirednullable

The number of plays the podcast has on castbox. Null means we have not scraped this data yet.

castbox_subscribersnumberrequirednullable

The number of subscribers the podcast has on castbox. Null means we have not scraped this data yet.

chart_positionsarray of objectrequired10 fields
datestringrequired

The date of the chart position in YYYY-MM-DD format.

chart_typestringrequired

The type of chart (e.g., "apple", "spotify").

country_codestringrequired

The ISO country code where this chart position applies.

categorystringrequired

The main category of the chart (e.g., "top podcasts").

sub_categorystringrequirednullable

The sub-category of the chart, if applicable.

positionnumberrequired

The current position of the podcast on the chart.

previous_positionnumberrequirednullable

The previous position of the podcast on the chart.

position_changenumberrequirednullable

The change in position from the previous chart (positive = moved up, negative = moved down).

total_days_in_chartnumberrequired

The total number of days the podcast has been on this chart.

days_streak_countnumberrequired

The number of consecutive days the podcast has been on this chart.

manual_soft_deletedbooleanrequired

Whether the podcast has been manually soft deleted by a Pod Engine administrator. Common reasons for this include requests from the rights holder, spam, etc.

manual_soft_deleted_reasonstringrequirednullable

The reason the podcast was manually soft deleted.

op3_data_last_updateddaterequirednullable

The date we last synced OP3 download data for the podcast. Null means the podcast does not use OP3 or we have not synced its OP3 data yet.

op3_downloads_last_30_daysnumberrequirednullable

The measured number of downloads over the last 30 days as reported by OP3 (op3.dev), the open podcast analytics service. Only available for podcasts that route their audio through OP3. Unlike the audience estimate fields this is measured data, not an estimate. Null means the podcast does not use OP3 or we have not synced its OP3 data yet.

podcast_affiliation_organization_namestringrequirednullable

The name of the organization that the podcast is affiliated with. This is a calculated field and null means we have not detected any affiliation.

podcast_affiliation_typeenumrequirednullable

The type of affiliation the podcast has from the options. This is a calculated field and null means we have not detected any affiliation.

academicbrandedcelebritygovernmentindependentlegacy mediapodcast companynew medianot for profitreligiousotherunknown
podcast_authority_score_engagementnumberrequirednullable0 – 100

The authority score between 0-100 of the podcast for engagement. This is one component of the total score. Null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_authority_score_qualitynumberrequirednullable0 – 100

The authority score between 0-100 of the podcast for quality. This is one component of the total score. Null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_authority_score_socialnumberrequirednullable0 – 100

The authority score between 0-100 of the podcast for social. This is one component of the total score. Null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_authority_score_totalnumberrequirednullable0 – 100

The total authority score between 0-100 of the podcast. This is calculated using the combined values of the other authority score fields and null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_authority_score_youtubenumberrequirednullable0 – 100

The authority score of the podcast for youtube. This is one component of the total score. Null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_calculated_update_frequencyenumrequired

The calculated update frequency of the podcast.

dailyweeklybi-weeklymonthlystalevery-stale
podcast_emailsarray of stringrequired

All emails we have detected for the podcast.

podcast_founded_datedaterequirednullable

The date the podcast was founded. This is typically the date of the first episode but for some very old podcasts it might be calculated from external data sources. Null when no episode date is known.

podcast_has_guestsbooleanrequirednullable

Pod Engine's calculation of whether the podcast has guests. Null means we have not calculated this yet.

podcast_has_sponsorsbooleanrequirednullable

Pod Engine's calculation of whether the podcast has sponsors. Null means we have not calculated this yet.

podcast_host_namesarray of stringrequired

The names of the hosts of the podcast.

podcast_languagestringrequired

The language of the podcast as a ISO 639-1 code.

podcast_last_episode_datedaterequirednullable

The date of the most recent episode in the podcast. Null when no episode date is known.

podcast_rss_apple_categoriesarray of stringrequired

The lower case normalized apple podcast categories as they are in the RSS. Subcategories appear with a : in the format main:subcategory. List of categories is here https://podcasters.apple.com/support/1691-apple-podcasts-categories

podcast_rss_authorstringrequirednullable

The author of the podcast as it appears in the RSS feed.

podcast_rss_descriptionstringrequirednullable

The description of the podcast as it appears in the RSS feed. This may include HTML. Null when no description is available.

podcast_rss_feed_urlstringrequiredurl

The URL of the podcast's RSS feed.

podcast_rss_image_urlstringrequirednullableurl

The URL of the podcast image as it appears in the RSS feed.

podcast_rss_titlestringrequired

This is the original title of the podcast as it first appeared in the RSS feed when Pod Engine first added the podcast.

podcast_rss_title_lateststringrequirednullable

The title of the latest episode in the podcast RSS feed.

podcast_rss_title_latest_cleanedstringrequirednullable

This is a generated field where we take the podcast rss title and remove any marketing fluff, unnecessary punctuation, etc to make it more human sounding and natural.

podcast_websitesarray of stringrequired

All websites we have detected and validated for the podcast.

podengine_idstringrequireduuid

The unique Pod Engine uuid for the podcast.

podengine_slugstringrequired

The unique Pod Engine slug for the podcast. Can be used to link directly to the podcast on Pod Engine.

podengine_thumbnail_urlstringrequirednullableurl

The URL of the podcast thumbnail image that has been processed by Pod Engine and stored in our CDN

similar_podcastsarray of objectrequired4 fields

Similar podcasts to the current podcast. This data is pulled from Apple Podcasts

podengine_idstringrequireduuid

The unique Pod Engine uuid for the podcast.

podcast_rss_titlestringrequired

The title of the podcast.

podcast_thumbnail_urlstringrequirednullableurl

The URL of the podcast thumbnail image.

podengine_slugstringrequired

The unique Pod Engine slug for the podcast. Can be used to link directly to the podcast on Pod Engine.

socials_facebookarray of objectrequired9 fields
idstringrequired

The unique Facebook page ID.

namestringrequired

The name of the Facebook page.

followers_countnumberrequired

The number of followers the Facebook page has.

likes_countnumberrequired

The number of likes the Facebook page has.

following_countnumberrequired

The number of pages this Facebook page is following.

talking_about_countnumberrequired

The number of people talking about this Facebook page.

image_urlstringrequirednullable

The URL of the Facebook page profile image.

urlstringrequired

The URL of the Facebook page.

data_last_updateddaterequired

The date when this Facebook page data was last updated.

socials_instagramarray of objectrequired7 fields
idstringrequired

The unique Instagram profile ID.

usernamestringrequired

The Instagram username/handle.

followers_countnumberrequired

The number of followers the Instagram profile has.

following_countnumberrequired

The number of accounts this Instagram profile is following.

posts_countnumberrequired

The number of posts the Instagram profile has.

image_urlstringrequirednullable

The URL of the Instagram profile image.

data_last_updateddaterequired

The date when this Instagram profile data was last updated.

socials_linkedin_companyarray of objectrequired11 fields
idstringrequired

The unique LinkedIn company ID.

namestringrequired

The name of the LinkedIn company.

aboutstringrequirednullable

The "About" section text of the LinkedIn company.

descriptionstringrequirednullable

The description of the LinkedIn company.

company_sizestringrequirednullable

The size of the company (e.g., "11-50 employees").

country_codestringrequirednullable

The ISO country code where the company is located.

industriesstringrequirednullable

The industries the company operates in.

followers_countnumberrequired

The number of followers the LinkedIn company has.

employees_countnumberrequired

The number of employees at the company.

image_urlstringrequirednullable

The URL of the LinkedIn company logo/image.

data_last_updateddaterequired

The date when this LinkedIn company data was last updated.

socials_linkedin_personarray of objectrequired9 fields
idstringrequired

The unique LinkedIn person ID.

namestringrequired

The name of the LinkedIn person.

aboutstringrequirednullable

The "About" section text of the LinkedIn person.

descriptionstringrequirednullable

The description of the LinkedIn person.

followers_countnumberrequired

The number of followers the LinkedIn person has.

connections_countnumberrequired

The number of connections the LinkedIn person has.

country_codestringrequirednullable

The ISO country code where the person is located.

image_urlstringrequirednullable

The URL of the LinkedIn person profile image.

data_last_updateddaterequired

The date when this LinkedIn person data was last updated.

socials_tiktokarray of objectrequired9 fields
idstringrequired

The unique TikTok profile ID.

handlestringrequired

The TikTok handle/username.

profile_namestringrequired

The display name of the TikTok profile.

biographystringrequirednullable

The biography text of the TikTok profile.

followers_countnumberrequired

The number of followers the TikTok profile has.

following_countnumberrequired

The number of accounts this TikTok profile is following.

likes_countnumberrequired

The number of likes the TikTok profile has received.

image_urlstringrequirednullable

The URL of the TikTok profile image.

data_last_updateddaterequired

The date when this TikTok profile data was last updated.

socials_twitterarray of objectrequired9 fields
idstringrequired

The unique Twitter profile ID.

date_joineddaterequirednullable

The date when the Twitter account was created.

biographystringrequirednullable

The biography text of the Twitter profile.

handlestringrequired

The Twitter handle/username.

followers_countnumberrequired

The number of followers the Twitter profile has.

following_countnumberrequired

The number of accounts this Twitter profile is following.

posts_countnumberrequired

The number of posts/tweets the Twitter profile has.

image_urlstringrequirednullable

The URL of the Twitter profile image.

data_last_updateddaterequired

The date when this Twitter profile data was last updated.

spotify_data_last_updateddaterequirednullable

The date we last scraped the spotify data. Null means we have not scraped this data yet.

spotify_idstringrequirednullable

The unique spotify id for the podcast.

spotify_ratingnumberrequirednullable

The rating of the podcast on spotify. Null means there are no ratings or we have not scraped this data yet.

spotify_ratings_countnumberrequirednullable

The number of ratings the podcast has on spotify. Null means there are no ratings or we have not scraped this data yet.

total_episodesnumberrequired

The total number of episodes in the podcast.

total_transcriptsnumberrequired

The total number of transcripts we have generated for the podcast.

youtube_channelsarray of objectrequired10 fields
channel_data_last_updateddaterequired

The date we last scraped the youtube channel data.

channel_descriptionstringrequirednullable

The description of the youtube channel.

channel_handlestringrequirednullable

The handle of the youtube channel.

channel_idstringrequired

The id of the youtube channel.

channel_titlestringrequirednullable

The title of the youtube channel.

channel_published_datedaterequirednullable

The date the youtube channel was published.

total_subscribersnumberrequired

The number of subscribers the youtube channel has.

total_videosnumberrequired

The number of videos the youtube channel has.

total_viewsnumberrequired

The number of views the youtube channel has.

average_views_per_videonumberrequired

The average number of views per video on the youtube channel. For video-first podcasts this is a strong public signal of actual audience size and is one of the inputs to the audience estimate.

Version 6
Released on 9/10/2026

Changelog

  • Added audience_monthly_consumption with component values, sources, coverage and calculation date. Legacy listener fields remain null.
schema_versionnumberrequired

The numeric version of the schema. Starts at 1, and increments with each new version.

apple_idnumberrequired

The unique apple id for the podcast.

apple_podcasts_data_last_updateddaterequired

The date we last scraped the apple podcasts rating.

apple_podcasts_ratingnumberrequirednullable

The rating of the podcast on apple podcasts. Null means there are no ratings

apple_podcasts_ratings_countnumberrequired

The number of ratings the podcast has on apple podcasts.

audience_estimate_confidenceenumrequirednullable

The confidence tier of the audience estimate. Confidence reflects how well each source is measured, weighted by how much of the estimate it supplies. Audio uses the model prediction band (high under x50, medium x50-x200, low x200 and over) or measured OP3 downloads (high). YouTube is high only for measured 30-day view gains on a verified channel covering at least 80% of recent episodes, medium for a verified channel covering at least half, otherwise low. Null means no estimate is available for this podcast.

highmediumlow
audience_estimate_is_dormantbooleanrequirednullable

True means the podcast has not published a new episode in the last 90 days; estimates are only published for active podcasts, so a dormant podcast has a null estimate. Null means we have not evaluated this podcast.

audience_estimate_last_calculateddaterequirednullable

The date the published audience estimate was last calculated. Null means no estimate is available for this podcast.

audience_estimate_model_versionstringrequirednullable

The version of the Pod Engine audience estimation model that produced the audio component of the estimate. Null when the estimate has no modeled audio component or no estimate is available.

audience_estimate_monthly_listenersnumberrequirednullable

Pod Engine's estimated monthly audience for the podcast, rounded to the nearest 1,000: modeled or measured audio downloads plus qualified YouTube views over 30 days. Null means no estimate is available for this podcast.

audience_monthly_consumptionobjectrequired10 fields

Experimental monthly audience: audio downloads plus available YouTube views. Audiences may overlap. Active English-language podcasts only; null components mean unavailable.

schemaVersionliteral: 1required
eligibilityenum
eligiblelanguage_out_of_scopeno_recent_episode
policyVersionliteral: active-english-90d-v1
calculatedAsOfstringdatetime
audioobjectrequired7 fields
valuenumberrequirednullable0 – 9007199254740991
basisenumrequired
op3_measuredexperimental_audio_modelmeasured_counter_gainsexperimental_90_day_views_divided_by_3unavailable
asOfstringrequirednullabledatetime
unitliteral: downloadsrequired
p10numberrequirednullable0 – 9007199254740991
p90numberrequirednullable0 – 9007199254740991
modelVersionstringrequirednullable
youtubeobjectrequired9 fields
valuenumberrequirednullable0 – 9007199254740991
basisenumrequired
op3_measuredexperimental_audio_modelmeasured_counter_gainsexperimental_90_day_views_divided_by_3unavailable
asOfstringrequirednullabledatetime
unitliteral: viewsrequired
qualifiedVideosnumberrequired0 – 9007199254740991
measuredVideosnumberrequired0 – 9007199254740991
estimatedVideosnumberrequired0 – 9007199254740991
measuredPartialViewsnumberrequirednullable0 – 9007199254740991
periodsarray of objectrequired5 fields
videoIdstringrequired
startstringrequireddatetime
endstringrequireddatetime
elapsedDaysnumberrequiredmin 0
viewsnumberrequired0 – 9007199254740991
provisionalMonthlyTotalnumberrequirednullable0 – 9007199254740991
unitliteral: audio_downloads_plus_youtube_viewsrequired
coverageenumrequired
audio_and_partial_youtubeaudio_onlypartial_youtube_onlyunavailable
uniqueListenersunknownrequired
auto_soft_deletedbooleanrequired

Whether the podcast has automatically been automatically soft deleted by the system. Common reasons for this include a dead podcast with only a few episodes, ai-generated podcasts, spam, etc.

auto_soft_deleted_reasonstringrequirednullable

The reason the podcast was automatically soft deleted.

automatic_transcriptionsbooleanrequired

True means we automatically transcribe all new episodes of this podcast

castbox_data_last_updateddaterequirednullable

The date we last scraped the castbox data. Null means we have not scraped this data yet.

castbox_playsnumberrequirednullable

The number of plays the podcast has on castbox. Null means we have not scraped this data yet.

castbox_subscribersnumberrequirednullable

The number of subscribers the podcast has on castbox. Null means we have not scraped this data yet.

chart_positionsarray of objectrequired10 fields
datestringrequired

The date of the chart position in YYYY-MM-DD format.

chart_typestringrequired

The type of chart (e.g., "apple", "spotify").

country_codestringrequired

The ISO country code where this chart position applies.

categorystringrequired

The main category of the chart (e.g., "top podcasts").

sub_categorystringrequirednullable

The sub-category of the chart, if applicable.

positionnumberrequired

The current position of the podcast on the chart.

previous_positionnumberrequirednullable

The previous position of the podcast on the chart.

position_changenumberrequirednullable

The change in position from the previous chart (positive = moved up, negative = moved down).

total_days_in_chartnumberrequired

The total number of days the podcast has been on this chart.

days_streak_countnumberrequired

The number of consecutive days the podcast has been on this chart.

manual_soft_deletedbooleanrequired

Whether the podcast has been manually soft deleted by a Pod Engine administrator. Common reasons for this include requests from the rights holder, spam, etc.

manual_soft_deleted_reasonstringrequirednullable

The reason the podcast was manually soft deleted.

op3_data_last_updateddaterequirednullable

The date we last synced OP3 download data for the podcast. Null means the podcast does not use OP3 or we have not synced its OP3 data yet.

op3_downloads_last_30_daysnumberrequirednullable

The measured number of downloads over the last 30 days as reported by OP3 (op3.dev), the open podcast analytics service. Only available for podcasts that route their audio through OP3. Unlike the audience estimate fields this is measured data, not an estimate. Null means the podcast does not use OP3 or we have not synced its OP3 data yet.

podcast_affiliation_organization_namestringrequirednullable

The name of the organization that the podcast is affiliated with. This is a calculated field and null means we have not detected any affiliation.

podcast_affiliation_typeenumrequirednullable

The type of affiliation the podcast has from the options. This is a calculated field and null means we have not detected any affiliation.

academicbrandedcelebritygovernmentindependentlegacy mediapodcast companynew medianot for profitreligiousotherunknown
podcast_authority_score_engagementnumberrequirednullable0 – 100

The authority score between 0-100 of the podcast for engagement. This is one component of the total score. Null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_authority_score_qualitynumberrequirednullable0 – 100

The authority score between 0-100 of the podcast for quality. This is one component of the total score. Null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_authority_score_socialnumberrequirednullable0 – 100

The authority score between 0-100 of the podcast for social. This is one component of the total score. Null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_authority_score_totalnumberrequirednullable0 – 100

The total authority score between 0-100 of the podcast. This is calculated using the combined values of the other authority score fields and null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_authority_score_youtubenumberrequirednullable0 – 100

The authority score of the podcast for youtube. This is one component of the total score. Null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_calculated_update_frequencyenumrequired

The calculated update frequency of the podcast.

dailyweeklybi-weeklymonthlystalevery-stale
podcast_emailsarray of stringrequired

All emails we have detected for the podcast.

podcast_founded_datedaterequirednullable

The date the podcast was founded. This is typically the date of the first episode but for some very old podcasts it might be calculated from external data sources. Null when no episode date is known.

podcast_has_guestsbooleanrequirednullable

Pod Engine's calculation of whether the podcast has guests. Null means we have not calculated this yet.

podcast_has_sponsorsbooleanrequirednullable

Pod Engine's calculation of whether the podcast has sponsors. Null means we have not calculated this yet.

podcast_host_namesarray of stringrequired

The names of the hosts of the podcast.

podcast_languagestringrequired

The language of the podcast as a ISO 639-1 code.

podcast_last_episode_datedaterequirednullable

The date of the most recent episode in the podcast. Null when no episode date is known.

podcast_rss_apple_categoriesarray of stringrequired

The lower case normalized apple podcast categories as they are in the RSS. Subcategories appear with a : in the format main:subcategory. List of categories is here https://podcasters.apple.com/support/1691-apple-podcasts-categories

podcast_rss_authorstringrequirednullable

The author of the podcast as it appears in the RSS feed.

podcast_rss_descriptionstringrequirednullable

The description of the podcast as it appears in the RSS feed. This may include HTML. Null when no description is available.

podcast_rss_feed_urlstringrequiredurl

The URL of the podcast's RSS feed.

podcast_rss_image_urlstringrequirednullableurl

The URL of the podcast image as it appears in the RSS feed.

podcast_rss_titlestringrequired

This is the original title of the podcast as it first appeared in the RSS feed when Pod Engine first added the podcast.

podcast_rss_title_lateststringrequirednullable

The title of the latest episode in the podcast RSS feed.

podcast_rss_title_latest_cleanedstringrequirednullable

This is a generated field where we take the podcast rss title and remove any marketing fluff, unnecessary punctuation, etc to make it more human sounding and natural.

podcast_websitesarray of stringrequired

All websites we have detected and validated for the podcast.

podengine_idstringrequireduuid

The unique Pod Engine uuid for the podcast.

podengine_slugstringrequired

The unique Pod Engine slug for the podcast. Can be used to link directly to the podcast on Pod Engine.

podengine_thumbnail_urlstringrequirednullableurl

The URL of the podcast thumbnail image that has been processed by Pod Engine and stored in our CDN

similar_podcastsarray of objectrequired4 fields

Similar podcasts to the current podcast. This data is pulled from Apple Podcasts

podengine_idstringrequireduuid

The unique Pod Engine uuid for the podcast.

podcast_rss_titlestringrequired

The title of the podcast.

podcast_thumbnail_urlstringrequirednullableurl

The URL of the podcast thumbnail image.

podengine_slugstringrequired

The unique Pod Engine slug for the podcast. Can be used to link directly to the podcast on Pod Engine.

socials_facebookarray of objectrequired9 fields
idstringrequired

The unique Facebook page ID.

namestringrequired

The name of the Facebook page.

followers_countnumberrequired

The number of followers the Facebook page has.

likes_countnumberrequired

The number of likes the Facebook page has.

following_countnumberrequired

The number of pages this Facebook page is following.

talking_about_countnumberrequired

The number of people talking about this Facebook page.

image_urlstringrequirednullable

The URL of the Facebook page profile image.

urlstringrequired

The URL of the Facebook page.

data_last_updateddaterequired

The date when this Facebook page data was last updated.

socials_instagramarray of objectrequired7 fields
idstringrequired

The unique Instagram profile ID.

usernamestringrequired

The Instagram username/handle.

followers_countnumberrequired

The number of followers the Instagram profile has.

following_countnumberrequired

The number of accounts this Instagram profile is following.

posts_countnumberrequired

The number of posts the Instagram profile has.

image_urlstringrequirednullable

The URL of the Instagram profile image.

data_last_updateddaterequired

The date when this Instagram profile data was last updated.

socials_linkedin_companyarray of objectrequired11 fields
idstringrequired

The unique LinkedIn company ID.

namestringrequired

The name of the LinkedIn company.

aboutstringrequirednullable

The "About" section text of the LinkedIn company.

descriptionstringrequirednullable

The description of the LinkedIn company.

company_sizestringrequirednullable

The size of the company (e.g., "11-50 employees").

country_codestringrequirednullable

The ISO country code where the company is located.

industriesstringrequirednullable

The industries the company operates in.

followers_countnumberrequired

The number of followers the LinkedIn company has.

employees_countnumberrequired

The number of employees at the company.

image_urlstringrequirednullable

The URL of the LinkedIn company logo/image.

data_last_updateddaterequired

The date when this LinkedIn company data was last updated.

socials_linkedin_personarray of objectrequired9 fields
idstringrequired

The unique LinkedIn person ID.

namestringrequired

The name of the LinkedIn person.

aboutstringrequirednullable

The "About" section text of the LinkedIn person.

descriptionstringrequirednullable

The description of the LinkedIn person.

followers_countnumberrequired

The number of followers the LinkedIn person has.

connections_countnumberrequired

The number of connections the LinkedIn person has.

country_codestringrequirednullable

The ISO country code where the person is located.

image_urlstringrequirednullable

The URL of the LinkedIn person profile image.

data_last_updateddaterequired

The date when this LinkedIn person data was last updated.

socials_tiktokarray of objectrequired9 fields
idstringrequired

The unique TikTok profile ID.

handlestringrequired

The TikTok handle/username.

profile_namestringrequired

The display name of the TikTok profile.

biographystringrequirednullable

The biography text of the TikTok profile.

followers_countnumberrequired

The number of followers the TikTok profile has.

following_countnumberrequired

The number of accounts this TikTok profile is following.

likes_countnumberrequired

The number of likes the TikTok profile has received.

image_urlstringrequirednullable

The URL of the TikTok profile image.

data_last_updateddaterequired

The date when this TikTok profile data was last updated.

socials_twitterarray of objectrequired9 fields
idstringrequired

The unique Twitter profile ID.

date_joineddaterequirednullable

The date when the Twitter account was created.

biographystringrequirednullable

The biography text of the Twitter profile.

handlestringrequired

The Twitter handle/username.

followers_countnumberrequired

The number of followers the Twitter profile has.

following_countnumberrequired

The number of accounts this Twitter profile is following.

posts_countnumberrequired

The number of posts/tweets the Twitter profile has.

image_urlstringrequirednullable

The URL of the Twitter profile image.

data_last_updateddaterequired

The date when this Twitter profile data was last updated.

spotify_data_last_updateddaterequirednullable

The date we last scraped the spotify data. Null means we have not scraped this data yet.

spotify_idstringrequirednullable

The unique spotify id for the podcast.

spotify_ratingnumberrequirednullable

The rating of the podcast on spotify. Null means there are no ratings or we have not scraped this data yet.

spotify_ratings_countnumberrequirednullable

The number of ratings the podcast has on spotify. Null means there are no ratings or we have not scraped this data yet.

total_episodesnumberrequired

The total number of episodes in the podcast.

total_transcriptsnumberrequired

The total number of transcripts we have generated for the podcast.

youtube_channelsarray of objectrequired10 fields
channel_data_last_updateddaterequired

The date we last scraped the youtube channel data.

channel_descriptionstringrequirednullable

The description of the youtube channel.

channel_handlestringrequirednullable

The handle of the youtube channel.

channel_idstringrequired

The id of the youtube channel.

channel_titlestringrequirednullable

The title of the youtube channel.

channel_published_datedaterequirednullable

The date the youtube channel was published.

total_subscribersnumberrequired

The number of subscribers the youtube channel has.

total_videosnumberrequired

The number of videos the youtube channel has.

total_viewsnumberrequired

The number of views the youtube channel has.

average_views_per_videonumberrequired

The average number of views per video on the youtube channel. For video-first podcasts this is a strong public signal of actual audience size and is one of the inputs to the audience estimate.

Version 5
Released on 8/13/2026

Changelog

  • Added audience_estimate_monthly_listeners field
  • Added audience_estimate_confidence field
  • Added audience_estimate_is_dormant field
  • Added audience_estimate_last_calculated field
  • Added audience_estimate_model_version field
  • Added op3_data_last_updated field
  • Added op3_downloads_last_30_days field
  • Added average_views_per_video to youtube_channels entries
schema_versionnumberrequired

The numeric version of the schema. Starts at 1, and increments with each new version.

apple_idnumberrequired

The unique apple id for the podcast.

apple_podcasts_data_last_updateddaterequired

The date we last scraped the apple podcasts rating.

apple_podcasts_ratingnumberrequirednullable

The rating of the podcast on apple podcasts. Null means there are no ratings

apple_podcasts_ratings_countnumberrequired

The number of ratings the podcast has on apple podcasts.

audience_estimate_confidenceenumrequirednullable

The confidence tier of the audience estimate. Confidence reflects how well each source is measured, weighted by how much of the estimate it supplies. Audio uses the model prediction band (high under x50, medium x50-x200, low x200 and over) or measured OP3 downloads (high). YouTube is high only for measured 30-day view gains on a verified channel covering at least 80% of recent episodes, medium for a verified channel covering at least half, otherwise low. Null means no estimate is available for this podcast.

highmediumlow
audience_estimate_is_dormantbooleanrequirednullable

True means the podcast has not published a new episode in the last 90 days; estimates are only published for active podcasts, so a dormant podcast has a null estimate. Null means we have not evaluated this podcast.

audience_estimate_last_calculateddaterequirednullable

The date the published audience estimate was last calculated. Null means no estimate is available for this podcast.

audience_estimate_model_versionstringrequirednullable

The version of the Pod Engine audience estimation model that produced the audio component of the estimate. Null when the estimate has no modeled audio component or no estimate is available.

audience_estimate_monthly_listenersnumberrequirednullable

Pod Engine's estimated monthly audience for the podcast, rounded to the nearest 1,000: modeled or measured audio downloads plus qualified YouTube views over 30 days. Null means no estimate is available for this podcast.

auto_soft_deletedbooleanrequired

Whether the podcast has automatically been automatically soft deleted by the system. Common reasons for this include a dead podcast with only a few episodes, ai-generated podcasts, spam, etc.

auto_soft_deleted_reasonstringrequirednullable

The reason the podcast was automatically soft deleted.

automatic_transcriptionsbooleanrequired

True means we automatically transcribe all new episodes of this podcast

castbox_data_last_updateddaterequirednullable

The date we last scraped the castbox data. Null means we have not scraped this data yet.

castbox_playsnumberrequirednullable

The number of plays the podcast has on castbox. Null means we have not scraped this data yet.

castbox_subscribersnumberrequirednullable

The number of subscribers the podcast has on castbox. Null means we have not scraped this data yet.

chart_positionsarray of objectrequired10 fields
datestringrequired

The date of the chart position in YYYY-MM-DD format.

chart_typestringrequired

The type of chart (e.g., "apple", "spotify").

country_codestringrequired

The ISO country code where this chart position applies.

categorystringrequired

The main category of the chart (e.g., "top podcasts").

sub_categorystringrequirednullable

The sub-category of the chart, if applicable.

positionnumberrequired

The current position of the podcast on the chart.

previous_positionnumberrequirednullable

The previous position of the podcast on the chart.

position_changenumberrequirednullable

The change in position from the previous chart (positive = moved up, negative = moved down).

total_days_in_chartnumberrequired

The total number of days the podcast has been on this chart.

days_streak_countnumberrequired

The number of consecutive days the podcast has been on this chart.

manual_soft_deletedbooleanrequired

Whether the podcast has been manually soft deleted by a Pod Engine administrator. Common reasons for this include requests from the rights holder, spam, etc.

manual_soft_deleted_reasonstringrequirednullable

The reason the podcast was manually soft deleted.

op3_data_last_updateddaterequirednullable

The date we last synced OP3 download data for the podcast. Null means the podcast does not use OP3 or we have not synced its OP3 data yet.

op3_downloads_last_30_daysnumberrequirednullable

The measured number of downloads over the last 30 days as reported by OP3 (op3.dev), the open podcast analytics service. Only available for podcasts that route their audio through OP3. Unlike the audience estimate fields this is measured data, not an estimate. Null means the podcast does not use OP3 or we have not synced its OP3 data yet.

podcast_affiliation_organization_namestringrequirednullable

The name of the organization that the podcast is affiliated with. This is a calculated field and null means we have not detected any affiliation.

podcast_affiliation_typeenumrequirednullable

The type of affiliation the podcast has from the options. This is a calculated field and null means we have not detected any affiliation.

academicbrandedcelebritygovernmentindependentlegacy mediapodcast companynew medianot for profitreligiousotherunknown
podcast_authority_score_engagementnumberrequirednullable0 – 100

The authority score between 0-100 of the podcast for engagement. This is one component of the total score. Null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_authority_score_qualitynumberrequirednullable0 – 100

The authority score between 0-100 of the podcast for quality. This is one component of the total score. Null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_authority_score_socialnumberrequirednullable0 – 100

The authority score between 0-100 of the podcast for social. This is one component of the total score. Null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_authority_score_totalnumberrequirednullable0 – 100

The total authority score between 0-100 of the podcast. This is calculated using the combined values of the other authority score fields and null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_authority_score_youtubenumberrequirednullable0 – 100

The authority score of the podcast for youtube. This is one component of the total score. Null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_calculated_update_frequencyenumrequired

The calculated update frequency of the podcast.

dailyweeklybi-weeklymonthlystalevery-stale
podcast_emailsarray of stringrequired

All emails we have detected for the podcast.

podcast_founded_datedaterequirednullable

The date the podcast was founded. This is typically the date of the first episode but for some very old podcasts it might be calculated from external data sources. Null when no episode date is known.

podcast_has_guestsbooleanrequirednullable

Pod Engine's calculation of whether the podcast has guests. Null means we have not calculated this yet.

podcast_has_sponsorsbooleanrequirednullable

Pod Engine's calculation of whether the podcast has sponsors. Null means we have not calculated this yet.

podcast_host_namesarray of stringrequired

The names of the hosts of the podcast.

podcast_languagestringrequired

The language of the podcast as a ISO 639-1 code.

podcast_last_episode_datedaterequirednullable

The date of the most recent episode in the podcast. Null when no episode date is known.

podcast_rss_apple_categoriesarray of stringrequired

The lower case normalized apple podcast categories as they are in the RSS. Subcategories appear with a : in the format main:subcategory. List of categories is here https://podcasters.apple.com/support/1691-apple-podcasts-categories

podcast_rss_authorstringrequirednullable

The author of the podcast as it appears in the RSS feed.

podcast_rss_descriptionstringrequirednullable

The description of the podcast as it appears in the RSS feed. This may include HTML. Null when no description is available.

podcast_rss_feed_urlstringrequiredurl

The URL of the podcast's RSS feed.

podcast_rss_image_urlstringrequirednullableurl

The URL of the podcast image as it appears in the RSS feed.

podcast_rss_titlestringrequired

This is the original title of the podcast as it first appeared in the RSS feed when Pod Engine first added the podcast.

podcast_rss_title_lateststringrequirednullable

The title of the latest episode in the podcast RSS feed.

podcast_rss_title_latest_cleanedstringrequirednullable

This is a generated field where we take the podcast rss title and remove any marketing fluff, unnecessary punctuation, etc to make it more human sounding and natural.

podcast_websitesarray of stringrequired

All websites we have detected and validated for the podcast.

podengine_idstringrequireduuid

The unique Pod Engine uuid for the podcast.

podengine_slugstringrequired

The unique Pod Engine slug for the podcast. Can be used to link directly to the podcast on Pod Engine.

podengine_thumbnail_urlstringrequirednullableurl

The URL of the podcast thumbnail image that has been processed by Pod Engine and stored in our CDN

similar_podcastsarray of objectrequired4 fields

Similar podcasts to the current podcast. This data is pulled from Apple Podcasts

podengine_idstringrequireduuid

The unique Pod Engine uuid for the podcast.

podcast_rss_titlestringrequired

The title of the podcast.

podcast_thumbnail_urlstringrequirednullableurl

The URL of the podcast thumbnail image.

podengine_slugstringrequired

The unique Pod Engine slug for the podcast. Can be used to link directly to the podcast on Pod Engine.

socials_facebookarray of objectrequired9 fields
idstringrequired

The unique Facebook page ID.

namestringrequired

The name of the Facebook page.

followers_countnumberrequired

The number of followers the Facebook page has.

likes_countnumberrequired

The number of likes the Facebook page has.

following_countnumberrequired

The number of pages this Facebook page is following.

talking_about_countnumberrequired

The number of people talking about this Facebook page.

image_urlstringrequirednullable

The URL of the Facebook page profile image.

urlstringrequired

The URL of the Facebook page.

data_last_updateddaterequired

The date when this Facebook page data was last updated.

socials_instagramarray of objectrequired7 fields
idstringrequired

The unique Instagram profile ID.

usernamestringrequired

The Instagram username/handle.

followers_countnumberrequired

The number of followers the Instagram profile has.

following_countnumberrequired

The number of accounts this Instagram profile is following.

posts_countnumberrequired

The number of posts the Instagram profile has.

image_urlstringrequirednullable

The URL of the Instagram profile image.

data_last_updateddaterequired

The date when this Instagram profile data was last updated.

socials_linkedin_companyarray of objectrequired11 fields
idstringrequired

The unique LinkedIn company ID.

namestringrequired

The name of the LinkedIn company.

aboutstringrequirednullable

The "About" section text of the LinkedIn company.

descriptionstringrequirednullable

The description of the LinkedIn company.

company_sizestringrequirednullable

The size of the company (e.g., "11-50 employees").

country_codestringrequirednullable

The ISO country code where the company is located.

industriesstringrequirednullable

The industries the company operates in.

followers_countnumberrequired

The number of followers the LinkedIn company has.

employees_countnumberrequired

The number of employees at the company.

image_urlstringrequirednullable

The URL of the LinkedIn company logo/image.

data_last_updateddaterequired

The date when this LinkedIn company data was last updated.

socials_linkedin_personarray of objectrequired9 fields
idstringrequired

The unique LinkedIn person ID.

namestringrequired

The name of the LinkedIn person.

aboutstringrequirednullable

The "About" section text of the LinkedIn person.

descriptionstringrequirednullable

The description of the LinkedIn person.

followers_countnumberrequired

The number of followers the LinkedIn person has.

connections_countnumberrequired

The number of connections the LinkedIn person has.

country_codestringrequirednullable

The ISO country code where the person is located.

image_urlstringrequirednullable

The URL of the LinkedIn person profile image.

data_last_updateddaterequired

The date when this LinkedIn person data was last updated.

socials_tiktokarray of objectrequired9 fields
idstringrequired

The unique TikTok profile ID.

handlestringrequired

The TikTok handle/username.

profile_namestringrequired

The display name of the TikTok profile.

biographystringrequirednullable

The biography text of the TikTok profile.

followers_countnumberrequired

The number of followers the TikTok profile has.

following_countnumberrequired

The number of accounts this TikTok profile is following.

likes_countnumberrequired

The number of likes the TikTok profile has received.

image_urlstringrequirednullable

The URL of the TikTok profile image.

data_last_updateddaterequired

The date when this TikTok profile data was last updated.

socials_twitterarray of objectrequired9 fields
idstringrequired

The unique Twitter profile ID.

date_joineddaterequirednullable

The date when the Twitter account was created.

biographystringrequirednullable

The biography text of the Twitter profile.

handlestringrequired

The Twitter handle/username.

followers_countnumberrequired

The number of followers the Twitter profile has.

following_countnumberrequired

The number of accounts this Twitter profile is following.

posts_countnumberrequired

The number of posts/tweets the Twitter profile has.

image_urlstringrequirednullable

The URL of the Twitter profile image.

data_last_updateddaterequired

The date when this Twitter profile data was last updated.

spotify_data_last_updateddaterequirednullable

The date we last scraped the spotify data. Null means we have not scraped this data yet.

spotify_idstringrequirednullable

The unique spotify id for the podcast.

spotify_ratingnumberrequirednullable

The rating of the podcast on spotify. Null means there are no ratings or we have not scraped this data yet.

spotify_ratings_countnumberrequirednullable

The number of ratings the podcast has on spotify. Null means there are no ratings or we have not scraped this data yet.

total_episodesnumberrequired

The total number of episodes in the podcast.

total_transcriptsnumberrequired

The total number of transcripts we have generated for the podcast.

youtube_channelsarray of objectrequired10 fields
channel_data_last_updateddaterequired

The date we last scraped the youtube channel data.

channel_descriptionstringrequirednullable

The description of the youtube channel.

channel_handlestringrequirednullable

The handle of the youtube channel.

channel_idstringrequired

The id of the youtube channel.

channel_titlestringrequirednullable

The title of the youtube channel.

channel_published_datedaterequirednullable

The date the youtube channel was published.

total_subscribersnumberrequired

The number of subscribers the youtube channel has.

total_videosnumberrequired

The number of videos the youtube channel has.

total_viewsnumberrequired

The number of views the youtube channel has.

average_views_per_videonumberrequired

The average number of views per video on the youtube channel. For video-first podcasts this is a strong public signal of actual audience size and is one of the inputs to the audience estimate.

Version 4
Released on 9/24/2025

Changelog

  • Added auto_soft_deleted fields
  • Added manual_soft_deleted fields
schema_versionnumberrequired

The numeric version of the schema. Starts at 1, and increments with each new version.

apple_idnumberrequired

The unique apple id for the podcast.

apple_podcasts_data_last_updateddaterequired

The date we last scraped the apple podcasts rating.

apple_podcasts_ratingnumberrequirednullable

The rating of the podcast on apple podcasts. Null means there are no ratings

apple_podcasts_ratings_countnumberrequired

The number of ratings the podcast has on apple podcasts.

auto_soft_deletedbooleanrequired

Whether the podcast has automatically been automatically soft deleted by the system. Common reasons for this include a dead podcast with only a few episodes, ai-generated podcasts, spam, etc.

auto_soft_deleted_reasonstringrequirednullable

The reason the podcast was automatically soft deleted.

automatic_transcriptionsbooleanrequired

True means we automatically transcribe all new episodes of this podcast

castbox_data_last_updateddaterequirednullable

The date we last scraped the castbox data. Null means we have not scraped this data yet.

castbox_playsnumberrequirednullable

The number of plays the podcast has on castbox. Null means we have not scraped this data yet.

castbox_subscribersnumberrequirednullable

The number of subscribers the podcast has on castbox. Null means we have not scraped this data yet.

chart_positionsarray of objectrequired10 fields
datestringrequired

The date of the chart position in YYYY-MM-DD format.

chart_typestringrequired

The type of chart (e.g., "apple", "spotify").

country_codestringrequired

The ISO country code where this chart position applies.

categorystringrequired

The main category of the chart (e.g., "top podcasts").

sub_categorystringrequirednullable

The sub-category of the chart, if applicable.

positionnumberrequired

The current position of the podcast on the chart.

previous_positionnumberrequirednullable

The previous position of the podcast on the chart.

position_changenumberrequirednullable

The change in position from the previous chart (positive = moved up, negative = moved down).

total_days_in_chartnumberrequired

The total number of days the podcast has been on this chart.

days_streak_countnumberrequired

The number of consecutive days the podcast has been on this chart.

manual_soft_deletedbooleanrequired

Whether the podcast has been manually soft deleted by a Pod Engine administrator. Common reasons for this include requests from the rights holder, spam, etc.

manual_soft_deleted_reasonstringrequirednullable

The reason the podcast was manually soft deleted.

podcast_affiliation_organization_namestringrequirednullable

The name of the organization that the podcast is affiliated with. This is a calculated field and null means we have not detected any affiliation.

podcast_affiliation_typeenumrequirednullable

The type of affiliation the podcast has from the options. This is a calculated field and null means we have not detected any affiliation.

academicbrandedcelebritygovernmentindependentlegacy mediapodcast companynew medianot for profitreligiousotherunknown
podcast_authority_score_engagementnumberrequirednullable0 – 100

The authority score between 0-100 of the podcast for engagement. This is one component of the total score. Null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_authority_score_qualitynumberrequirednullable0 – 100

The authority score between 0-100 of the podcast for quality. This is one component of the total score. Null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_authority_score_socialnumberrequirednullable0 – 100

The authority score between 0-100 of the podcast for social. This is one component of the total score. Null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_authority_score_totalnumberrequirednullable0 – 100

The total authority score between 0-100 of the podcast. This is calculated using the combined values of the other authority score fields and null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_authority_score_youtubenumberrequirednullable0 – 100

The authority score of the podcast for youtube. This is one component of the total score. Null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_calculated_update_frequencyenumrequired

The calculated update frequency of the podcast.

dailyweeklybi-weeklymonthlystalevery-stale
podcast_emailsarray of stringrequired

All emails we have detected for the podcast.

podcast_founded_datedaterequirednullable

The date the podcast was founded. This is typically the date of the first episode but for some very old podcasts it might be calculated from external data sources. Null when no episode date is known.

podcast_has_guestsbooleanrequirednullable

Pod Engine's calculation of whether the podcast has guests. Null means we have not calculated this yet.

podcast_has_sponsorsbooleanrequirednullable

Pod Engine's calculation of whether the podcast has sponsors. Null means we have not calculated this yet.

podcast_host_namesarray of stringrequired

The names of the hosts of the podcast.

podcast_languagestringrequired

The language of the podcast as a ISO 639-1 code.

podcast_last_episode_datedaterequirednullable

The date of the most recent episode in the podcast. Null when no episode date is known.

podcast_rss_apple_categoriesarray of stringrequired

The lower case normalized apple podcast categories as they are in the RSS. Subcategories appear with a : in the format main:subcategory. List of categories is here https://podcasters.apple.com/support/1691-apple-podcasts-categories

podcast_rss_authorstringrequirednullable

The author of the podcast as it appears in the RSS feed.

podcast_rss_descriptionstringrequirednullable

The description of the podcast as it appears in the RSS feed. This may include HTML. Null when no description is available.

podcast_rss_feed_urlstringrequiredurl

The URL of the podcast's RSS feed.

podcast_rss_image_urlstringrequirednullableurl

The URL of the podcast image as it appears in the RSS feed.

podcast_rss_titlestringrequired

This is the original title of the podcast as it first appeared in the RSS feed when Pod Engine first added the podcast.

podcast_rss_title_lateststringrequirednullable

The title of the latest episode in the podcast RSS feed.

podcast_rss_title_latest_cleanedstringrequirednullable

This is a generated field where we take the podcast rss title and remove any marketing fluff, unnecessary punctuation, etc to make it more human sounding and natural.

podcast_websitesarray of stringrequired

All websites we have detected and validated for the podcast.

podengine_idstringrequireduuid

The unique Pod Engine uuid for the podcast.

podengine_slugstringrequired

The unique Pod Engine slug for the podcast. Can be used to link directly to the podcast on Pod Engine.

podengine_thumbnail_urlstringrequirednullableurl

The URL of the podcast thumbnail image that has been processed by Pod Engine and stored in our CDN

similar_podcastsarray of objectrequired4 fields

Similar podcasts to the current podcast. This data is pulled from Apple Podcasts

podengine_idstringrequireduuid

The unique Pod Engine uuid for the podcast.

podcast_rss_titlestringrequired

The title of the podcast.

podcast_thumbnail_urlstringrequirednullableurl

The URL of the podcast thumbnail image.

podengine_slugstringrequired

The unique Pod Engine slug for the podcast. Can be used to link directly to the podcast on Pod Engine.

socials_facebookarray of objectrequired9 fields
idstringrequired

The unique Facebook page ID.

namestringrequired

The name of the Facebook page.

followers_countnumberrequired

The number of followers the Facebook page has.

likes_countnumberrequired

The number of likes the Facebook page has.

following_countnumberrequired

The number of pages this Facebook page is following.

talking_about_countnumberrequired

The number of people talking about this Facebook page.

image_urlstringrequirednullable

The URL of the Facebook page profile image.

urlstringrequired

The URL of the Facebook page.

data_last_updateddaterequired

The date when this Facebook page data was last updated.

socials_instagramarray of objectrequired7 fields
idstringrequired

The unique Instagram profile ID.

usernamestringrequired

The Instagram username/handle.

followers_countnumberrequired

The number of followers the Instagram profile has.

following_countnumberrequired

The number of accounts this Instagram profile is following.

posts_countnumberrequired

The number of posts the Instagram profile has.

image_urlstringrequirednullable

The URL of the Instagram profile image.

data_last_updateddaterequired

The date when this Instagram profile data was last updated.

socials_linkedin_companyarray of objectrequired11 fields
idstringrequired

The unique LinkedIn company ID.

namestringrequired

The name of the LinkedIn company.

aboutstringrequirednullable

The "About" section text of the LinkedIn company.

descriptionstringrequirednullable

The description of the LinkedIn company.

company_sizestringrequirednullable

The size of the company (e.g., "11-50 employees").

country_codestringrequirednullable

The ISO country code where the company is located.

industriesstringrequirednullable

The industries the company operates in.

followers_countnumberrequired

The number of followers the LinkedIn company has.

employees_countnumberrequired

The number of employees at the company.

image_urlstringrequirednullable

The URL of the LinkedIn company logo/image.

data_last_updateddaterequired

The date when this LinkedIn company data was last updated.

socials_linkedin_personarray of objectrequired9 fields
idstringrequired

The unique LinkedIn person ID.

namestringrequired

The name of the LinkedIn person.

aboutstringrequirednullable

The "About" section text of the LinkedIn person.

descriptionstringrequirednullable

The description of the LinkedIn person.

followers_countnumberrequired

The number of followers the LinkedIn person has.

connections_countnumberrequired

The number of connections the LinkedIn person has.

country_codestringrequirednullable

The ISO country code where the person is located.

image_urlstringrequirednullable

The URL of the LinkedIn person profile image.

data_last_updateddaterequired

The date when this LinkedIn person data was last updated.

socials_tiktokarray of objectrequired9 fields
idstringrequired

The unique TikTok profile ID.

handlestringrequired

The TikTok handle/username.

profile_namestringrequired

The display name of the TikTok profile.

biographystringrequirednullable

The biography text of the TikTok profile.

followers_countnumberrequired

The number of followers the TikTok profile has.

following_countnumberrequired

The number of accounts this TikTok profile is following.

likes_countnumberrequired

The number of likes the TikTok profile has received.

image_urlstringrequirednullable

The URL of the TikTok profile image.

data_last_updateddaterequired

The date when this TikTok profile data was last updated.

socials_twitterarray of objectrequired9 fields
idstringrequired

The unique Twitter profile ID.

date_joineddaterequirednullable

The date when the Twitter account was created.

biographystringrequirednullable

The biography text of the Twitter profile.

handlestringrequired

The Twitter handle/username.

followers_countnumberrequired

The number of followers the Twitter profile has.

following_countnumberrequired

The number of accounts this Twitter profile is following.

posts_countnumberrequired

The number of posts/tweets the Twitter profile has.

image_urlstringrequirednullable

The URL of the Twitter profile image.

data_last_updateddaterequired

The date when this Twitter profile data was last updated.

spotify_data_last_updateddaterequirednullable

The date we last scraped the spotify data. Null means we have not scraped this data yet.

spotify_idstringrequirednullable

The unique spotify id for the podcast.

spotify_ratingnumberrequirednullable

The rating of the podcast on spotify. Null means there are no ratings or we have not scraped this data yet.

spotify_ratings_countnumberrequirednullable

The number of ratings the podcast has on spotify. Null means there are no ratings or we have not scraped this data yet.

total_episodesnumberrequired

The total number of episodes in the podcast.

total_transcriptsnumberrequired

The total number of transcripts we have generated for the podcast.

youtube_channelsarray of objectrequired9 fields
channel_data_last_updateddaterequired

The date we last scraped the youtube channel data.

channel_descriptionstringrequirednullable

The description of the youtube channel.

channel_handlestringrequirednullable

The handle of the youtube channel.

channel_idstringrequired

The id of the youtube channel.

channel_titlestringrequirednullable

The title of the youtube channel.

channel_published_datedaterequirednullable

The date the youtube channel was published.

total_subscribersnumberrequired

The number of subscribers the youtube channel has.

total_videosnumberrequired

The number of videos the youtube channel has.

total_viewsnumberrequired

The number of views the youtube channel has.

Version 3
Released on 9/30/2025

Changelog

  • Clarified podcast_rss_title is the original title from when we first added the podcast
  • Added podcast_rss_title_latest
  • Added podcast_rss_title_latest_cleaned
schema_versionnumberrequired

The numeric version of the schema. Starts at 1, and increments with each new version.

apple_idnumberrequired

The unique apple id for the podcast.

apple_podcasts_data_last_updateddaterequired

The date we last scraped the apple podcasts rating.

apple_podcasts_ratingnumberrequirednullable

The rating of the podcast on apple podcasts. Null means there are no ratings

apple_podcasts_ratings_countnumberrequired

The number of ratings the podcast has on apple podcasts.

automatic_transcriptionsbooleanrequired

True means we automatically transcribe all new episodes of this podcast

castbox_data_last_updateddaterequirednullable

The date we last scraped the castbox data. Null means we have not scraped this data yet.

castbox_playsnumberrequirednullable

The number of plays the podcast has on castbox. Null means we have not scraped this data yet.

castbox_subscribersnumberrequirednullable

The number of subscribers the podcast has on castbox. Null means we have not scraped this data yet.

chart_positionsarray of objectrequired10 fields
datestringrequired

The date of the chart position in YYYY-MM-DD format.

chart_typestringrequired

The type of chart (e.g., "apple", "spotify").

country_codestringrequired

The ISO country code where this chart position applies.

categorystringrequired

The main category of the chart (e.g., "top podcasts").

sub_categorystringrequirednullable

The sub-category of the chart, if applicable.

positionnumberrequired

The current position of the podcast on the chart.

previous_positionnumberrequirednullable

The previous position of the podcast on the chart.

position_changenumberrequirednullable

The change in position from the previous chart (positive = moved up, negative = moved down).

total_days_in_chartnumberrequired

The total number of days the podcast has been on this chart.

days_streak_countnumberrequired

The number of consecutive days the podcast has been on this chart.

podcast_affiliation_organization_namestringrequirednullable

The name of the organization that the podcast is affiliated with. This is a calculated field and null means we have not detected any affiliation.

podcast_affiliation_typeenumrequirednullable

The type of affiliation the podcast has from the options. This is a calculated field and null means we have not detected any affiliation.

academicbrandedcelebritygovernmentindependentlegacy mediapodcast companynew medianot for profitreligiousotherunknown
podcast_authority_score_engagementnumberrequirednullable0 – 100

The authority score between 0-100 of the podcast for engagement. This is one component of the total score. Null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_authority_score_qualitynumberrequirednullable0 – 100

The authority score between 0-100 of the podcast for quality. This is one component of the total score. Null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_authority_score_socialnumberrequirednullable0 – 100

The authority score between 0-100 of the podcast for social. This is one component of the total score. Null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_authority_score_totalnumberrequirednullable0 – 100

The total authority score between 0-100 of the podcast. This is calculated using the combined values of the other authority score fields and null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_authority_score_youtubenumberrequirednullable0 – 100

The authority score of the podcast for youtube. This is one component of the total score. Null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_calculated_update_frequencyenumrequired

The calculated update frequency of the podcast.

dailyweeklybi-weeklymonthlystalevery-stale
podcast_emailsarray of stringrequired

All emails we have detected for the podcast.

podcast_founded_datedaterequirednullable

The date the podcast was founded. This is typically the date of the first episode but for some very old podcasts it might be calculated from external data sources. Null when no episode date is known.

podcast_has_guestsbooleanrequirednullable

Pod Engine's calculation of whether the podcast has guests. Null means we have not calculated this yet.

podcast_has_sponsorsbooleanrequirednullable

Pod Engine's calculation of whether the podcast has sponsors. Null means we have not calculated this yet.

podcast_host_namesarray of stringrequired

The names of the hosts of the podcast.

podcast_languagestringrequired

The language of the podcast as a ISO 639-1 code.

podcast_last_episode_datedaterequirednullable

The date of the most recent episode in the podcast. Null when no episode date is known.

podcast_rss_apple_categoriesarray of stringrequired

The lower case normalized apple podcast categories as they are in the RSS. Subcategories appear with a : in the format main:subcategory. List of categories is here https://podcasters.apple.com/support/1691-apple-podcasts-categories

podcast_rss_authorstringrequirednullable

The author of the podcast as it appears in the RSS feed.

podcast_rss_descriptionstringrequirednullable

The description of the podcast as it appears in the RSS feed. This may include HTML. Null when no description is available.

podcast_rss_feed_urlstringrequiredurl

The URL of the podcast's RSS feed.

podcast_rss_image_urlstringrequirednullableurl

The URL of the podcast image as it appears in the RSS feed.

podcast_rss_titlestringrequired

This is the original title of the podcast as it first appeared in the RSS feed when Pod Engine first added the podcast.

podcast_rss_title_lateststringrequirednullable

The title of the latest episode in the podcast RSS feed.

podcast_rss_title_latest_cleanedstringrequirednullable

This is a generated field where we take the podcast rss title and remove any marketing fluff, unnecessary punctuation, etc to make it more human sounding and natural.

podcast_websitesarray of stringrequired

All websites we have detected and validated for the podcast.

podengine_idstringrequireduuid

The unique Pod Engine uuid for the podcast.

podengine_slugstringrequired

The unique Pod Engine slug for the podcast. Can be used to link directly to the podcast on Pod Engine.

podengine_thumbnail_urlstringrequirednullableurl

The URL of the podcast thumbnail image that has been processed by Pod Engine and stored in our CDN

similar_podcastsarray of objectrequired4 fields

Similar podcasts to the current podcast. This data is pulled from Apple Podcasts

podengine_idstringrequireduuid

The unique Pod Engine uuid for the podcast.

podcast_rss_titlestringrequired

The title of the podcast.

podcast_thumbnail_urlstringrequirednullableurl

The URL of the podcast thumbnail image.

podengine_slugstringrequired

The unique Pod Engine slug for the podcast. Can be used to link directly to the podcast on Pod Engine.

socials_facebookarray of objectrequired9 fields
idstringrequired

The unique Facebook page ID.

namestringrequired

The name of the Facebook page.

followers_countnumberrequired

The number of followers the Facebook page has.

likes_countnumberrequired

The number of likes the Facebook page has.

following_countnumberrequired

The number of pages this Facebook page is following.

talking_about_countnumberrequired

The number of people talking about this Facebook page.

image_urlstringrequirednullable

The URL of the Facebook page profile image.

urlstringrequired

The URL of the Facebook page.

data_last_updateddaterequired

The date when this Facebook page data was last updated.

socials_instagramarray of objectrequired7 fields
idstringrequired

The unique Instagram profile ID.

usernamestringrequired

The Instagram username/handle.

followers_countnumberrequired

The number of followers the Instagram profile has.

following_countnumberrequired

The number of accounts this Instagram profile is following.

posts_countnumberrequired

The number of posts the Instagram profile has.

image_urlstringrequirednullable

The URL of the Instagram profile image.

data_last_updateddaterequired

The date when this Instagram profile data was last updated.

socials_linkedin_companyarray of objectrequired11 fields
idstringrequired

The unique LinkedIn company ID.

namestringrequired

The name of the LinkedIn company.

aboutstringrequirednullable

The "About" section text of the LinkedIn company.

descriptionstringrequirednullable

The description of the LinkedIn company.

company_sizestringrequirednullable

The size of the company (e.g., "11-50 employees").

country_codestringrequirednullable

The ISO country code where the company is located.

industriesstringrequirednullable

The industries the company operates in.

followers_countnumberrequired

The number of followers the LinkedIn company has.

employees_countnumberrequired

The number of employees at the company.

image_urlstringrequirednullable

The URL of the LinkedIn company logo/image.

data_last_updateddaterequired

The date when this LinkedIn company data was last updated.

socials_linkedin_personarray of objectrequired9 fields
idstringrequired

The unique LinkedIn person ID.

namestringrequired

The name of the LinkedIn person.

aboutstringrequirednullable

The "About" section text of the LinkedIn person.

descriptionstringrequirednullable

The description of the LinkedIn person.

followers_countnumberrequired

The number of followers the LinkedIn person has.

connections_countnumberrequired

The number of connections the LinkedIn person has.

country_codestringrequirednullable

The ISO country code where the person is located.

image_urlstringrequirednullable

The URL of the LinkedIn person profile image.

data_last_updateddaterequired

The date when this LinkedIn person data was last updated.

socials_tiktokarray of objectrequired9 fields
idstringrequired

The unique TikTok profile ID.

handlestringrequired

The TikTok handle/username.

profile_namestringrequired

The display name of the TikTok profile.

biographystringrequirednullable

The biography text of the TikTok profile.

followers_countnumberrequired

The number of followers the TikTok profile has.

following_countnumberrequired

The number of accounts this TikTok profile is following.

likes_countnumberrequired

The number of likes the TikTok profile has received.

image_urlstringrequirednullable

The URL of the TikTok profile image.

data_last_updateddaterequired

The date when this TikTok profile data was last updated.

socials_twitterarray of objectrequired9 fields
idstringrequired

The unique Twitter profile ID.

date_joineddaterequirednullable

The date when the Twitter account was created.

biographystringrequirednullable

The biography text of the Twitter profile.

handlestringrequired

The Twitter handle/username.

followers_countnumberrequired

The number of followers the Twitter profile has.

following_countnumberrequired

The number of accounts this Twitter profile is following.

posts_countnumberrequired

The number of posts/tweets the Twitter profile has.

image_urlstringrequirednullable

The URL of the Twitter profile image.

data_last_updateddaterequired

The date when this Twitter profile data was last updated.

spotify_data_last_updateddaterequirednullable

The date we last scraped the spotify data. Null means we have not scraped this data yet.

spotify_idstringrequirednullable

The unique spotify id for the podcast.

spotify_ratingnumberrequirednullable

The rating of the podcast on spotify. Null means there are no ratings or we have not scraped this data yet.

spotify_ratings_countnumberrequirednullable

The number of ratings the podcast has on spotify. Null means there are no ratings or we have not scraped this data yet.

total_episodesnumberrequired

The total number of episodes in the podcast.

total_transcriptsnumberrequired

The total number of transcripts we have generated for the podcast.

youtube_channelsarray of objectrequired9 fields
channel_data_last_updateddaterequired

The date we last scraped the youtube channel data.

channel_descriptionstringrequirednullable

The description of the youtube channel.

channel_handlestringrequirednullable

The handle of the youtube channel.

channel_idstringrequired

The id of the youtube channel.

channel_titlestringrequirednullable

The title of the youtube channel.

channel_published_datedaterequirednullable

The date the youtube channel was published.

total_subscribersnumberrequired

The number of subscribers the youtube channel has.

total_videosnumberrequired

The number of videos the youtube channel has.

total_viewsnumberrequired

The number of views the youtube channel has.

Version 2
Released on 7/20/2025

Changelog

  • Added podcast_calculated_update_frequency field
schema_versionnumberrequired

The numeric version of the schema. Starts at 1, and increments with each new version.

apple_idnumberrequired

The unique apple id for the podcast.

apple_podcasts_data_last_updateddaterequired

The date we last scraped the apple podcasts rating.

apple_podcasts_ratingnumberrequirednullable

The rating of the podcast on apple podcasts. Null means there are no ratings

apple_podcasts_ratings_countnumberrequired

The number of ratings the podcast has on apple podcasts.

automatic_transcriptionsbooleanrequired

True means we automatically transcribe all new episodes of this podcast

castbox_data_last_updateddaterequirednullable

The date we last scraped the castbox data. Null means we have not scraped this data yet.

castbox_playsnumberrequirednullable

The number of plays the podcast has on castbox. Null means we have not scraped this data yet.

castbox_subscribersnumberrequirednullable

The number of subscribers the podcast has on castbox. Null means we have not scraped this data yet.

chart_positionsarray of objectrequired10 fields
datestringrequired

The date of the chart position in YYYY-MM-DD format.

chart_typestringrequired

The type of chart (e.g., "apple", "spotify").

country_codestringrequired

The ISO country code where this chart position applies.

categorystringrequired

The main category of the chart (e.g., "top podcasts").

sub_categorystringrequirednullable

The sub-category of the chart, if applicable.

positionnumberrequired

The current position of the podcast on the chart.

previous_positionnumberrequirednullable

The previous position of the podcast on the chart.

position_changenumberrequirednullable

The change in position from the previous chart (positive = moved up, negative = moved down).

total_days_in_chartnumberrequired

The total number of days the podcast has been on this chart.

days_streak_countnumberrequired

The number of consecutive days the podcast has been on this chart.

podcast_affiliation_organization_namestringrequirednullable

The name of the organization that the podcast is affiliated with. This is a calculated field and null means we have not detected any affiliation.

podcast_affiliation_typeenumrequirednullable

The type of affiliation the podcast has from the options. This is a calculated field and null means we have not detected any affiliation.

academicbrandedcelebritygovernmentindependentlegacy mediapodcast companynew medianot for profitreligiousotherunknown
podcast_authority_score_engagementnumberrequirednullable0 – 100

The authority score between 0-100 of the podcast for engagement. This is one component of the total score. Null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_authority_score_qualitynumberrequirednullable0 – 100

The authority score between 0-100 of the podcast for quality. This is one component of the total score. Null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_authority_score_socialnumberrequirednullable0 – 100

The authority score between 0-100 of the podcast for social. This is one component of the total score. Null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_authority_score_totalnumberrequirednullable0 – 100

The total authority score between 0-100 of the podcast. This is calculated using the combined values of the other authority score fields and null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_authority_score_youtubenumberrequirednullable0 – 100

The authority score of the podcast for youtube. This is one component of the total score. Null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_calculated_update_frequencyenumrequired

The calculated update frequency of the podcast.

dailyweeklybi-weeklymonthlystalevery-stale
podcast_emailsarray of stringrequired

All emails we have detected for the podcast.

podcast_founded_datedaterequirednullable

The date the podcast was founded. This is typically the date of the first episode but for some very old podcasts it might be calculated from external data sources. Null when no episode date is known.

podcast_has_guestsbooleanrequirednullable

Pod Engine's calculation of whether the podcast has guests. Null means we have not calculated this yet.

podcast_has_sponsorsbooleanrequirednullable

Pod Engine's calculation of whether the podcast has sponsors. Null means we have not calculated this yet.

podcast_host_namesarray of stringrequired

The names of the hosts of the podcast.

podcast_languagestringrequired

The language of the podcast as a ISO 639-1 code.

podcast_last_episode_datedaterequirednullable

The date of the most recent episode in the podcast. Null when no episode date is known.

podcast_rss_apple_categoriesarray of stringrequired

The lower case normalized apple podcast categories as they are in the RSS. Subcategories appear with a : in the format main:subcategory. List of categories is here https://podcasters.apple.com/support/1691-apple-podcasts-categories

podcast_rss_authorstringrequirednullable

The author of the podcast as it appears in the RSS feed.

podcast_rss_descriptionstringrequirednullable

The description of the podcast as it appears in the RSS feed. This may include HTML. Null when no description is available.

podcast_rss_feed_urlstringrequiredurl

The URL of the podcast's RSS feed.

podcast_rss_image_urlstringrequirednullableurl

The URL of the podcast image as it appears in the RSS feed.

podcast_rss_titlestringrequired

This is the original title of the podcast as it first appeared in the RSS feed when Pod Engine first added the podcast.

podcast_websitesarray of stringrequired

All websites we have detected and validated for the podcast.

podengine_idstringrequireduuid

The unique Pod Engine uuid for the podcast.

podengine_slugstringrequired

The unique Pod Engine slug for the podcast. Can be used to link directly to the podcast on Pod Engine.

podengine_thumbnail_urlstringrequirednullableurl

The URL of the podcast thumbnail image that has been processed by Pod Engine and stored in our CDN

similar_podcastsarray of objectrequired4 fields

Similar podcasts to the current podcast. This data is pulled from Apple Podcasts

podengine_idstringrequireduuid

The unique Pod Engine uuid for the podcast.

podcast_rss_titlestringrequired

The title of the podcast.

podcast_thumbnail_urlstringrequirednullableurl

The URL of the podcast thumbnail image.

podengine_slugstringrequired

The unique Pod Engine slug for the podcast. Can be used to link directly to the podcast on Pod Engine.

socials_facebookarray of objectrequired9 fields
idstringrequired

The unique Facebook page ID.

namestringrequired

The name of the Facebook page.

followers_countnumberrequired

The number of followers the Facebook page has.

likes_countnumberrequired

The number of likes the Facebook page has.

following_countnumberrequired

The number of pages this Facebook page is following.

talking_about_countnumberrequired

The number of people talking about this Facebook page.

image_urlstringrequirednullable

The URL of the Facebook page profile image.

urlstringrequired

The URL of the Facebook page.

data_last_updateddaterequired

The date when this Facebook page data was last updated.

socials_instagramarray of objectrequired7 fields
idstringrequired

The unique Instagram profile ID.

usernamestringrequired

The Instagram username/handle.

followers_countnumberrequired

The number of followers the Instagram profile has.

following_countnumberrequired

The number of accounts this Instagram profile is following.

posts_countnumberrequired

The number of posts the Instagram profile has.

image_urlstringrequirednullable

The URL of the Instagram profile image.

data_last_updateddaterequired

The date when this Instagram profile data was last updated.

socials_linkedin_companyarray of objectrequired11 fields
idstringrequired

The unique LinkedIn company ID.

namestringrequired

The name of the LinkedIn company.

aboutstringrequirednullable

The "About" section text of the LinkedIn company.

descriptionstringrequirednullable

The description of the LinkedIn company.

company_sizestringrequirednullable

The size of the company (e.g., "11-50 employees").

country_codestringrequirednullable

The ISO country code where the company is located.

industriesstringrequirednullable

The industries the company operates in.

followers_countnumberrequired

The number of followers the LinkedIn company has.

employees_countnumberrequired

The number of employees at the company.

image_urlstringrequirednullable

The URL of the LinkedIn company logo/image.

data_last_updateddaterequired

The date when this LinkedIn company data was last updated.

socials_linkedin_personarray of objectrequired9 fields
idstringrequired

The unique LinkedIn person ID.

namestringrequired

The name of the LinkedIn person.

aboutstringrequirednullable

The "About" section text of the LinkedIn person.

descriptionstringrequirednullable

The description of the LinkedIn person.

followers_countnumberrequired

The number of followers the LinkedIn person has.

connections_countnumberrequired

The number of connections the LinkedIn person has.

country_codestringrequirednullable

The ISO country code where the person is located.

image_urlstringrequirednullable

The URL of the LinkedIn person profile image.

data_last_updateddaterequired

The date when this LinkedIn person data was last updated.

socials_tiktokarray of objectrequired9 fields
idstringrequired

The unique TikTok profile ID.

handlestringrequired

The TikTok handle/username.

profile_namestringrequired

The display name of the TikTok profile.

biographystringrequirednullable

The biography text of the TikTok profile.

followers_countnumberrequired

The number of followers the TikTok profile has.

following_countnumberrequired

The number of accounts this TikTok profile is following.

likes_countnumberrequired

The number of likes the TikTok profile has received.

image_urlstringrequirednullable

The URL of the TikTok profile image.

data_last_updateddaterequired

The date when this TikTok profile data was last updated.

socials_twitterarray of objectrequired9 fields
idstringrequired

The unique Twitter profile ID.

date_joineddaterequirednullable

The date when the Twitter account was created.

biographystringrequirednullable

The biography text of the Twitter profile.

handlestringrequired

The Twitter handle/username.

followers_countnumberrequired

The number of followers the Twitter profile has.

following_countnumberrequired

The number of accounts this Twitter profile is following.

posts_countnumberrequired

The number of posts/tweets the Twitter profile has.

image_urlstringrequirednullable

The URL of the Twitter profile image.

data_last_updateddaterequired

The date when this Twitter profile data was last updated.

spotify_data_last_updateddaterequirednullable

The date we last scraped the spotify data. Null means we have not scraped this data yet.

spotify_idstringrequirednullable

The unique spotify id for the podcast.

spotify_ratingnumberrequirednullable

The rating of the podcast on spotify. Null means there are no ratings or we have not scraped this data yet.

spotify_ratings_countnumberrequirednullable

The number of ratings the podcast has on spotify. Null means there are no ratings or we have not scraped this data yet.

total_episodesnumberrequired

The total number of episodes in the podcast.

total_transcriptsnumberrequired

The total number of transcripts we have generated for the podcast.

youtube_channelsarray of objectrequired9 fields
channel_data_last_updateddaterequired

The date we last scraped the youtube channel data.

channel_descriptionstringrequirednullable

The description of the youtube channel.

channel_handlestringrequirednullable

The handle of the youtube channel.

channel_idstringrequired

The id of the youtube channel.

channel_titlestringrequirednullable

The title of the youtube channel.

channel_published_datedaterequirednullable

The date the youtube channel was published.

total_subscribersnumberrequired

The number of subscribers the youtube channel has.

total_videosnumberrequired

The number of videos the youtube channel has.

total_viewsnumberrequired

The number of views the youtube channel has.

Version 1
Released on 6/30/2025
schema_versionnumberrequired

The numeric version of the schema. Starts at 1, and increments with each new version.

apple_idnumberrequired

The unique apple id for the podcast.

apple_podcasts_data_last_updateddaterequired

The date we last scraped the apple podcasts rating.

apple_podcasts_ratingnumberrequirednullable

The rating of the podcast on apple podcasts. Null means there are no ratings

apple_podcasts_ratings_countnumberrequired

The number of ratings the podcast has on apple podcasts.

automatic_transcriptionsbooleanrequired

True means we automatically transcribe all new episodes of this podcast

castbox_data_last_updateddaterequirednullable

The date we last scraped the castbox data. Null means we have not scraped this data yet.

castbox_playsnumberrequirednullable

The number of plays the podcast has on castbox. Null means we have not scraped this data yet.

castbox_subscribersnumberrequirednullable

The number of subscribers the podcast has on castbox. Null means we have not scraped this data yet.

chart_positionsarray of objectrequired10 fields
datestringrequired

The date of the chart position in YYYY-MM-DD format.

chart_typestringrequired

The type of chart (e.g., "apple", "spotify").

country_codestringrequired

The ISO country code where this chart position applies.

categorystringrequired

The main category of the chart (e.g., "top podcasts").

sub_categorystringrequirednullable

The sub-category of the chart, if applicable.

positionnumberrequired

The current position of the podcast on the chart.

previous_positionnumberrequirednullable

The previous position of the podcast on the chart.

position_changenumberrequirednullable

The change in position from the previous chart (positive = moved up, negative = moved down).

total_days_in_chartnumberrequired

The total number of days the podcast has been on this chart.

days_streak_countnumberrequired

The number of consecutive days the podcast has been on this chart.

podcast_affiliation_organization_namestringrequirednullable

The name of the organization that the podcast is affiliated with. This is a calculated field and null means we have not detected any affiliation.

podcast_affiliation_typeenumrequirednullable

The type of affiliation the podcast has from the options. This is a calculated field and null means we have not detected any affiliation.

academicbrandedcelebritygovernmentindependentlegacy mediapodcast companynew medianot for profitreligiousotherunknown
podcast_authority_score_engagementnumberrequirednullable0 – 100

The authority score between 0-100 of the podcast for engagement. This is one component of the total score. Null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_authority_score_qualitynumberrequirednullable0 – 100

The authority score between 0-100 of the podcast for quality. This is one component of the total score. Null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_authority_score_socialnumberrequirednullable0 – 100

The authority score between 0-100 of the podcast for social. This is one component of the total score. Null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_authority_score_totalnumberrequirednullable0 – 100

The total authority score between 0-100 of the podcast. This is calculated using the combined values of the other authority score fields and null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_authority_score_youtubenumberrequirednullable0 – 100

The authority score of the podcast for youtube. This is one component of the total score. Null means it has not been calculated for this podcast and more information is available at https://www.podengine.ai/podcast-authority-score

podcast_emailsarray of stringrequired

All emails we have detected for the podcast.

podcast_founded_datedaterequirednullable

The date the podcast was founded. This is typically the date of the first episode but for some very old podcasts it might be calculated from external data sources. Null when no episode date is known.

podcast_has_guestsbooleanrequirednullable

Pod Engine's calculation of whether the podcast has guests. Null means we have not calculated this yet.

podcast_has_sponsorsbooleanrequirednullable

Pod Engine's calculation of whether the podcast has sponsors. Null means we have not calculated this yet.

podcast_host_namesarray of stringrequired

The names of the hosts of the podcast.

podcast_languagestringrequired

The language of the podcast as a ISO 639-1 code.

podcast_last_episode_datedaterequirednullable

The date of the most recent episode in the podcast. Null when no episode date is known.

podcast_rss_apple_categoriesarray of stringrequired

The lower case normalized apple podcast categories as they are in the RSS. Subcategories appear with a : in the format main:subcategory. List of categories is here https://podcasters.apple.com/support/1691-apple-podcasts-categories

podcast_rss_authorstringrequirednullable

The author of the podcast as it appears in the RSS feed.

podcast_rss_descriptionstringrequirednullable

The description of the podcast as it appears in the RSS feed. This may include HTML. Null when no description is available.

podcast_rss_feed_urlstringrequiredurl

The URL of the podcast's RSS feed.

podcast_rss_image_urlstringrequirednullableurl

The URL of the podcast image as it appears in the RSS feed.

podcast_rss_titlestringrequired

This is the original title of the podcast as it first appeared in the RSS feed when Pod Engine first added the podcast.

podcast_websitesarray of stringrequired

All websites we have detected and validated for the podcast.

podengine_idstringrequireduuid

The unique Pod Engine uuid for the podcast.

podengine_slugstringrequired

The unique Pod Engine slug for the podcast. Can be used to link directly to the podcast on Pod Engine.

podengine_thumbnail_urlstringrequirednullableurl

The URL of the podcast thumbnail image that has been processed by Pod Engine and stored in our CDN

similar_podcastsarray of objectrequired4 fields

Similar podcasts to the current podcast. This data is pulled from Apple Podcasts

podengine_idstringrequireduuid

The unique Pod Engine uuid for the podcast.

podcast_rss_titlestringrequired

The title of the podcast.

podcast_thumbnail_urlstringrequirednullableurl

The URL of the podcast thumbnail image.

podengine_slugstringrequired

The unique Pod Engine slug for the podcast. Can be used to link directly to the podcast on Pod Engine.

socials_facebookarray of objectrequired9 fields
idstringrequired

The unique Facebook page ID.

namestringrequired

The name of the Facebook page.

followers_countnumberrequired

The number of followers the Facebook page has.

likes_countnumberrequired

The number of likes the Facebook page has.

following_countnumberrequired

The number of pages this Facebook page is following.

talking_about_countnumberrequired

The number of people talking about this Facebook page.

image_urlstringrequirednullable

The URL of the Facebook page profile image.

urlstringrequired

The URL of the Facebook page.

data_last_updateddaterequired

The date when this Facebook page data was last updated.

socials_instagramarray of objectrequired7 fields
idstringrequired

The unique Instagram profile ID.

usernamestringrequired

The Instagram username/handle.

followers_countnumberrequired

The number of followers the Instagram profile has.

following_countnumberrequired

The number of accounts this Instagram profile is following.

posts_countnumberrequired

The number of posts the Instagram profile has.

image_urlstringrequirednullable

The URL of the Instagram profile image.

data_last_updateddaterequired

The date when this Instagram profile data was last updated.

socials_linkedin_companyarray of objectrequired11 fields
idstringrequired

The unique LinkedIn company ID.

namestringrequired

The name of the LinkedIn company.

aboutstringrequirednullable

The "About" section text of the LinkedIn company.

descriptionstringrequirednullable

The description of the LinkedIn company.

company_sizestringrequirednullable

The size of the company (e.g., "11-50 employees").

country_codestringrequirednullable

The ISO country code where the company is located.

industriesstringrequirednullable

The industries the company operates in.

followers_countnumberrequired

The number of followers the LinkedIn company has.

employees_countnumberrequired

The number of employees at the company.

image_urlstringrequirednullable

The URL of the LinkedIn company logo/image.

data_last_updateddaterequired

The date when this LinkedIn company data was last updated.

socials_linkedin_personarray of objectrequired9 fields
idstringrequired

The unique LinkedIn person ID.

namestringrequired

The name of the LinkedIn person.

aboutstringrequirednullable

The "About" section text of the LinkedIn person.

descriptionstringrequirednullable

The description of the LinkedIn person.

followers_countnumberrequired

The number of followers the LinkedIn person has.

connections_countnumberrequired

The number of connections the LinkedIn person has.

country_codestringrequirednullable

The ISO country code where the person is located.

image_urlstringrequirednullable

The URL of the LinkedIn person profile image.

data_last_updateddaterequired

The date when this LinkedIn person data was last updated.

socials_tiktokarray of objectrequired9 fields
idstringrequired

The unique TikTok profile ID.

handlestringrequired

The TikTok handle/username.

profile_namestringrequired

The display name of the TikTok profile.

biographystringrequirednullable

The biography text of the TikTok profile.

followers_countnumberrequired

The number of followers the TikTok profile has.

following_countnumberrequired

The number of accounts this TikTok profile is following.

likes_countnumberrequired

The number of likes the TikTok profile has received.

image_urlstringrequirednullable

The URL of the TikTok profile image.

data_last_updateddaterequired

The date when this TikTok profile data was last updated.

socials_twitterarray of objectrequired9 fields
idstringrequired

The unique Twitter profile ID.

date_joineddaterequirednullable

The date when the Twitter account was created.

biographystringrequirednullable

The biography text of the Twitter profile.

handlestringrequired

The Twitter handle/username.

followers_countnumberrequired

The number of followers the Twitter profile has.

following_countnumberrequired

The number of accounts this Twitter profile is following.

posts_countnumberrequired

The number of posts/tweets the Twitter profile has.

image_urlstringrequirednullable

The URL of the Twitter profile image.

data_last_updateddaterequired

The date when this Twitter profile data was last updated.

spotify_data_last_updateddaterequirednullable

The date we last scraped the spotify data. Null means we have not scraped this data yet.

spotify_idstringrequirednullable

The unique spotify id for the podcast.

spotify_ratingnumberrequirednullable

The rating of the podcast on spotify. Null means there are no ratings or we have not scraped this data yet.

spotify_ratings_countnumberrequirednullable

The number of ratings the podcast has on spotify. Null means there are no ratings or we have not scraped this data yet.

total_episodesnumberrequired

The total number of episodes in the podcast.

total_transcriptsnumberrequired

The total number of transcripts we have generated for the podcast.

youtube_channelsarray of objectrequired9 fields
channel_data_last_updateddaterequired

The date we last scraped the youtube channel data.

channel_descriptionstringrequirednullable

The description of the youtube channel.

channel_handlestringrequirednullable

The handle of the youtube channel.

channel_idstringrequired

The id of the youtube channel.

channel_titlestringrequirednullable

The title of the youtube channel.

channel_published_datedaterequirednullable

The date the youtube channel was published.

total_subscribersnumberrequired

The number of subscribers the youtube channel has.

total_videosnumberrequired

The number of videos the youtube channel has.

total_viewsnumberrequired

The number of views the youtube channel has.

Get started with the API and MCP server

One plan, everything included

  • Full Pod Engine web app access
  • Full API access — same data, programmatic
  • MCP server
  • 10,000 searches / mo
  • 10,000 podcast and episode lookups / mo
  • 1,000 transcripts / mo
  • Historical podcast charts
  • Contacts, emails, social & YouTube data
  • 30 alerts

Get Started

$100 / month

Create your account

Pay monthly. Cancel anytime.

Available Discounts

We believe great tools should be accessible to everyone building amazing things.

Eligible for a discount? Contact us to learn more.

Bootstrapped Startups

50% off first year

Students & Educators

50% off first year

Nonprofits

50% off first year

Pay Annually

2 months free

Need Guest Booking, an Agency plan, or higher limits?

See the full pricing page for addons and Agency options, or schedule a call.

Need more than 10,000 searches / mo? Get in touch and we'll tailor a plan.