Podcast Chart Appearances

GET https://api.podengine.ai/api/v1/charts/podcast-appearances

Get every chart a podcast is on for one date, ordered by position, with the total count

Example request

curl -X GET "https://api.podengine.ai/api/v1/charts/podcast-appearances?identityType=podcast&podcastIdOrSlug=good-hang-with-amy-poehler&chartType=apple&date=2026-09-22" \
  -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/charts/podcast-appearances?identityType=podcast&podcastIdOrSlug=good-hang-with-amy-poehler&chartType=apple&date=2026-09-22", 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/charts/podcast-appearances?identityType=podcast&podcastIdOrSlug=good-hang-with-amy-poehler&chartType=apple&date=2026-09-22", 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/charts/podcast-appearances?identityType=podcast&podcastIdOrSlug=good-hang-with-amy-poehler&chartType=apple&date=2026-09-22");
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/charts/podcast-appearances?identityType=podcast&podcastIdOrSlug=good-hang-with-amy-poehler&chartType=apple&date=2026-09-22", 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.charts.getPodcastChartAppearances({
  identityType: 'podcast',
  podcastIdOrSlug: 'good-hang-with-amy-poehler',
  chartType: 'apple',
  date: '2026-09-22',
});

console.log(data);

import os

from podengine import PodEngine

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

data = pe.charts.get_podcast_chart_appearances(
    identity_type="podcast",
    podcast_id_or_slug="good-hang-with-amy-poehler",
    chart_type="apple",
    date="2026-09-22",
)

print(data)

200

Example response

{
  "status": "OK",
  "data": {
    "appearances": {
      "podenginePodcast": {
        "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"
      },
      "podcastOnChart": {
        "platformId": "string",
        "title": "string",
        "creator": "string",
        "imageUrl": "string"
      },
      "identity": {
        "type": "podcast",
        "podcastId": "string",
        "slug": "string"
      },
      "chartType": "apple",
      "date": "string",
      "totalCount": 0,
      "appearances": [
        {
          "chartDate": "string",
          "chartType": "apple",
          "country": "string",
          "category": "string",
          "position": 0
        }
      ]
    }
  }
}

Request

Query parameters

Get every chart a podcast is on for one date

identityTypeenumrequired

podcast: a Pod Engine podcast, given by podcastIdOrSlug. platform: one Apple or Spotify id on the chart type, given by platformId.

podcastplatform

podcastIdOrSlugstringmin 1 characters

Pod Engine podcast id or slug. Required for identityType=podcast.

platformIdstring1 – 64 characters

Apple id or Spotify show id for chartType. Required for identityType=platform.

chartTypeenum

The type of chart, one of apple, spotify

applespotify

datestringrequiredregex

The chart date (YYYY-MM-DD).

limitnumber1 – 500

The number of appearances to return; totalCount is unaffected.

Response

200 application/json

statusliteral: OKrequired

dataobjectrequired1 field

appearancesobjectrequired7 fields

podenginePodcastobjectrequirednullable10 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

podcastOnChartobjectrequirednullable4 fields

The platform listing, for identityType=platform.

platformIdstringrequired

titlestringrequired

creatorstringrequirednullable

imageUrlstringrequirednullable

identityunionrequired

The resolved identity, stable for deep links: the canonical Pod Engine id, or the platform id.

chartTypeenumrequired

The type of chart, one of apple, spotify

applespotify

datestringrequiredregex

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

totalCountnumberrequired

Charts the show is on that day, independent of limit.

appearancesarray of objectrequired5 fields

Ordered by position, then country, then category.

chartDatestringrequiredregex

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

chartTypeenumrequired

The type of chart, one of apple, spotify

applespotify

countrystringrequired

The country of the chart in ISO 3166-1 alpha-2 format, for example "us". Defaults to us.

categorystringrequired

The chart category defaulting to 'top podcasts'. Apple podcasts supports the following: "top podcasts", "arts", "business", "comedy", "education", "fiction", "government", "health & fitness", "history", "kids & family", "leisure", "music", "news", "religion & spirituality", "science", "society & culture", "sports", "technology", "true crime", "tv & film"

positionnumberrequired