Podcast Reviews

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

Get the reviews for a podcast

Example request

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

console.log(data);

import os

from podengine import PodEngine

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

data = pe.podcasts.get_podcast_reviews(
    podcast_id_or_slug="this-week-in-startups",
)

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"
    },
    "podcastReviews": {
      "podcastId": "string",
      "appleId": 0,
      "spotifyId": "string",
      "applePodcastsReview": {
        "appleId": 0,
        "scrapedAt": "2026-01-15T09:30:00.000Z",
        "country": "string",
        "reviewsCount": 0,
        "rating": 0,
        "oneStarCount": 0,
        "twoStarCount": 0,
        "threeStarCount": 0,
        "fourStarCount": 0,
        "fiveStarCount": 0
      },
      "applePodcastsReviewsByCountry": [
        {
          "appleId": 0,
          "scrapedAt": "2026-01-15T09:30:00.000Z",
          "country": "string",
          "reviewsCount": 0,
          "rating": 0,
          "oneStarCount": 0,
          "twoStarCount": 0,
          "threeStarCount": 0,
          "fourStarCount": 0,
          "fiveStarCount": 0
        }
      ],
      "applePodcastsReviewText": {
        "country": "string",
        "total": 0,
        "limit": 0,
        "offset": 0,
        "reviews": [
          {
            "country": "string",
            "rating": 0,
            "title": "string",
            "body": "string",
            "author": "string",
            "reviewedAt": "2026-01-15T09:30:00.000Z"
          }
        ]
      },
      "spotifyReview": {
        "spotifyId": "string",
        "scrapedAt": "2026-01-15T09:30:00.000Z",
        "reviewsCount": 0,
        "rating": 0
      },
      "castbox": {
        "scrapedAt": "2026-01-15T09:30:00.000Z",
        "plays": 0,
        "subscribers": 0
      }
    }
  }
}

Request

Path parameters

podcastIdOrSlugstringrequired

Podengine ID, Apple ID, or slug

Query parameters

countryenum

Apple storefront to scope the aggregate ratings and review text to (us, gb, au, ca). Omit for all storefronts.

usgbauca

limitnumber1 – 100

Maximum number of review-text rows to return (default 25, max 100).

offsetnumbermin 0

Number of review-text rows to skip, for pagination (default 0).

minRatingnumber1 – 5

Only return review text rated at least this many stars (1-5).

maxRatingnumber1 – 5

Only return review text rated at most this many stars (1-5).

Response

200 application/json

statusliteral: OKrequired

dataobjectrequired2 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

podcastReviewsobjectrequired8 fields

podcastIdstringrequired

appleIdnumberrequired

spotifyIdstringrequirednullable

applePodcastsReviewobjectrequirednullable10 fields

appleIdnumberrequired

scrapedAtdaterequired

countrystringrequired

reviewsCountnumberrequired

ratingnumberrequirednullable

oneStarCountnumberrequired

twoStarCountnumberrequired

threeStarCountnumberrequired

fourStarCountnumberrequired

fiveStarCountnumberrequired

applePodcastsReviewsByCountryarray of objectrequired10 fields

appleIdnumberrequired

scrapedAtdaterequired

countrystringrequired

reviewsCountnumberrequired

ratingnumberrequirednullable

oneStarCountnumberrequired

twoStarCountnumberrequired

threeStarCountnumberrequired

fourStarCountnumberrequired

fiveStarCountnumberrequired

applePodcastsReviewTextobjectrequirednullable5 fields

countrystringrequirednullable

totalnumberrequired

limitnumberrequired

offsetnumberrequired

reviewsarray of objectrequired6 fields

countrystringrequired

ratingnumberrequired

titlestringrequired

bodystringrequired

authorstringrequired

reviewedAtdaterequired

spotifyReviewobjectrequirednullable4 fields

spotifyIdstringrequired

scrapedAtdaterequired

reviewsCountnumberrequired

ratingnumberrequirednullable

castboxobjectrequirednullable3 fields

scrapedAtdaterequired

playsnumberrequired

subscribersnumberrequired