Podcast ID Lookup

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

Find the Pod Engine podcast for an ID you already have: an Apple Podcasts ID, a Spotify show ID, an RSS feed URL, a podcast:guid, or a Pod Engine slug or ID. Pass exactly one. Returns basic details, or null when we do not track the podcast. Does not count towards your podcast lookups.

API token required Markdown for LLMs

OpenAPI spec

Example request

Install & configure

curl -X GET "https://api.podengine.ai/api/v1/podcasts/id/lookup?appleId=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/id/lookup?appleId=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/id/lookup?appleId=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/id/lookup?appleId=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/id/lookup?appleId=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.getPodcastIdLookup({
  appleId: 315114957,
});

console.log(data);

import os

from podengine import PodEngine

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

data = pe.podcasts.get_podcast_id_lookup(
    apple_id=315114957,
)

print(data)

200

Example response

{
  "status": "OK",
  "data": {
    "podcast": {
      "author": "string",
      "authorityScore": {
        "calculatedAt": "2026-01-15T09:30:00.000Z",
        "authorityScore": 0,
        "qualityScore": 0,
        "youtubeScore": 0,
        "socialScore": 0,
        "engagementScore": 0
      },
      "genres": [
        "string"
      ],
      "id": "string",
      "imageUrl": "string",
      "language": "string",
      "lastEpisodePublishedAt": "2026-01-15T09:30:00.000Z",
      "slug": "string",
      "title": "string",
      "titleLatest": "string"
    }
  }
}

Request

Query parameters

Only one of the parameters can be provided.

Only one of appleId, slug, spotifyId, podEngineId, rssFeedUrl, or podcastGuid can be provided

appleIdnumbermin 0

Apple Podcasts ID

spotifyIdstring

The Spotify show ID of the podcast

slugstring

The Pod Engine slug of the podcast

podEngineIdstringuuid

The Pod Engine id of the podcast

rssFeedUrlstring1 – 2048 characters

The podcast’s RSS feed URL. http and https, a trailing slash and the case of the host are ignored. Also matches the feed URL we first tracked the show under, for feeds that have since moved host.

podcastGuidstring1 – 255 characters

The podcast:guid from the RSS feed (Podcasting 2.0)

Response

200 application/json

statusliteral: OKrequired

dataobjectrequired1 field

podcastobjectrequirednullable10 fields

authorstringrequirednullable

authorityScoreobjectrequirednullable6 fields

calculatedAtdaterequired

authorityScorenumberrequired

This is the weighted total authority score of the podcast, out of 100

qualityScorenumberrequired

This is the quality score of the podcast, out of 100

youtubeScorenumberrequired

This is the YouTube score of the podcast, out of 100

socialScorenumberrequired

This is the social score of the podcast, out of 100

engagementScorenumberrequired

This is the engagement score of the podcast, out of 100

genresarray of stringrequired

idstringrequired

imageUrlstringrequirednullable

languagestringrequired

lastEpisodePublishedAtdaterequired

slugstringrequired

titlestringrequired

titleLateststringrequired