Apple ID Comprehensive Lookup

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

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

Example request

curl -X GET "https://api.podengine.ai/api/v1/podcasts/apple-id/lookup?id=315114957" \
  -H "Content-Type: application/json" \
  -H "Authorization: YOUR_API_TOKEN"

const options = {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "YOUR_API_TOKEN"
  }
};

fetch("https://api.podengine.ai/api/v1/podcasts/apple-id/lookup?id=315114957", options)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

import requests

headers = {
    "Content-Type": "application/json",
    "Authorization": "YOUR_API_TOKEN"
}

response = requests.get("https://api.podengine.ai/api/v1/podcasts/apple-id/lookup?id=315114957", headers=headers)
print(response.json())

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "YOUR_API_TOKEN");
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));

var response = await client.GetAsync("https://api.podengine.ai/api/v1/podcasts/apple-id/lookup?id=315114957");
var data = await response.Content.ReadAsStringAsync();
Console.WriteLine(data);

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.podengine.ai/api/v1/podcasts/apple-id/lookup?id=315114957", nil)
	req.Header.Add("Content-Type", "application/json")
	req.Header.Add("Authorization", "YOUR_API_TOKEN")
	
	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

import { PodEngine } from '@podengine/sdk';

const pe = new PodEngine({ apiKey: process.env.PODENGINE_API_KEY });

const data = await pe.podcasts.getAppleIdComprehensiveLookup({
  id: 315114957,
});

console.log(data);

import os

from podengine import PodEngine

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

data = pe.podcasts.get_apple_id_comprehensive_lookup(
    id=315114957,
)

print(data)

200

Example response

{
  "status": "OK",
  "data": {
    "appleId": 0,
    "status": "found",
    "podcast": {
      "id": "0eaa5978-d577-48fd-bc2a-68fb355b41e1",
      "slug": "string",
      "title": "string",
      "imageUrl": "string",
      "isPrimaryAppleId": true,
      "primaryAppleId": 0,
      "createdAt": "2026-01-15T09:30:00.000Z",
      "podEngineUrl": "string"
    },
    "importRequest": {
      "id": 0,
      "appleTitle": "string",
      "rssUrl": "string",
      "creationSource": "string",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "importedAt": "2026-01-15T09:30:00.000Z",
      "podcastId": "0eaa5978-d577-48fd-bc2a-68fb355b41e1",
      "importErrorAt": "2026-01-15T09:30:00.000Z",
      "importError": "string",
      "importErrorType": "string"
    },
    "scraperData": {
      "entries": [
        {
          "id": 0,
          "country": "string",
          "podcastTitle": "string",
          "createdAt": "2026-01-15T09:30:00.000Z",
          "lastScrapedAt": "2026-01-15T09:30:00.000Z",
          "lastSuccessAt": "2026-01-15T09:30:00.000Z",
          "lastErrorAt": "2026-01-15T09:30:00.000Z",
          "rssUrl": "string",
          "ratingsCount": 0,
          "averageRating": 0,
          "episodesCount": 0,
          "lastEpisodeDate": "2026-01-15T09:30:00.000Z",
          "isLikelyNonEnglishTitle": true,
          "skippedPodcastImportReason": "string",
          "skippedPodcastImportAt": "2026-01-15T09:30:00.000Z"
        }
      ],
      "countries": [
        "string"
      ],
      "mostRecentScrape": "2026-01-15T09:30:00.000Z",
      "recentAttempts": [
        {
          "id": 0,
          "createdAt": "2026-01-15T09:30:00.000Z",
          "type": "string",
          "url": "string",
          "appleId": 0,
          "spotifyId": "string",
          "podcastId": "string",
          "errorType": "string",
          "errorDetails": "string",
          "timeTakenMs": 0
        }
      ]
    }
  }
}

Request

Query parameters

idnumberrequiredmin 0

Apple Podcasts ID

Response

200 application/json

statusliteral: OKrequired

dataobjectrequired5 fields

appleIdnumberrequired

statusenumrequired

foundlinkedapple_details_not_foundapple_not_scrapedcreate_podcast_failedduplicate_apple_idduplicate_podcast_guidduplicate_rss_urlmalformed_apple_urlno_episodes_countno_podcast_imagenon_us_apple_urlpodcast_blockednot_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

podcastobjectrequirednullable8 fields

idstringrequireduuid

slugstringrequired

titlestringrequired

imageUrlstringrequirednullable

isPrimaryAppleIdbooleanrequired

primaryAppleIdnumberrequired

createdAtdaterequired

podEngineUrlstringrequired

Direct link to the podcast in the Pod Engine app

importRequestobjectrequirednullable10 fields

idnumberrequired

appleTitlestringrequired

rssUrlstringrequired

creationSourcestringrequired

createdAtdaterequired

importedAtdaterequirednullable

podcastIdstringrequirednullableuuid

importErrorAtdaterequirednullable

importErrorstringrequirednullable

importErrorTypestringrequirednullable

scraperDataobjectrequirednullable4 fields

entriesarray of objectrequired15 fields

idnumberrequired

countrystringrequired

podcastTitlestringrequired

createdAtdaterequired

lastScrapedAtdaterequirednullable

lastSuccessAtdaterequirednullable

lastErrorAtdaterequirednullable

rssUrlstringrequirednullable

ratingsCountnumberrequirednullable

averageRatingnumberrequirednullable

episodesCountnumberrequirednullable

lastEpisodeDatedaterequirednullable

isLikelyNonEnglishTitlebooleanrequired

skippedPodcastImportReasonstringrequirednullable

skippedPodcastImportAtdaterequirednullable

countriesarray of stringrequired

mostRecentScrapedaterequirednullable

recentAttemptsarray of objectrequired10 fields

idnumberrequired

createdAtdaterequired

typestringrequired

urlstringrequired

appleIdnumberrequirednullable

spotifyIdstringrequirednullable

podcastIdstringrequirednullable

errorTypestringrequirednullable

errorDetailsstringrequirednullable

timeTakenMsnumberrequired