Podcast Chart Position

GET/:podcastIdOrSlug/charts

Get the latest positions of a podcast in a chart

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/:podcastIdOrSlug/charts

Try It

1const options = {
2  method: "GET",
3  headers: {
4    "Content-Type": "application/json",
5    "Authorization": "YOUR_API_TOKEN"
6  }
7};
8
9fetch("https://api.podengine.ai/api/v1/podcasts/:podcastIdOrSlug/charts?country=us", options)
10  .then(response => response.json())
11  .then(data => console.log(data))
12  .catch(error => console.error('Error:', error));

API Specification

Path Parameters

PropertyTypeDescription
podcastIdOrSlug
string

Podengine ID, Apple ID, or slug

Query Parameters

PropertyTypeDescription
chartTypeoptional
enum

The type of chart to get

categoryoptional
string

The category of the chart for example "top podcasts"

countryoptional
string

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

limitoptional
number

The number of charts to return

200

Success Response

PropertyTypeDescription
status
literal: OK

data
object

podcast
object

authornullable
string

genres
array
of
string

id
string

imageUrlnullable
string

language
string

lastEpisodePublishedAt
date

slug
string

title
string

options
object

chartTypeoptional
enum

The type of chart to get

categoryoptional
string

The category of the chart for example "top podcasts"

countryoptional
string

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

limitoptional
number

The number of charts to return

totalCharts
number

positions
array
of
object

chartType
enum

category
string

country
string

chartDate
date

position
number