Podcast Chart Position

GET https://api.podengine.ai/api/v1/podcasts/:podcastIdOrSlug/charts

Get the latest positions of a podcast in a chart

Example request

curl -X GET "https://api.podengine.ai/api/v1/podcasts/:podcastIdOrSlug/charts?country=us" \
  -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/:podcastIdOrSlug/charts?country=us", 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/:podcastIdOrSlug/charts?country=us", 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/:podcastIdOrSlug/charts?country=us");
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/:podcastIdOrSlug/charts?country=us", 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.getPodcastCharts({
  podcastIdOrSlug: 'this-week-in-startups',
  country: 'us',
});

console.log(data);

import os

from podengine import PodEngine

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

data = pe.podcasts.get_podcast_charts(
    podcast_id_or_slug="this-week-in-startups",
    country="us",
)

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"
    },
    "options": {
      "chartType": "apple",
      "category": "string",
      "country": "string",
      "positionsLimit": 1,
      "compare": "1d",
      "limit": 1,
      "date": "string"
    },
    "totalCharts": 0,
    "positions": [
      {
        "chartDate": "string",
        "chartType": "apple",
        "country": "string",
        "category": "string",
        "position": 0
      }
    ]
  }
}

Request

Path parameters

podcastIdOrSlugstringrequired

Podengine ID, Apple ID, or slug

Query parameters

chartTypeenum

The type of chart, one of apple, spotify

applespotify

categorystring

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"

countrystring

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

positionsLimitnumber1 – 200

The number of chart positions to return. If not provided, all positions are returned

compareenum

Which earlier chart to measure rank change against: 1 day or 7 days before the chart date. The latest chart on or before that date is used. Defaults to 1d.

1d7d

limitnumbermin 1

The number of charts to return; totalCharts is unaffected

datestringregex

Only the charts the podcast is on for this exact date (YYYY-MM-DD), ordered by position. Without it, the latest appearance on each chart.

Response

200 application/json

statusliteral: OKrequired

dataobjectrequired4 fields

podcastobjectrequired10 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

optionsobjectrequired7 fields

chartTypeenum

The type of chart, one of apple, spotify

applespotify

categorystring

countrystring

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

positionsLimitnumber1 – 200

The number of chart positions to return. If not provided, all positions are returned

compareenum

Which earlier chart to measure rank change against: 1 day or 7 days before the chart date. The latest chart on or before that date is used. Defaults to 1d.

1d7d

limitnumbermin 1

The number of charts to return; totalCharts is unaffected

datestringregex

Only the charts the podcast is on for this exact date (YYYY-MM-DD), ordered by position. Without it, the latest appearance on each chart.

totalChartsnumberrequired

positionsarray of objectrequired5 fields

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

positionnumberrequired