Apple ID Comprehensive Lookup

GET /podcasts/apple-id/lookup

Comprehensive lookup by Apple ID - checks Podcast, PodcastAppleId, PodcastNewRequest, and scraper database

TOKEN

Authentication

This endpoint requires an API token. You can learn more about how to get an API token from the authentication page.

URL

https://api.podengine.ai/api/v1/podcasts/apple-id/lookup

Code Example

API Specification

Query Parameters

PropertyTypeDescription
id
number ⓘ

Constraints:

> 0integer

Apple Podcasts ID

200

Success Response

PropertyTypeDescription
status
literal: OK

data
object

appleId
number

status
enum ⓘ

Allowed values

foundlinkedapple_details_not_foundapple_not_scrapedcreate_podcast_failedduplicate_apple_idduplicate_podcast_guidduplicate_rss_urlmalformed_apple_urlno_episodes_countno_podcast_imagenon_us_apple_urlnot_activerequest_not_foundrss_download_failedrss_parsing_failedrss_url_not_foundimport_error_unknownpending_importscraped_not_imported_non_englishscraped_not_imported_no_rss_urlscraped_not_imported_not_fully_scrapedscraped_not_imported_too_few_episodesscraped_not_imported_inactivescraped_not_imported_low_engagementscraped_not_imported_unknownnot_found

podcastnullable
object

id
string ⓘ

Constraints:

uuid

slug
string

title
string

imageUrlnullable
string

isPrimaryAppleId
boolean

primaryAppleId
number

createdAt
date

podEngineUrl
string

Direct link to the podcast in the Pod Engine app

importRequestnullable
object

id
number

appleTitle
string

rssUrl
string

creationSource
string

createdAt
date

importedAtnullable
date

podcastIdnullable
string ⓘ

Constraints:

uuid

importErrorAtnullable
date

importErrornullable
string

importErrorTypenullable
string

scraperDatanullable
object

entries
array
of
object

id
number

country
string

podcastTitle
string

createdAt
date

lastScrapedAtnullable
date

lastSuccessAtnullable
date

lastErrorAtnullable
date

rssUrlnullable
string

ratingsCountnullable
number

averageRatingnullable
number

episodesCountnullable
number

lastEpisodeDatenullable
date

isLikelyNonEnglishTitle
boolean

skippedPodcastImportReasonnullable
string

skippedPodcastImportAtnullable
date

countries
array
of
string

mostRecentScrapenullable
date

recentAttempts
array
of
object

id
number

createdAt
date

type
string

url
string

appleIdnullable
number

spotifyIdnullable
string

podcastIdnullable
string

errorTypenullable
string

errorDetailsnullable
string

timeTakenMs
number