Get the latest positions of a podcast in a chart
This endpoint requires an API token. You can learn more about how to get an API token from the authentication page.
| Property | Type | Description |
|---|---|---|
podcastIdOrSlug | string | Podengine ID, Apple ID, or slug |
| Property | Type | Description |
|---|---|---|
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 |
| Property | Type | Description |
|---|---|---|
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 |