Historical Chart

GET/

Get a historical 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/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/charts?category=top+podcasts&chartType=apple&country=us&date=Mon+Apr+28+2025+00%3A00%3A00+GMT%2B0000+%28Coordinated+Universal+Time%29", options)
10  .then(response => response.json())
11  .then(data => console.log(data))
12  .catch(error => console.error('Error:', error));

API Specification

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"

date
date

The date of the chart to get

200

Success Response

PropertyTypeDescription
status
literal: OK

data
object

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"

date
date

The date of the chart to get

chartnullable
object

chart
object

chartType
enum

category
string

country
string

chartDate
date

positions
array
of
object

position
number

podcastOnChart
object

podcastOnChartId
string

title
string

imageUrlnullable
string

podenginePodcastnullable
object

authornullable
string

genres
array
of
string

id
string

imageUrlnullable
string

language
string

lastEpisodePublishedAt
date

slug
string

title
string