Podcast Chart Position

GET /podcasts/::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

Code Example

API Specification

Path Parameters

PropertyTypeDescription
podcastIdOrSlug
string

Podengine ID, Apple ID, or slug

Query Parameters

PropertyTypeDescription
chartTypeoptional
enum ⓘ

Allowed values

applespotify

The type of chart, one of apple, spotify

categoryoptional
string

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"

countryoptional
string

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

positionsLimitoptional
number ⓘ

Constraints:

>= 1<= 200

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

limitoptional
number

The number of charts to return

200

Success Response

PropertyTypeDescription
status
literal: OK

data
object

podcast
object

authornullable
string

authorityScorenullable
object

calculatedAt
date

authorityScore
number

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

qualityScore
number

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

youtubeScore
number

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

socialScore
number

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

engagementScore
number

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

genres
array
of
string

id
string

imageUrlnullable
string

language
string

lastEpisodePublishedAt
date

slug
string

title
string

titleLatest
string

options
object

chartTypeoptional
enum ⓘ

Allowed values

applespotify

The type of chart, one of apple, spotify

categoryoptional
string

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"

countryoptional
string

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

positionsLimitoptional
number ⓘ

Constraints:

>= 1<= 200

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

limitoptional
number

The number of charts to return

totalCharts
number

positions
array
of
object

chartDate
string ⓘ

Constraints:

regex

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

chartType
enum ⓘ

Allowed values

applespotify

The type of chart, one of apple, spotify

country
string

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

category
string

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"

position
number